Função OleCreatePropertyFrame (olectl.h)

Artigo
07/16/2024

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 está posicionada no ponto (x,y) na janela pai e tem a 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 relativa a hwndOwner.

[in] y

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

[in] lpszCaption

Ponteiro para a cadeia de caracteres usada para a 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 esta 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 propriedade por meio de IPropertyPage::SetObjects.

[in] cPages

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

[in] pPageClsID

Matriz de tamanho cPages que contém os CLSIDs de cada página de propriedade 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.

Valor de retorno

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

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, ppUnkou pPageCIsID não é válido. Por exemplo, qualquer um deles pode ser NULL.

Observações

As páginas de propriedades a serem exibidas são identificadas com pPageClsID, que é uma matriz de cPagesvalores de CLSID. Os objetos afetados por essa folha de propriedades são identificados em ppUnk, uma matriz de tamanho cObjects contendo 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
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	olectl.h
biblioteca	OleAut32.lib
de DLL	OleAut32.dll

Consulte também

IPropertyPage::SetObjects

IPropertyPageSite::GetLocaleID

Compartilhar via