GetMenuString

La funzione GetMenuString copia la stringa di testo della voce di menu specificata nel buffer specificato.

La funzione GetMenuString funzione è stata sostituita. Utilizzare la funzione GetMenuItemInfo per recuperare il testo dell'elemento dal menu.

int (GetMenuString HMENU  hMenu, / / handle al menuUINTuIDItem, / / identificatore voce del menuLPTSTRlpString, / / puntatore al buffer per la stringaintnMaxCount, / / massima lunghezza della stringaUINTuFlag / / dal menu flags);
 

Parametri

hMenu

Gestire al menu.

uIDItem

Consente di specificare la voce di menu per essere cambiato, come determinato dal parametro uFlag.

lpString

Puntatore al buffer che riceverà la stringa null-terminated.

Se lpString è NULL, la funzione restituisce la lunghezza della stringa dal menu.

nMaxCount

Specifica la lunghezza massima, in caratteri della stringa da copiare. Se la stringa è più lunga di massimo specificato nel parametro nMaxCount , caratteri aggiuntivi vengono troncati.

Se nMaxCount è 0, la funzione restituisce la lunghezza della stringa dal menu.

uFlag

Specifica come viene interpretato il parametro uIDItem . Questo parametro deve essere uno dei seguenti valori:

Valore	Significato
MF_BYCOMMAND	Indica che uIDItem dà l'identificatore della voce di menu. Se viene specificato il flag MF_BYCOMMAND né MF_BYPOSITION, la bandiera MF_BYCOMMAND è il flag predefinito.
MF_BYPOSITION	Indica che uIDItem dà la posizione relativa in base zero della voce di menu.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito specifica il numero di caratteri copiati nel buffer, non compreso il carattere di terminazione null.

Se la funzione non riesce, il valore restituito è pari a zero.

Osservazioni

Il parametro nMaxCount deve essere maggiore del numero di caratteri nella stringa di testo per accogliere il carattere di terminazione null.

Se nMaxCount è 0, la funzione restituisce la lunghezza della stringa dal menu.

Vedi anche

Panoramica di menu, Menu funzioni, GetMenuItemID

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index