PropSheet_RemovePage macro (prsht.h)
Quita una página de una hoja de propiedades. Puede usar esta macro o enviar explícitamente el mensaje PSM_REMOVEPAGE .
Sintaxis
void PropSheet_RemovePage(
hDlg,
index,
hpage
);
Parámetros
hDlg
Tipo: HWND
Identificador de la hoja de propiedades.
index
Tipo: int
Índice de base cero de la página que se va a quitar.
hpage
Tipo: HPROPSHEETPAGE
Identificador de la página que se va a quitar.
Valor devuelto
None
Observaciones
Una aplicación puede especificar la página que se va a quitar asignando un valor a index o hpage. Si los valores se asignan a index y hpage, hpage tiene prioridad.
Se producen varios mensajes y una llamada de función mientras la hoja de propiedades manipula la lista de páginas. Mientras se realiza esta acción, intentar modificar la lista de páginas tendrá resultados impredecibles. Por lo tanto, no debe usar la macro PropSheet_RemovePage en la implementación de PropSheetPageProc o mientras controla las siguientes notificaciones y mensajes de Windows.
Si necesita modificar una página de hoja de propiedades mientras controla uno de estos mensajes o mientras PropSheetPageProc está en funcionamiento, publique un mensaje privado de Windows. La aplicación no recibirá ese mensaje hasta después de que el administrador de hojas de propiedades haya terminado sus tareas. A continuación, puede modificar la lista de páginas.Las siguientes notificaciones también se ven afectadas por la modificación de la hoja de propiedades.
Puede agregar o quitar páginas en respuesta a estas notificaciones, siempre que devuelva (a través de DWL_MSGRESULT) un valor distinto de cero para especificar la nueva página deseada. Sin embargo, tenga en cuenta que si quita una página que se encuentra antes de la página actual (que tiene un índice menor que la página actual), es posible que PSN_KILLACTIVE se envíen a la página incorrecta.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 |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de