Função SendDlgItemMessageA (winuser.h)
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
Referência