GetDlgItemInt

A função GetDlgItemInt converte o texto de um Controlarar especificado em uma caixa de diálogo em um valor inteiro.

(UINT GetDlgItemInt HWND  hDlg, / / manipular a caixa de diálogointnIDDlgItem, / / Controlar identificadorBOOL* lpTranslated,  / / aponta para variável para receber o sucesso/falha / / indicadorBOOLbSigned / / especifica se o valor é assinado ou não assinado);
 

Parâmetros

hDlg
Identificador para a caixa de diálogo que contém o Controlarar de interesse.
nIDDlgItem
Identificador de item de caixa de diálogo que especifica o Controlarar cujo texto está a ser traduzido.
lpTranslated
Ponteiro para uma Boolean variável que recebe um valor de sucesso/falha função. TRUE indica êxito, FALSE indica falha.

Este parâmetro é opcional: pode ser NULL. Nesse caso, a função não retorna nenhuma informação sobre o sucesso ou fracasso.

bSigned
Especifica se a função deve examinar o texto para um sinal de subtração no início e retornar um valor inteiro assinado se encontrar um. TRUE Especifica que isso deve ser feito, falso que não deve.

Retornar valores

Se a função tiver êxito, a variável apontada pelo lpTranslated é definida como TRUE e o valor de retorno é o valor convertido do texto controle.

Se a função falhar, a variável apontada pelo lpTranslated é definida como FALSE, e o valor de retorno é zero. Observe que, uma vez que zero é um valor traduzido possível, um valor de retorno de zero não por si só indica falha.

Se lpTranslated for NULL, a função não retorna nenhuma informação sobre o sucesso ou fracasso.

Se o parâmetro bSigned for TRUE, especificando que o valor a ser recuperado é um valor inteiro assinado, converter o valor de retorno para um tipo de int . Para informações de erro estendidas get, chamar GetLastError.

Observações

A função GetDlgItemInt recupera o texto do Controlarar fornecido enviando o controle uma mensagem WM_GETTEXT. A função converte o texto recuperado por remoção de quaisquer espaços extras no início do texto e, em seguida, convertendo os dígitos decimais. A função pára de tradução quando ele atinge o final do texto ou encontra um caractere não numérico.

Se o parâmetro bSigned for TRUE, as verificações de função GetDlgItemInt para um sinal de menos (-) no início do texto e converte o texto em um valor inteiro assinado. Caso contrário, a função cria um valor inteiro não assinado.

A função GetDlgItemInt retorna zero se o valor traduzido for maior que INT_MAX (para números assinados) ou UINT_MAX (para números não assinados).

Windows CE: Seqüências de caracteres de texto com mais de 48 caracteres não podem ser traduzidas.

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.

Ver também

Visão geral de caixas de diálogo, funções de caixa de diálogo, GetDlgCtrlID, GetDlgItem, GetDlgItemText, SetDlgItemInt

Index