Compartilhar via

Método IOleDocumentView::SetRect (docobj.h)

  • Artigo

Define as coordenadas retangulares do visor no qual a exibição deve ser ativada ou redefine as coordenadas do visor no qual uma exibição está ativada no momento.

Sintaxe

HRESULT SetRect(
  [in] LPRECT prcView
);

Parâmetros

[in] prcView

Um ponteiro para uma estrutura RECT que contém as coordenadas do visor.

Retornar valor

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

Código de retorno Descrição
E_FAIL
 Falha na operação.

Comentários

Para um único aplicativo de interface de documento (SDI), o visor é a área do cliente da janela de quadro menos o espaço alocado para barras de ferramentas, status barra e tal. Para uma janela MDI (interface de documento múltiplo), o visor é a área do cliente da janela do documento MDI menos quaisquer outros elementos de interface do usuário no nível do quadro.

Anotações para chamadores

Chamar IOleDocumentView::SetRect ou IOleDocumentView::SetRectComplex faz parte da sequência de ativação normal para objetos de documento, geralmente seguindo uma chamada para IOleDocumentView::UIActivate e precedendo uma chamada para IOleDocumentView::Show.

Sempre que a janela usada para exibir um objeto de documento for redimensionada, o contêiner deverá chamar IOleDocumentView::SetRect (ou IOleDocumentView::SetRectComplex) para informar o objeto de exibição do documento para se redimensionar para as novas dimensões de janela.

Anotações aos implementadores

As coordenadas do visor estão dentro das coordenadas da janela de exibição, que é obtida por meio de IOleWindow::GetWindow. A exibição deve se redimensionar para se ajustar às novas coordenadas passadas em prcView.

Esse método é definido com o atributo [input_sync], o que significa que o objeto de exibição não pode produzir ou fazer outra chamada RPC não input_sync durante a execução desse método.

Uma exibição de documento deve implementar esse método completamente; E_NOTIMPL não é um valor retornado aceitável.

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

Confira também

Ioledocumentview