GetDlgItemText

A GetDlgItemText função recupera o título ou texto associado a um Controlarar em uma caixa de diálogo.

 (UINT GetDlgItemText HWND  hDlg, / / identificador da caixa de diálogointnIDDlgItem, / / identificador do controleLPTSTRlpString, / / endereço do buffer para o textointnMaxCount / / máximo tamanho de seqüência de caracteres);
 

Parâmetros

hDlg

Identifica a caixa de diálogo que contém o Controlarar.

nIDDlgItem

Especifica o identificador do controle cujo título ou texto é a serem recuperados.

lpString

Ponteiro para o buffer para receber o título ou texto.

nMaxCount

Especifica o comprimento máximo, em caracteres, da seqüência de caracteres a serem copiados para a reserva apontada pelo lpString. Se o comprimento da Cadeia de caracteres excede o limite, a seqüência de caracteres é truncada.

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. Para informações de erro estendidas get, chamar GetLastError.

Observações

A GetDlgItemText função envia uma mensagem WM_GETTEXT para o controle.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de caixas de diálogo, funções de caixa de diálogo, GetDlgItemInt, SetDlgItemInt, SetDlgItemText, WM_GETTEXT

Index