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 tí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

Controlar hasta 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 en relación con hwndOwner.

[in] lpszCaption

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

[in] cObjects

Número de punteros de objeto pasados en ppUnk.

[in] ppUnk

Matriz de IUnknown punteros en los objetos para los que se invoca esta hoja de propiedades. El número de elementos de la matriz se especifica mediante cObjects. 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 que se van a 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, ppUnko pPageCIsID no es válida. Por ejemplo, cualquiera de ellos puede ser NULL.

Observaciones

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

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

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	olectl.h
biblioteca de	OleAut32.lib
DLL de	OleAut32.dll

Consulte también

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID