Compartir a través de

Función de devolución de llamada PFTASKDIALOGCALLBACK (commctrl.h)

  • Artículo

La función TaskDialogCallbackProc es una función definida por la aplicación que se usa con la función TaskDialogIndirect . Recibe mensajes del cuadro de diálogo de tareas cuando se producen varios eventos.

El tipo PFTASKDIALOGCALLBACK define un puntero a esta función de devolución de llamada. TaskDialogCallbackProc es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

PFTASKDIALOGCALLBACK Pftaskdialogcallback;

HRESULT Pftaskdialogcallback(
  [in] HWND hwnd,
  [in] UINT msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
       LONG_PTR lpRefData
)
{...}

Parámetros

[in] hwnd

Tipo: HWND

Identificador de la ventana TaskDialog. No continúe enviando mensajes a hwnd después de que el procedimiento de devolución de llamada vuelva de haberse llamado con TDN_DESTROYED.

[in] msg

Tipo: UINT

Una de las siguientes notificaciones.

Notificación Uso
TDN_BUTTON_CLICKED Indica que se ha seleccionado un botón. WParam especifica el identificador de comando del botón.
TDN_CREATED Indica que se ha creado el cuadro de diálogo de tareas.
TDN_DESTROYED Indica que se ha destruido el cuadro de diálogo de tareas.
TDN_DIALOG_CONSTRUCTED Indica que se ha creado el cuadro de diálogo de tareas, pero aún no se ha mostrado.
TDN_EXPANDO_BUTTON_CLICKED Indica que se ha seleccionado el botón expando.
TDN_HELP Indica que se ha presionado la tecla F1 mientras el cuadro de diálogo de tareas tiene el foco.
TDN_HYPERLINK_CLICKED Indica que se ha seleccionado un hipervínculo. LParam especifica un puntero al texto del vínculo.
TDN_NAVIGATED Indica que se ha producido la navegación.
TDN_RADIO_BUTTON_CLICKED Indica que se ha seleccionado un botón de radio. WParam especifica el identificador de comando del botón de radio.
TDN_TIMER Indica que se ha desencadenado el temporizador del cuadro de diálogo de tareas. WParam especifica el tiempo total transcurrido. Puede actualizar la barra de progreso enviando un mensaje de TDM_SET_PROGRESS_BAR_POS a la ventana especificada por el parámetro hwnd .
TDN_VERIFICATION_CLICKED Indica que se ha seleccionado la casilla Verificación del cuadro de diálogo de tareas.

[in] wParam

Tipo: WPARAM

Especifica información adicional de notificación. El contenido de este parámetro depende del valor del parámetro uNotification .

[in] lParam

Tipo: LPARAM

Especifica información adicional de notificación. El contenido de este parámetro depende del valor del parámetro uNotification .

lpRefData

Tipo: LONG_PTR

Puntero a datos específicos de la aplicación. Estos son los datos a los que apunta el miembro lpCallbackData de la estructura TASKDIALOGCONFIG que se usa para crear el cuadro de diálogo de tarea.

Valor devuelto

Tipo: HRESULT

El valor devuelto es específico de la notificación que se está procesando. Al responder a un clic de botón, la implementación debe devolver S_FALSE si el cuadro de diálogo de tareas no se va a cerrar. De lo contrario, devuelve S_OK.

Comentarios

Una aplicación debe registrar esta función de devolución de llamada pasando su dirección en el miembro pfCallback de la estructura TASKDIALOGCONFIG que se pasa a través del puntero a través de TaskDialogIndirect.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado commctrl.h (incluya Commctrl.h)