Método IOleInPlaceSite::OnUIActivate (oleidl.h)

  • Artigo

Notifica o contêiner de que o objeto está prestes a ser ativado no local e que o objeto substituirá o menu main do contêiner por um menu composto in-loco.

Sintaxe

HRESULT OnUIActivate();

Retornar valor

Esse método retornará S_OK se o contêiner permitir a ativação in-loco. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
E_UNEXPECTED
 Ocorreu um erro inesperado.

Comentários

Anotações para chamadores

O objeto in-loco chama IOleInPlaceSite::OnUIActivate pouco antes de ativar sua interface do usuário.

Anotações aos implementadores

O contêiner deve remover qualquer interface do usuário associada à sua própria ativação. Se o contêiner for um objeto inserido, ele deverá remover sua interface do usuário no nível do documento.

Se já houver um objeto ativo no mesmo documento, o contêiner deverá chamar IOleInPlaceObject::UIDeactivate antes de chamar OnUIDeactivate.

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

Confira também

IOleInPlaceObject::UIDeactivate

Ioleinplacesite