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 |
---|---|
|
A caixa de diálogo foi invocada e operada com êxito. |
|
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de