GetMenuString

A função GetMenuString copia a Cadeia de caracteres de texto do item de menu especificado no buffer especificado.

A GetMenuString função função foi substituída. Use a GetMenuItemInfo função para recuperar o texto de item de menu.

int GetMenuString ( HMENU  hMenu, / / identificador para o menuUINTuIDItem, / / menu item identificadorLPTSTRlpString, / / ponteiro para o buffer para a Cadeia de caracteresintnMaxCount, / / máximo comprimento da Cadeia de caracteresUINTuFlag / / menu de bandeiras);
 

Parâmetros

hMenu
Identificador para o menu.
uIDItem
Especifica o item de menu a ser alterado, conforme determinado pelo parâmetro uFlag.
lpString
Ponteiro para a reserva que deve receber a Cadeia de caracteres terminada por caractere nulo.

Se lpString é NULL, a função retorna o comprimento do seqüência de caracteres menu.

nMaxCount
Especifica o comprimento máximo, em caracteres, da seqüência de caracteres a serem copiados. Se a Cadeia de caracteres for maior que o máximo especificado no parâmetro nMaxCount , os caracteres extras são truncados.

Se nMaxCount for 0, a função retorna o comprimento do seqüência de caracteres menu.

uFlag
Especifica como o parâmetro de uIDItem é interpretado. Este parâmetro deve ser um dos seguintes valores:
Valor Significado
MF_BYCOMMAND Indica que uIDItem dá o identificador do item de menu. Se nem o MF_BYCOMMAND ou MF_BYPOSITION Sinalizar for especificado, o Sinalizar MF_BYCOMMAND é a bandeira de padrão.
MF_BYPOSITION Indica que uIDItem dá o relativo posição baseada em zero do item de menu.

Retornar valores

Se a função for bem-sucedido, o valor de retorno especifica o número de caracteres copiados para a reserva, não incluindo o caractere nulo final.

Se a função falhar, o valor de retorno é zero.

Observações

O parâmetro nMaxCount deve ser maior que o número de caracteres na cadeia de caracteres de texto para acomodar o caractere nulo final um.

Se nMaxCount for 0, a função retorna o comprimento do seqüência de caracteres menu.

Ver também

Visão geral de menus, funções de Menu, GetMenuItemID

Index