PropSheet_AddPage macro (prsht.h)

Adiciona uma nova página ao final de uma folha de propriedades existente. Você pode usar essa macro ou enviar a mensagem PSM_ADDPAGE explicitamente.

Sintaxe

BOOL PropSheet_AddPage(
   HWND           hDlg,
   HPROPSHEETPAGE hpage
);

Parâmetros

hDlg

Tipo: HWND

Manipule para a folha de propriedades.

hpage

Tipo: HPROPSHEETPAGE

Manipule para a página a ser adicionada. A página deve ter sido criada por uma chamada anterior para a função CreatePropertySheetPage.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

A nova página não deve ser maior do que a maior página atualmente na folha de propriedades porque a folha de propriedades não é redimensionada para se ajustar à nova página.

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_AddPage na implementação de propSheetPageProc ou ao manipular as seguintes notificações e mensagens do Microsoft Windows:

• 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 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.

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