Condividi tramite


CMenu::GetMenuString

Copiare l'etichetta della voce di menu specificata nel buffer specificato.

int GetMenuString( 
   UINT nIDItem, 
   LPTSTR lpString, 
   int nMaxCount, 
   UINT nFlags  
) const; 
int GetMenuString( 
   UINT nIDItem, 
   CString& rString, 
   UINT nFlags  
) const;

Parametri

  • nIDItem
    Specifica l'identificatore Integer della voce di menu o dell'offset della voce del menu, a seconda del valore nFlags.

  • lpString
    Punti al buffer che prevede di ricevere l'etichetta.

  • rString
    Un riferimento a un oggetto CString che prevede di ricevere la stringa nel menu.

  • nMaxCount
    Specifica la lunghezza massima (i caratteri) dell'etichetta da copiare. Se l'etichetta maggiore rispetto al massimo specificato in nMaxCount, caratteri aggiuntivi vengono troncati.

  • nFlags
    Specifica l'interpretazione del parametro nIDItem. Può essere uno dei seguenti valori:

    nFlags

    Interpretazione di nIDItem

    MF_BYCOMMAND

    Specifica che il parametro fornisce l'id di comando voce di menu esistente. Questa è l'impostazione predefinita se non MF_BYCOMMANDMF_BYPOSITION è impostato su.

    MF_BYPOSITION

    Specifica che il parametro fornisce la posizione della voce di menu esistente. Il primo elemento è la posizione 0.

Valore restituito

Specifica il numero di caratteri copiato nel buffer, escluso il terminatore null.

Note

Il parametro nMaxCount deve essere una maggiore del numero di caratteri nell'etichetta per inserire il carattere null che termina una stringa.

Esempio

Vedere l'esempio relativo CMenu::InsertMenu.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CMenu

Grafico delle gerarchie

CMenu::GetMenuState

CMenu::ModifyMenu

GetMenuString