Compartir a través de

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

  • Artículo

Agrega una o varias páginas a una hoja de propiedades que el Shell muestra para un objeto de archivo. El Shell llama a este método para cada controlador de hoja de propiedades registrado en el tipo de archivo.

Sintaxis

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

Parámetros

[in] pfnAddPage

Tipo: LPFNADDPROPSHEETPAGE

Puntero a una función a la que llama el controlador de hoja de propiedades para agregar una página a la hoja de propiedades. La función toma un identificador de hoja de propiedades devuelto por la función CreatePropertySheetPage y el parámetro lParam pasado a este método.

[in] lParam

Tipo: LPARAM

Datos específicos del controlador que se van a pasar a la función a la que apunta pfnAddPage.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve un índice basado en uno para especificar la página que se debe mostrar inicialmente. Vea Comentarios para obtener más información.

Comentarios

Para cada página que el controlador de hoja de propiedades necesita agregar a una hoja de propiedades, el controlador rellena una estructura PROPSHEETPAGE , llama a la función CreatePropertySheetPage y, a continuación, llama a la función a la que apunta pfnAddPage.

El tipo de puntero de función LPFNADDPROPSHEETPAGE se define en Prsht.h, como se muestra aquí. Acepta un identificador para una estructura PROPSHEETPAGE y datos definidos por funciones a través de lParam.

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

Puede solicitar a través de la implementación que se muestre primero una página de hoja de propiedades determinada, en lugar de la página predeterminada. Para ello, devuelva el índice basado en uno de la página deseada en relación con las páginas que agregó. Por ejemplo, si agregó tres páginas de hoja de propiedades, A, B y C, y desea que B sea la página seleccionada, el valor devuelto debe ser 2. Tenga en cuenta que este valor devuelto es solo una solicitud. La hoja de propiedades puede seguir mostrando la página predeterminada.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)
Archivo DLL Shell32.dll (versión 4.0 o posterior)