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 |