Compartir a través de

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 el mensaje PSM_SETWIZBUTTONS explícitamente.

Sintaxis

VOID PropSheet_SetWizButtons(
   HWND  hDlg,
   DWORD dwFlags
);

Parámetros

hDlg

Tipo: HWND

Identificador de la hoja de propiedades.

dwFlags

Tipo: DWORD de

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

Tipo: VOID de

No hay ningún valor devuelto.

Observaciones

Esta macro usa PostMessage para enviar el mensaje de 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 cuadro de mensajes inmediatamente después de llamar a PropSheet_SetWizButtons, el cuadro de mensaje recibirá el foco. Dado que los mensajes enviados con postMessage no se entregan hasta que lleguen al encabezado de la cola de mensajes, el mensaje de PSM_SETWIZBUTTONS no se entregará hasta después de que el asistente haya perdido el foco en el cuadro de mensaje. Como resultado, la hoja de propiedades no podrá establecer correctamente el foco para 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. Los asistentes suelen mostrar 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 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 FLAG en el dwFlags miembro del PROPSHEETHEAD ER del asistente al crear el asistente. Cada página mostrará los cuatro botones.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de prsht.h