GetDlgItemInt

9/9/2008

Essa função converte o texto de um controle especificado em uma caixa diálogo em um valor inteiro.

Syntax

UINT GetDlgItemInt( 
  HWND hDlg, 
  int nIDDlgItem, 
  BOOL* lpTranslated, 
  BOOL bSigned
); 

Parameters

• hDlg
  [no] Tratar a caixa de diálogo que contém o controle de seu interesse.

• nIDDlgItem
  [no] Diálogo item identificador que especifica o controle cujo texto está para ser convertido.

• lpTranslated
  [out] Ponteiro longo para um Boolean variável que recebe um sucesso função/valor falha (TRUE indica êxito, FALSE indica falha).

  Este parâmetro é opcional: Ela pode ser NULL. No que maiúsculas e minúsculas, a função retornará Não informações sobre o sucesso ou falha.

• bSigned
  [no] Boolean que especifica se a função deve examinar o texto de uma sinal de menos o começo e retornar um assinado valor inteiro se encontrar um. Especifica que isso deve ser feito, TRUE FALSE que não deveria.

Return Value

Se a função for bem-sucedido, a variável apontado pelo lpTranslated é definido como TRUE e o valor de retorno é o valor convertida de texto de controle.

Se a função falhar, a variável apontado pelo lpTranslated é definido como FALSE, e o valor de retorno é zero. Observe que, como zero é que um possível traduzidos valor, um valor de retorno de zero não sozinho indica falha.

Se lpTranslated é NULL, a função não retorna nenhuma informações sobre o sucesso ou falha.

Se a pasta bSigned parâmetro é especificar que o valor a ser recuperados é um assinado, TRUE valor inteiro, CAST o valor de retorno para um Int tipo. Para informações de erro estendidas get, chamar GetLastError.

Remarks

O GetDlgItemInt função recupera o texto do controle especificado enviando o controle uma mensagem WM_GETTEXT. A função converte o texto recuperado por Retirada qualquer adicional Espaços no início do texto e, em seguida, convertendo o decimal dígitos. A função pára convertendo quando ele atingir o final do texto ou encontra um caractere não-numérico.

Se a pasta bSigned parâmetro é TRUE, o GetDlgItemInt função verifica um sinal de menos (-) no início do texto e converte o texto em um assinado valor inteiro. Caso contrário, a função cria uma sem assinatura valor inteiro.

O GetDlgItemInt função retorna zero se o valor traduzido for maior do que INT_MAX (para assinado números) ou UINT_MAX (para sem assinatura números).

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

Requirements

Header	winuser.h
Library	Dlgmgr.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

GetDlgCtrlID
GetDlgItem
GetDlgItemText
SetDlgItemInt
Dialog Boxes Functions