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