Compartilhar via


CWnd::GetDlgItemInt

Recupera o texto do controle identificado por nID.

UINT GetDlgItemInt( 
   int nID, 
   BOOL* lpTrans = NULL, 
   BOOL bSigned = TRUE  
) const;

Parâmetros

  • nID
    Especifica o identificador inteiro de controle da caixa de diálogo a ser convertido.

  • lpTrans
    Pontos à variável booleano que deve receber o sinalizador traduzido.

  • bSigned
    Especifica se o valor ser recuperado está assinado.

Valor de retorno

Especifica o valor convertido texto do item da caixa de diálogo. Desde que 0 é um valor de retorno válido, lpTrans deve ser usado para detectar erros. Se um valor de retorno é assinado desejado, conversão ele como um tipo de int .

A função retorna 0 se o número é convertido maior do que INT_MAX (para números assinados) ou (UINT_MAX para não assinados).

Quando erros ocorrem, como o encontro de caracteres não numéricos e exceder o máximo anterior, GetDlgItemInt copia 0 para o local apontado por lpTrans. Se não houver nenhum erro, lpTrans recebe um valor diferente de zero. Se lpTrans é NULO, GetDlgItemInt não avisará sobre erros.

Comentários

Converte o texto do controle especificado na caixa de diálogo fornecida em um valor inteiro descascando todos os espaços extras no início do texto e convertendo dígitos decimais. Para a tradução quando atingir o final do texto ou encontra qualquer caractere não numéricos.

Se bSigned é Verdadeiro, GetDlgItemInt verifica um sinal de subtração (–) no início do texto e converte o texto em um número assinado. Caso contrário, ele cria um valor sem sinal.

Envia uma mensagem de WM_GETTEXT ao controle.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

CWnd::GetDlgItemText

GetDlgItemInt