Compartir a través de


mensaje de PSM_SETWIZBUTTONS

Habilita o deshabilita los botones Atrás, Siguiente y Finalizar en un asistente. También puede usar la macro PropSheet_SetWizButtons para publicar el mensaje.

Parámetros

wParam

Establezca este parámetro en PSWIZBF_ELEVATIONREQUIRED para mostrar el icono con privilegios elevados en los botones especificados en lParam. El icono con privilegios elevados (o el icono de escudo UAC) indica que la solicitud de elevación se usará para solicitar al usuario la aprobación o las credenciales. Para obtener más información, vea Diseño de aplicaciones UAC para Windows Vista.

Nota

La visualización del icono de escudo UAC solo se admite en AeroWizards (PSH_AEROWIZARD).

lParam

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

Value Significado
PSWIZB_BACK
Habilita 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
Habilita el botón Siguiente. Si no se establece esta marca, el botón Siguiente se muestra como deshabilitado.

Valor devuelto

No de devuelve ningún valor.

Comentarios

Si el controlador de notificaciones usa PostMessage para enviar un mensaje de PSM_SETWIZBUTTONS , no haga nada que afecte al foco de la ventana hasta que se devuelva el controlador. Por ejemplo, si llama a MessageBox inmediatamente después de usar PostMessage para enviar PSM_SETWIZBUTTONS, el cuadro de mensaje recibirá el foco. Puesto que los mensajes publicados 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.

Si envía el mensaje de PSM_SETWIZBUTTONS durante el control de la notificación de PSN_SETACTIVE , use la función PostMessage en lugar de la función SendMessage . De lo contrario, el sistema no actualizará los botones correctamente. Si usa la macro PropSheet_SetWizButtons para enviar este mensaje, se publicará. En cualquier otro momento, puede usar SendMessage para enviar PSM_SETWIZBUTTONS.

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, al 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 la marca PSH_WIZARDHASFINISH 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]
Encabezado
Prsht.h