macro PropSheet_RemovePage (prsht.h)
Remove uma página de uma folha de propriedades. Você pode usar essa macro ou enviar a mensagem PSM_REMOVEPAGE explicitamente.
Sintaxe
void PropSheet_RemovePage(
hDlg,
index,
hpage
);
Parâmetros
hDlg
Tipo: HWND
Identificador para a folha de propriedades.
index
Tipo: int
Índice baseado em zero da página a ser removida.
hpage
Tipo: HPROPSHEETPAGE
Manipule para a página a ser removida.
Retornar valor
Nenhum
Comentários
Um aplicativo pode especificar a página a ser removida atribuindo um valor a index ou hpage. Se os valores forem atribuídos ao índice e ao hpage, hpage terá precedência.
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 macro PropSheet_RemovePage em sua implementação de PropSheetPageProc ou ao manipular as notificações e as mensagens do Windows a seguir.
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.
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
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | prsht.h |
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de