Função SendDlgItemMessageA (winuser.h)

  • Artigo

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

Digite: 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 Mensagens definidas pelo sistema.

[in] wParam

Tipo: WPARAM

Obter informações adicionais específicas de mensagem.

[in] lParam

Tipo: LPARAM

Obter informações adicionais específicas de mensagem.

Retornar valor

Tipo: LRESULT

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

Comentários

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

O uso de SendDlgItemMessage é idêntico à recuperação de um identificador para o controle especificado e à chamada da função SendMessage .

Exemplos

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

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
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-0 (introduzido no Windows 8)

Confira também

Conceitual

Caixas de diálogo

Referência

SendMessage