Compartilhar via

PropSheet_InsertPage macro (prsht.h)

  • Artigo

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

BOOL PropSheet_InsertPage(
   HWND hDlg,
   HWND index,
   HWND hpage
);

Parâmetros

hDlg

Tipo: HWND

Manipule para a folha de propriedades.

index

Tipo: HWND

Onde a página deve ser inserida. Defina de índice para 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.

Valor Significado
de índice
 Se índice for menor que MAXUSHORT (o maior inteiro curto sem sinal), ele especifica o índice baseado em zero para a nova página. Por exemplo, para tornar a página inserida a terceira página na folha de propriedades, defina índice como 2. Para torná-la a primeira página, defina índice como 0. Se índice tiver um valor maior que o número de páginas e menor que MAXUSHORT, a página será acrescentada.
hpageInsertAfter
 Se você definir índice para o identificador HPROPSHEETPAGE de uma página existente, a nova página será inserida depois dela.

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.

Valor de retorno

Tipo: BOOL

Retorna um valor diferente de zero se a página foi inserida com êxito ou zero de outra forma.

Observações

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 se ajustar à 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 estiver ocorrendo, a tentativa de modificar a lista de páginas terá resultados imprevisíveis. Assim, você não deve usar a macro PropSheet_InsertPage na implementação de propSheetPageProc ou ao manipular as notificações a seguir e as 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 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ê inserir uma página que está 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.
Observação Não há suporte para essa macro ao usar o estilo do assistente do Aero (PSH_AEROWIZARD).
 

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho prsht.h