CMenu::GetMenuString

Artigo
08/25/2010

Copia o rótulo do item de menu especificado para o buffer 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 o identificador inteiro do item de menu ou o deslocamento do item de menu no menu, dependendo do valor de nFlags.
lpString
Aponta para o buffer que receberá o rótulo.
rString
Uma referência a um CString objeto que deve receber a seqüência de caracteres copiados menu.
nMaxCount
Especifica o comprimento máximo (em caracteres) do rótulo a ser copiado.Se o rótulo for maior do que o máximo especificado em nMaxCount, os caracteres extras serão truncados.

nFlags
Especifica a interpretação do nIDItem parâmetro. Ele pode ser um dos seguintes valores:

nFlags	Interpretação dos nIDItem
MF_BYCOMMAND	Especifica que o parâmetro fornece a ID de comando do item de menu existente.Este é o padrão se nenhuma das MF_BYCOMMAND nor MF_BYPOSITION é definida.
MF_BYPOSITION	Especifica que o parâmetro oferece a posição do item de menu existente.O primeiro item é na posição 0.

Valor de retorno

Especifica o número real de caracteres copiados para o buffer, não incluindo o terminador nulo.

Comentários

The nMaxCount parâmetro deve ser maior do que o número de caracteres no rótulo para acomodar o caractere nulo que encerra uma seqüência de caracteres de uma.