GetMenuString

Funkcja GetMenuString kopiuje ciąg tekstowy element menu określonego określony bufor.

GetMenuString funkcji funkcja został zastąpiony. Użyj funkcji GetMenuItemInfo do pobrania tekstu elementu menu.

int GetMenuString ( HMENU  hMenu, / / dojście do menuUINTuIDItem, / / identyfikator elementu menuLPTSTRlpString, / / wskaźnik do buforu ciąguintnMaxCount, / / maksymalna długooć ciąguUINTuFlag / / menu flags);
 

Parametry

hMenu

Dojście do menu.

uIDItem

Określa element menu ma być zmieniona, określone przez parametr uFlag.

lpString

Wskaźnik do buforu, który ma otrzymać ciąg zakończony znakiem null.

Jeśli lpString ma wartość NULL, funkcja zwraca długość ciągu menu.

nMaxCount

Określa maksymalną długość, znaków, ciąg, który ma być skopiowany. Jeśli ciąg jest dłuższa niż maksimum określonego w parametrze nMaxCount , dodatkowe znaki zostaną obcięte.

Jeśli nMaxCount jest równy 0, funkcja zwraca długość ciągu menu.

uFlag

Określa, w jaki sposób interpretowane parametr uIDItem . Ten parametr należy wybrać jedną z następujących wartości:

Wartość	Znaczenie
MF_BYCOMMAND	Wskazuje, że ten uIDItem podaje identyfikator elementu menu. Jeżeli określono flagę MF_BYCOMMAND ani MF_BYPOSITION, Flaga MF_BYCOMMAND jest flagę domyślną.
MF_BYPOSITION	Wskazuje, że ten uIDItem daje od zera względne położenie elementu menu.

Zwraca wartości

Jeśli funkcja, wartość zwracany określa liczbę znaków, kopiowany z bufora, nie włączając kończącego znaku null.

Jeśli funkcja zawiedzie, wartość zwracany jest zero.

Uwagi

Parametr nMaxCount musi być jeden większy niż liczba znaków w ciągu tekstowym, aby pomieścić kończącego znaku null.

Jeśli nMaxCount jest równy 0, funkcja zwraca długość ciągu menu.

Zobacz też

Menu omówienie, Funkcje Menu, GetMenuItemID

Index