Función de devolución de llamada DLGPROC (winuser.h)

Artículo
08/27/2023

Función de devolución de llamada definida por la aplicación que se usa con las familias CreateDialog y DialogBox de funciones. Procesa los mensajes enviados a un cuadro de diálogo modal o modeless. El tipo DLGPROC define un puntero a esta función de devolución de llamada. DialogProc es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

DLGPROC Dlgproc;

INT_PTR Dlgproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parámetros

unnamedParam1

Tipo: HWND

Identificador del cuadro de diálogo.

unnamedParam2

Tipo: UINT

Mensaje.

unnamedParam3

Tipo: WPARAM

Información adicional específica del mensaje.

unnamedParam4

Tipo: LPARAM

Información adicional específica del mensaje.

Tipo: INT_PTR

Normalmente, el procedimiento del cuadro de diálogo debe devolver TRUE si procesó el mensaje y FALSE si no lo hizo. Si el procedimiento del cuadro de diálogo devuelve FALSE, el administrador de diálogos realiza la operación de diálogo predeterminada en respuesta al mensaje.

Si el procedimiento del cuadro de diálogo procesa un mensaje que requiere un valor devuelto específico, el procedimiento del cuadro de diálogo debe establecer el valor devuelto deseado llamando a SetWindowLong(hwndDlg, DWL_MSGRESULT, lResult) inmediatamente antes de devolver TRUE. Tenga en cuenta que debe llamar a SetWindowLong inmediatamente antes de devolver TRUE; si lo hace anteriormente, puede provocar que un mensaje de cuadro de diálogo anidado sobrescriba el valor DWL_MSGRESULT .

Los mensajes siguientes son excepciones a las reglas generales indicadas anteriormente. Consulte la documentación del mensaje específico para obtener más información sobre la semántica del valor devuelto.

Valor devuelto

None

Observaciones

Solo debe usar el procedimiento del cuadro de diálogo si usa la clase de cuadro de diálogo para el cuadro de diálogo. Esta es la clase predeterminada y se usa cuando no se especifica ninguna clase explícita en la plantilla del cuadro de diálogo. Aunque el procedimiento del cuadro de diálogo es similar a un procedimiento de ventana, no debe llamar a la función DefWindowProc para procesar mensajes no deseados. El procedimiento de ventana del cuadro de diálogo procesa internamente los mensajes no deseados.

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 (incluir Windows.h)