GetMenuString

Die GetMenuString Funktion kopiert die Textzeichenfolge des angegebenen Menüelements in den angegebenen Puffer.

Die Funktion GetMenuString wurde ersetzt. Verwenden Sie die GetMenuItemInfo -Funktion zum Abrufen des Elementtextes Menü.

Int GetMenuString) HMENU  hMenu, / / handle für das MenüUINTuIDItem, / / Menü item IDLPTSTRlpString, / / Zeiger auf den Puffer für die ZeichenfolgeintnMaxCount, / / maximale Länge der ZeichenfolgeUINTuFlag / / Menü Flaggen);
 

Parameter

hMenu

Behandeln, um das Menü.

uIDItem

Gibt das Menüelement geändert werden, wie durch den Parameter uFlag bestimmt.

lpString

Zeiger auf den Puffer, die die Null-terminierte Zeichenfolge empfangen.

Wenn LpString NULL ist, gibt die Funktion die Länge der Zeichenfolge im Menü.

nMaxCount

Gibt die maximale Länge in Zeichen der Zeichenfolge kopiert werden. Wenn die Zeichenfolge länger als die maximal in das nMaxCount -Parameter angegeben ist, werden die überzähligen Zeichen abgeschnitten.

Falls nMaxCount 0 ist, gibt die Funktion die Länge der Zeichenfolge im Menü.

uFlag

Gibt an, wie der uIDItem -Parameter interpretiert wird. Dieser Parameter muss einer der folgenden Werte sein.:

Wert	Bedeutung
MF_BYCOMMAND	Gibt an, dass die uIDItem die ID des Menüelements gibt. Wenn weder der MF_BYCOMMAND noch das MF_BYPOSITION-Flag angegeben ist, ist das MF_BYCOMMAND-Flag Das Standardkennzeichen.
MF_BYPOSITION	Gibt an, dass die uIDItem die nullbasierte relative Position des Menüelements gibt.

Rückgabewerte

Wenn die Funktion erfolgreich ist, gibt der Rückgabewert die Anzahl der Zeichen in den Puffer, nicht einschließlich des abschließenden Nullzeichens kopiert.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null).

Bemerkungen

Der nMaxCount -Parameter muss größer als die Anzahl der Zeichen in der Textzeichenfolge um Platz für das abschließende Null-Zeichen sein.

Falls nMaxCount 0 ist, gibt die Funktion die Länge der Zeichenfolge im Menü.

Siehe auch

Übersicht über die Menüs, Menüfunktionen, GetMenuItemID

Index