Compartilhar via


Função SetDlgItemInt (winuser.h)

Define o texto de um controle em uma caixa de diálogo para a representação de cadeia de caracteres de um valor inteiro especificado.

Sintaxe

BOOL SetDlgItemInt(
  [in] HWND hDlg,
  [in] int  nIDDlgItem,
  [in] UINT uValue,
  [in] BOOL bSigned
);

Parâmetros

[in] hDlg

Digite: HWND

Um identificador para a caixa de diálogo que contém o controle .

[in] nIDDlgItem

Tipo: int

O controle a ser alterado.

[in] uValue

Tipo: UINT

O valor inteiro usado para gerar o texto do item.

[in] bSigned

Tipo: BOOL

Indica se o parâmetro uValue está assinado ou não assinado. Se esse parâmetro for TRUE, uValue será assinado. Se esse parâmetro for TRUE e uValue for menor que zero, um sinal de subtração será colocado antes do primeiro dígito na cadeia de caracteres. Se esse parâmetro for FALSE, uValue não será assinado.

Valor retornado

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para definir o novo texto, essa função envia uma mensagem WM_SETTEXT para o controle especificado.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-dialogbox-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)

Confira também

Conceitual

Caixas de diálogo

GetDlgItemInt

Referência

Setdlgitemtext

WM_SETTEXT