Interface IOleInPlaceSite (oleidl.h)

Gerencia a interação entre o contêiner e o site do cliente in-loco do objeto. Lembre-se de que o site do cliente é o site de exibição para objetos inseridos e fornece informações conceituais e de posição sobre o objeto.

Essa interface fornece métodos que gerenciam objetos in-loco. Com IOleInPlaceSite, você pode determinar se um objeto pode ser ativado e gerenciar sua ativação e desativação. Você pode notificar o contêiner quando um de seus objetos estiver sendo ativado e informar ao contêiner que um menu composto substituirá o menu regular do contêiner. Ele fornece métodos que possibilitam que o objeto in-loco recupere a hierarquia de objetos de janela e a posição na janela pai em que o objeto deve colocar sua janela de ativação in-loco. Por fim, ele determina como o contêiner rola o objeto, gerencia o estado de desfazer do objeto e notifica o objeto quando suas bordas são alteradas.

Herança

A interface IOleInPlaceSite herda de IOleWindow. IOleInPlaceSite também tem estes tipos de membros:

Métodos

A interface IOleInPlaceSite tem esses métodos.

IOleInPlaceSite::CanInPlaceActivate Determina se o contêiner pode ativar o objeto no local.
IOleInPlaceSite::D eactivateAndUndo Desativa o objeto, encerra a sessão in-loco e reverte para o estado de desfazer salvo do contêiner.
IOleInPlaceSite::D iscardUndoState Instrui o contêiner a descartar seu estado de desfazer. O contêiner não deve chamar IOleInPlaceObject::ReActivateAndUndo.
IOleInPlaceSite::GetWindowContext Permite que um objeto in-loco recupere as interfaces de janela que formam a hierarquia de objetos de janela e a posição na janela pai em que a janela de ativação in-loco do objeto deve estar localizada.
IOleInPlaceSite::OnInPlaceActivate Notifica o contêiner de que um de seus objetos está sendo ativado no local.
IOleInPlaceSite::OnInPlaceDeactivate Notifica o contêiner de que o objeto não está mais ativo no local.
IOleInPlaceSite::OnPosRectChange Notifica o contêiner de que as extensões do objeto foram alteradas.
IOleInPlaceSite::OnUIActivate 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.
IOleInPlaceSite::OnUIDeactivate Notifica o contêiner de que ele deve reinstalar sua interface do usuário e assumir o foco e se o objeto tem um estado de desfazer.
IOleInPlaceSite::Scroll Instrui o contêiner a rolar a exibição do objeto pelo número especificado de pixels.

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

Ioleclientsite

Iolewindow