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

  • Artigo

Recupera as coordenadas retangulares do visor no qual a exibição é ou será ativada.

Sintaxe

HRESULT GetRect(
  [out] LPRECT prcView
);

Parâmetros

[out] prcView

Um ponteiro para uma estrutura RECT para conter as coordenadas do conjunto de visores atual com IOleDocumentView::SetRect.

Valor retornado

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

Código de retorno Descrição
E_UNEXPECTED
 Essa exibição ainda não viu uma chamada para IOleDocumentView::SetRect ou IOleDocumentView::SetRectComplex e, portanto, não tem nenhum retângulo para retornar.

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.

As coordenadas do visor obtidas por esse método são aquelas definidas na chamada mais recente para IOleDocumentView::SetRect ou IOleDocumentView::SetRectComplex.

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

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

Confira também

Ioledocumentview

IOleDocumentView::SetRect

IOleDocumentView::SetRectComplex