Función DispatchMessage (winuser.h)
Envía un mensaje a un procedimiento de ventana. Normalmente se usa para enviar un mensaje recuperado por la función GetMessage .
Sintaxis
LRESULT DispatchMessage(
[in] const MSG *lpMsg
);
Parámetros
[in] lpMsg
Tipo: const MSG*
Puntero a una estructura que contiene el mensaje.
Valor devuelto
Tipo: LRESULT
El valor devuelto especifica el valor devuelto por el procedimiento de ventana. Aunque su significado depende del mensaje que se envía, generalmente se omite el valor devuelto.
Comentarios
La estructura MSG debe contener valores de mensaje válidos. Si el parámetro lpmsg apunta a un mensaje WM_TIMER y el parámetro lParam del mensaje WM_TIMER no es NULL, lParam apunta a una función a la que se llama en lugar del procedimiento de ventana.
Tenga en cuenta que la aplicación es responsable de recuperar y enviar mensajes de entrada al cuadro de diálogo. La mayoría de las aplicaciones usan el bucle de mensajes principal para esto. Sin embargo, para permitir que el usuario pase a y seleccione controles mediante el teclado, la aplicación debe llamar a IsDialogMessage. Para obtener más información, vea Interfaz de teclado del cuadro de diálogo.
Ejemplos
Para obtener un ejemplo, consulte Creación de un bucle de mensajes.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluya Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-message-l1-1-0 (introducido en Windows 8) |
Consulte también
Conceptual
Referencia