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

Define as coordenadas retangulares do visor, das barras de rolagem e da caixa de tamanho.

Sintaxe

HRESULT SetRectComplex(
  [in] LPRECT prcView,
  [in] LPRECT prcHScroll,
  [in] LPRECT prcVScroll,
  [in] LPRECT prcSizeBox
);

Parâmetros

[in] prcView

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

[in] prcHScroll

Um ponteiro para uma estrutura RECT que contém as coordenadas da barra de rolagem horizontal.

[in] prcVScroll

Um ponteiro para uma estrutura RECT que contém as coordenadas da barra de rolagem vertical.

[in] prcSizeBox

Um ponteiro para uma estrutura RECT que contém as coordenadas da caixa de tamanho.

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_FAIL	Falha na operação.
E_NOTIMPL	O objeto de documento que possui essa exibição não dá suporte a retângulos complexos.

Comentários

Quadros de exibição que dão suporte a uma metáfora de pasta de trabalho, na qual um único documento compreende várias planilhas ou páginas, normalmente chamam esse método para definir as coordenadas a serem usadas em comum por todas as planilhas ou páginas.

Anotações aos Chamadores

Chamar IOleDocumentView::SetRectComplex faz parte da sequência de ativação normal para objetos de documento que dão suporte a retângulos complexos, 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::SetRectComplex ou IOleDocumentView::SetRect para instruir o objeto de exibição a se redimensionar para as novas dimensões da janela.

Observações aos implementadores

Objetos de documento que dão suporte a retângulos complexos marcam-se com DOCMISC_SUPPORTCOMPLEXRECTANGLES, conforme descrito em DOCMISC e IOleDocument::GetDocMiscStatus. Objetos de documento que não dão suporte a esse método podem retornar E_NOTIMPL.

Ao receber uma chamada para esse método, uma exibição deve se redimensionar para ajustar as coordenadas especificadas em prcView e ajustar suas barras de rolagem e caixa de tamanho às áreas descritas em prcHScroll, prcVScroll e prcSizeBox.

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

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

IOleDocument::GetDocMiscStatus

Ioledocumentview