Função SetDlgItemInt (winuser.h)

Artigo
08/28/2023

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)