Compartilhar via

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

  • Artigo

Notifica o contêiner de que um de seus objetos está sendo ativado no local.

Sintaxe

HRESULT OnInPlaceActivate();

Valor retornado

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 aos Chamadores

OnInPlaceActivate é chamado pelo objeto inserido ativo quando ele é ativado in-loco pela primeira vez. O contêiner deve observar que o objeto está se tornando ativo.

Observações aos implementadores

Um contêiner que dá suporte à vinculação a objetos inseridos deve gerenciar corretamente a execução de seus objetos in-loco quando eles estiverem inativos na interface do usuário e em execução no estado oculto. Para reativar o objeto in-loco rapidamente, um contêiner não deve chamar IOleObject::Close até que o método IOleInPlaceSite::D eactivateAndUndo do contêiner seja chamado. Para ajudar a proteger contra o objeto que está sendo deixado em um estado instável se um cliente de vinculação for atualizado silenciosamente, o contêiner deverá chamar OleLockRunning para bloquear o objeto no estado em execução. Isso impede que o objeto in-loco oculto seja desligado antes que ele possa ser salvo em seu contêiner.

Requisitos

   
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

Ioleinplacesite