PSM_REMOVEPAGE mensagem

Remove uma página de uma folha de propriedades. Você pode enviar essa mensagem explicitamente ou usando a macro PropSheet_RemovePage .

Parâmetros

wParam

Índice baseado em zero da página a ser removida.

lParam

O identificador HPROPSHEETPAGE da página a ser removida.

Valor retornado

Sem valor de retorno.

Comentários

Um aplicativo pode especificar o índice ou o identificador ou ambos. Se ambos forem especificados, lParam terá precedência.

Enviar PSM_REMOVEPAGE destrói a página da folha de propriedades que está sendo removida.

Várias mensagens e uma chamada de função ocorrem enquanto a folha de propriedades está manipulando a lista de páginas. Enquanto essa ação estiver ocorrendo, a tentativa de modificar a lista de páginas terá resultados imprevisíveis. Assim, você não deve usar a mensagem PSM_REMOVEPAGE em sua implementação de PropSheetPageProc ou ao manipular as notificações e as mensagens do Windows a seguir.

• PSN_APPLY
• PSN_KILLACTIVE
• PSN_RESET
• PSN_SETACTIVE
• WM_DESTROY
• WM_INITDIALOG

Se você precisar modificar uma página de folha de propriedades enquanto estiver manipulando uma dessas mensagens ou enquanto PropSheetPageProc estiver em operação, poste uma mensagem privada do Windows. Seu aplicativo não receberá essa mensagem até que o gerenciador de folhas de propriedades tenha concluído suas tarefas. Em seguida, você pode modificar a lista de páginas.

As notificações a seguir também são afetadas pela modificação da folha de propriedades.

• PSN_WIZBACK
• PSN_WIZNEXT

Você pode adicionar ou remover páginas em resposta a essas notificações, desde que retorne (via DWL_MSGRESULT) um valor diferente de zero para especificar a nova página desejada. No entanto, observe que, se você remover uma página localizada antes da página atual (que tem um índice menor que a página atual), PSN_KILLACTIVE poderá ser enviada para a página errada.

Requisitos