Método IPropertyPage::Activate (ocidl.h)

Cria a janela da caixa de diálogo para a página de propriedade.

A caixa de diálogo é criada sem um quadro, legenda ou menu/controles do sistema. O texto na caixa de diálogo deve corresponder à localidade obtida por meio de IPropertyPageSite::GetLocaleID.

Sintaxe

HRESULT Activate(
  [in] HWND    hWndParent,
  [in] LPCRECT pRect,
  [in] BOOL    bModal
);

Parâmetros

[in] hWndParent

O identificador de janela do pai da caixa de diálogo que está sendo criada.

[in] pRect

Um ponteiro para a estrutura RECT que contém as informações de posicionamento da caixa de diálogo. Esse método deve criar sua caixa de diálogo com o posicionamento e as dimensões descritos por essa estrutura.

[in] bModal

Indica se o quadro da caixa de diálogo é modal (TRUE) ou modeless (FALSE).

Retornar valor

Esse método pode retornar os valores de retorno padrão E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_POINTER	O endereço na prc não é válido. Por exemplo, pode ser NULL.

Comentários

A página de propriedades mantém o identificador de janela criado nesse processo, que ele usa para destruir a caixa de diálogo dentro de IPropertyPage::D ativar.

Anotações aos implementadores

E_NOTIMPL não é um valor retornado válido.

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	ocidl.h

Confira também

Ipropertypage