Función OleCreatePropertyFrame (olectl.h)

Invoca un nuevo marco de propiedad, es decir, un cuadro de diálogo de hoja de propiedades, cuyo elemento primario es hwndOwner, donde el cuadro de diálogo se coloca en el punto (x,y) en la ventana primaria y tiene el subtítulo lpszCaption.

Sintaxis

WINOLECTLAPI OleCreatePropertyFrame(
  [in] HWND      hwndOwner,
  [in] UINT      x,
  [in] UINT      y,
  [in] LPCOLESTR lpszCaption,
  [in] ULONG     cObjects,
  [in] LPUNKNOWN *ppUnk,
  [in] ULONG     cPages,
  [in] LPCLSID   pPageClsID,
  [in] LCID      lcid,
  [in] DWORD     dwReserved,
  [in] LPVOID    pvReserved
);

Parámetros

[in] hwndOwner

Identificador de la ventana primaria del cuadro de diálogo de hoja de propiedades resultante.

[in] x

Reservado. Posición horizontal del cuadro de diálogo con respecto a hwndOwner.

[in] y

Reservado. Posición vertical del cuadro de diálogo con respecto a hwndOwner.

[in] lpszCaption

Puntero a la cadena usada para el subtítulo del cuadro de diálogo.

[in] cObjects

Número de punteros de objeto pasados en ppUnk.

[in] ppUnk

Matriz de punteros IUnknown en los objetos para los que se invoca esta hoja de propiedades. CObjects especifica el número de elementos de la matriz. Estos punteros se pasan a cada página de propiedades a través de IPropertyPage::SetObjects.

[in] cPages

Número de páginas de propiedades especificadas en pPageCIsID.

[in] pPageClsID

Matriz de tamaño cPages que contiene los CLSID de cada página de propiedades para mostrar en la hoja de propiedades.

[in] lcid

Identificador de configuración regional que se va a usar para la hoja de propiedades. Las páginas de propiedades pueden recuperar este identificador a través de IPropertyPageSite::GetLocaleID.

[in] dwReserved

Reservado para uso futuro; debe ser cero.

[in] pvReserved

Reservado para uso futuro; debe ser NULL.

Valor devuelto

Esta función admite los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y E_UNEXPECTED, así como lo siguiente:

Código devuelto	Descripción
S_OK	El cuadro de diálogo se invocó y funcionó correctamente.
E_POINTER	La dirección de lpszCaption, ppUnk o pPageCIsID no es válida. Por ejemplo, cualquiera de ellos puede ser NULL.

Comentarios

Las páginas de propiedades que se van a mostrar se identifican con pPageClsID, que es una matriz de valores CLSID de cPages. Los objetos afectados por esta hoja de propiedades se identifican en ppUnk, una matriz de tamaño cObjects que contiene punterosIUnknown .

Esta función siempre crea un cuadro de diálogo modal y no vuelve hasta que se cierra el cuadro de diálogo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	olectl.h
Library	OleAut32.lib
Archivo DLL	OleAut32.dll

Consulte también

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID