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

  • Artigo

Notifica o contêiner de que as extensões do objeto foram alteradas.

Sintaxe

HRESULT OnPosRectChange(
  [in] LPCRECT lprcPosRect
);

Parâmetros

[in] lprcPosRect

Um ponteiro para uma estrutura RECT que contém a posição do objeto in-loco nas coordenadas do cliente de sua janela pai.

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
E_INVALIDARG
 O ponteiro fornecido é inválido.
E_UNEXPECTED
 Erro inesperado.

Comentários

Anotações aos Chamadores

O método OnPosRectChange é chamado pelo objeto in-loco.

Observações aos implementadores

Quando o objeto in-loco chama OnPosRectChange, o contêiner deve chamar IOleInPlaceObject::SetObjectRects para especificar a nova posição da janela in-loco e o retângulo de recorte. Somente então o objeto redimensiona sua janela.

Na maioria dos casos, o objeto cresce para a direita e/ou para baixo. Pode haver casos em que o objeto cresce para a esquerda e/ou para cima, conforme transmitido por lprcPosRect. Também é possível alterar a posição do objeto sem alterar seu tamanho.

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::SetObjectRects

Ioleinplacesite