Função SendDlgItemMessageA (winuser.h)

Artigo
11/20/2024

Envia uma mensagem para o controle especificado em uma caixa de diálogo.

Sintaxe

LRESULT SendDlgItemMessageA(
  [in] HWND   hDlg,
  [in] int    nIDDlgItem,
  [in] UINT   Msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Parâmetros

[in] hDlg

Tipo: HWND

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

[in] nIDDlgItem

Tipo: int

O identificador do controle que recebe a mensagem.

[in] Msg

Tipo: UINT

A mensagem a ser enviada.

Para obter listas das mensagens fornecidas pelo sistema, consulte System-Defined Mensagens.

[in] wParam

Tipo: WPARAM

Informações adicionais específicas da mensagem.

[in] lParam

Tipo: LPARAM

Informações adicionais específicas da mensagem.

Valor de retorno

Tipo: LRESULT

O valor retornado especifica o resultado do processamento da mensagem e depende da mensagem enviada.

Observações

A função SendDlgItemMessage não retorna até que a mensagem seja processada.

Usar SendDlgItemMessage é idêntico à recuperação de um identificador para o controle especificado e chamar a função sendMessage .

Exemplos

Para obter um exemplo, consulte Criando uma caixa de diálogo Modeless.

Nota

O cabeçalho winuser.h define SendDlgItemMessage como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll
conjunto de API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introduzido no Windows 8)

Consulte também

Conceitual

Caixas de diálogo

de referência de

SendMessage

Compartilhar via