macro PropSheet_SetWizButtons (prsht.h)

  • Artículo

Habilita o deshabilita los botones Atrás, Siguiente y Finalizar en un asistente publicando un mensaje de PSM_SETWIZBUTTONS . Puede usar esta macro o enviar explícitamente el mensaje de PSM_SETWIZBUTTONS .

Sintaxis

void PropSheet_SetWizButtons(
   hDlg,
   dwFlags
);

Parámetros

hDlg

Tipo: HWND

Identificador de la hoja de propiedades.

dwFlags

Tipo: DWORD

Valor que especifica qué botones del asistente están habilitados. Puede combinar una o varias de las marcas siguientes.

Valor Significado
PSWIZB_BACK
 Habilite el botón Atrás. Si no se establece esta marca, el botón Atrás se muestra como deshabilitado.
PSWIZB_DISABLEDFINISH
 Muestra un botón Finalizar deshabilitado.
PSWIZB_FINISH
 Muestra un botón Finalizar habilitado.
PSWIZB_NEXT
 Habilite el botón Siguiente. Si no se establece esta marca, el botón Siguiente se muestra como deshabilitado.

Valor devuelto

None

Observaciones

Esta macro usa PostMessage para enviar el mensaje PSM_SETWIZBUTTONS . Si el controlador de notificaciones llama a PropSheet_SetWizButtons, no haga nada que afecte al foco de la ventana hasta que el controlador vuelva. Por ejemplo, si llama a MessageBox inmediatamente después de llamar a PropSheet_SetWizButtons, el cuadro de mensaje recibirá el foco. Puesto que los mensajes enviados con PostMessage no se entregan hasta que llegan al encabezado de la cola de mensajes, el mensaje de PSM_SETWIZBUTTONS no se entregará hasta que el asistente haya perdido el foco en el cuadro de mensaje. Como resultado, la hoja de propiedades no podrá establecer correctamente el foco de los botones.

Los asistentes muestran tres o cuatro botones debajo de cada página. Este mensaje se usa para especificar qué botones están habilitados. Normalmente, los asistentes muestran Atrás, Cancelar y un botón Siguiente o Finalizar. Normalmente, solo se habilita el botón Siguiente para la página principal, Siguiente y Atrás para las páginas interiores, y Atrás y Finalizar para la página de finalización. El botón Cancelar siempre está habilitado. Normalmente, establecer PSWIZB_FINISH o PSWIZB_DISABLEDFINISH reemplaza el botón Siguiente por un botón Finalizar. Para mostrar los botones Siguiente y Finalizar simultáneamente, establezca el PSH_WIZARDHASFINISH MARCA en el miembro dwFlags de la estructura PROPSHEETHEADER del asistente al crear el asistente. Cada página mostrará los cuatro botones.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado prsht.h