macro PropSheet_InsertPage (prsht.h)
Insere uma nova página em uma folha de propriedades existente. A página pode ser inserida em um índice especificado ou após uma página especificada. Você pode usar essa macro ou enviar a mensagem PSM_INSERTPAGE explicitamente.
Sintaxe
void PropSheet_InsertPage(
hDlg,
index,
hpage
);
Parâmetros
hDlg
Tipo: HWND
Manipule para a folha de propriedades.
index
Tipo: HWND
Onde a página deve ser inserida. Defina wParam como NULL para tornar a nova página a primeira página. Para especificar onde a nova página deve ser inserida, você pode passar um índice ou um identificador HPROPSHEETPAGE de uma página existente.
hpage
Tipo: HWND
Manipule para a página a ser inserida. A página deve primeiro ser criada por uma chamada para a função CreatePropertySheetPage .
Retornar valor
Nenhum
Comentários
As páginas após o ponto de inserção são deslocadas para a direita para acomodar a nova página.
A folha de propriedades não é redimensionada para caber na nova página. Não torne a nova página maior do que a maior página da folha de propriedades.
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 está ocorrendo, tentar modificar a lista de páginas terá resultados imprevisíveis. Dessa forma, você não deve usar a macro PropSheet_InsertPage na implementação do PropSheetPageProc ou ao manipular as seguintes notificações e mensagens do Windows.
Se você precisar modificar uma página de folha de propriedades enquanto estiver tratando 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 termine 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ê inserir uma página localizada antes da página atual (que tenha um índice menor que a página atual), PSN_KILLACTIVE poderá ser enviado 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