Partager via


CMenu::GetMenuString

Copie l'étiquette de l'élément de menu spécifié dans la mémoire tampon spécifiée.

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

Paramètres

  • nIDItem
    Spécifie l'ID d'ensemble de l'élément de menu ou le décalage de l'élément de menu dans le menu, selon la valeur d' nFlags.

  • lpString
    Pointe vers une mémoire tampon qui est de recevoir l'étiquette.

  • rString
    Une référence à un objet d' CString qui consiste à accepter la chaîne copiée de menu.

  • nMaxCount
    Spécifie la longueur maximale (caractères) de l'étiquette à copier.Si l'étiquette est plus longue que le maximum spécifié dans nMaxCount, les caractères supplémentaires sont tronqués.

  • nFlags
    Spécifie la traduction du paramètre d' nIDItem .Il peut être l'une des valeurs suivantes :

    nFlags

    Interprétation de nIDItem

    MF_BYCOMMAND

    Spécifie que le paramètre permet l'ID de commande de l'élément de menu existant.Valeur par défaut si aucun MF_BYCOMMAND ni MF_BYPOSITION n'est défini.

    MF_BYPOSITION

    Spécifie que le paramètre permet la position de l'élément de menu existant.Le premier élément est à la position 0.

Valeur de retour

Spécifie le nombre réel de caractères copiés dans la mémoire tampon, sans la marque de fin null.

Notes

Le paramètre d' nMaxCount doit être un supérieur au nombre de caractères dans l'étiquette pour s'adapter à le caractère NULL qui termine une chaîne.

Exemple

Consultez l'exemple pour CMenu::InsertMenu.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

Classe de CMenu

Graphique de la hiérarchie

CMenu::GetMenuState

CMenu::ModifyMenu

GetMenuString