Método IShellPropSheetExt::AddPages (shobjidl_core.h)

Adiciona uma ou mais páginas a uma folha de propriedades que o Shell exibe para um objeto de arquivo. O Shell chama esse método para cada manipulador de folha de propriedades registrado para o tipo de arquivo.

Sintaxe

HRESULT AddPages(
  [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
  [in] LPARAM                 lParam
);

Parâmetros

[in] pfnAddPage

Tipo: LPFNADDPROPSHEETPAGE

Um ponteiro para uma função que o manipulador de folha de propriedades chama para adicionar uma página à folha de propriedades. A função usa um identificador de folha de propriedades retornado pela função CreatePropertySheetPage e o parâmetro lParam passado para esse método.

[in] lParam

Tipo: LPARAM

Dados específicos do manipulador a serem passados para a função apontada por pfnAddPage.

Retornar valor

Tipo: HRESULT

Se tiver êxito, retornará um índice baseado em um para especificar a página que deve ser inicialmente exibida. Confira Comentários para obter mais informações.

Comentários

Para cada página que o manipulador de folha de propriedades precisa adicionar a uma folha de propriedades, o manipulador preenche uma estrutura PROPSHEETPAGE , chama a função CreatePropertySheetPage e chama a função apontada por pfnAddPage.

O tipo de ponteiro da função LPFNADDPROPSHEETPAGE é definido em Prsht.h, conforme mostrado aqui. Ele aceita um identificador para uma estrutura PROPSHEETPAGE e dados definidos por função por meio de lParam.

typedef BOOL (* LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM);

Você pode solicitar por meio de sua implementação que uma página de folha de propriedades específica seja exibida primeiro, em vez da página padrão. Para fazer isso, retorne o índice baseado em um da página desejada em relação às páginas que você adicionou. Por exemplo, se você adicionou três páginas de folha de propriedades, A, B e C e deseja que B seja a página selecionada, o valor retornado deverá ser 2. Observe que esse valor retornado é apenas uma solicitação. A folha de propriedades ainda pode exibir a página padrão.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll (versão 4.0 ou posterior)