Compartir a través de


CMenu::GetMenuString

Copia la etiqueta de elemento de menú especificado en el búfer especificado.

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

Parámetros

  • nIDItem
    Especifica el identificador entero del elemento de menú o el desplazamiento del elemento en el menú, dependiendo del valor de nFlags.

  • lpString
    Puntos en el búfer que es recibir la etiqueta.

  • rString
    Una referencia a un objeto de CString que es recibir la cadena copiada en el menú.

  • nMaxCount
    Especifica la longitud máxima (en caracteres) de la etiqueta que se va a copiar. Si la etiqueta es mayor que el máximo especificado en nMaxCount, se truncan los caracteres adicionales.

  • nFlags
    Especifica la interpretación del parámetro de nIDItem . Puede ser uno de los siguientes valores:

    nFlags

    Interpretación de nIDItem

    MF_BYCOMMAND

    Especifica que el parámetro proporciona el identificador del elemento de menú existente. Éste es el valor predeterminado si no se establece MF_BYCOMMAND ni MF_BYPOSITION .

    MF_BYPOSITION

    Especifica que el parámetro proporciona la posición del elemento de menú existente. el primer elemento está en la posición 0.

Valor devuelto

Especifica el número de caracteres real copiado en el búfer, sin incluir el terminador nulo.

Comentarios

El parámetro de nMaxCount debe ser una mayor que el número de caracteres de la etiqueta para alojar el carácter null de terminación una cadena.

Ejemplo

Vea el ejemplo para CMenu:: InsertMenu.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

CMenu Class

Gráfico de jerarquías

CMenu::GetMenuState

CMenu::ModifyMenu

GetMenuString