Função OleCreatePropertyFrame (olectl.h)

Invoca um novo quadro de propriedades, ou seja, uma caixa de diálogo de folha de propriedades, cujo pai é hwndOwner, em que a caixa de diálogo é posicionada no ponto (x,y) na janela pai e tem o legenda lpszCaption.

Sintaxe

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

Manipule para a janela pai da caixa de diálogo da folha de propriedades resultante.

[in] x

Reservado. Posição horizontal da caixa de diálogo em relação a hwndOwner.

[in] y

Reservado. Posição vertical da caixa de diálogo em relação a hwndOwner.

[in] lpszCaption

Ponteiro para a cadeia de caracteres usada para o legenda da caixa de diálogo.

[in] cObjects

Número de ponteiros de objeto passados em ppUnk.

[in] ppUnk

Uma matriz de ponteiros IUnknown nos objetos para os quais essa folha de propriedades está sendo invocada. O número de elementos na matriz é especificado por cObjects. Esses ponteiros são passados para cada página de propriedades por meio de IPropertyPage::SetObjects.

[in] cPages

Número de páginas de propriedades especificadas em pPageCIsID.

[in] pPageClsID

Matriz de cPages de tamanho que contém os CLSIDs de cada página de propriedades a ser exibida na folha de propriedades.

[in] lcid

Identificador de localidade a ser usado para a folha de propriedades. As páginas de propriedades podem recuperar esse identificador por meio de IPropertyPageSite::GetLocaleID.

[in] dwReserved

Reservado para uso futuro; deve ser zero.

[in] pvReserved

Reservado para uso futuro; deve ser NULL.

Retornar valor

Essa função dá suporte aos valores retornados padrão E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, bem como o seguinte:

Código de retorno Descrição
S_OK
A caixa de diálogo foi invocada e operada com êxito.
E_POINTER
O endereço em lpszCaption, ppUnk ou pPageCIsID não é válido. Por exemplo, qualquer um deles pode ser NULL.

Comentários

As páginas de propriedades a serem exibidas são identificadas com pPageClsID, que é uma matriz de valores CLSIDde cPages. Os objetos afetados por essa folha de propriedades são identificados em ppUnk, uma matriz de cObjects de tamanho que contém ponteiros IUnknown .

Essa função sempre cria uma caixa de diálogo modal e não retorna até que a caixa de diálogo seja fechada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [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 olectl.h
Biblioteca OleAut32.lib
DLL OleAut32.dll

Confira também

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID