Método IViewObjectEx::GetRect (ocidl.h)

  • Artigo

Recupera um retângulo que descreve um aspecto de desenho solicitado.

Sintaxe

HRESULT GetRect(
  [in]  DWORD   dwAspect,
  [out] LPRECTL pRect
);

Parâmetros

[in] dwAspect

O aspecto de desenho solicitado.

[out] pRect

Um ponteiro para o retângulo que descreve o aspecto de desenho solicitado.

Retornar valor

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

Código de retorno Descrição
DV_E_DVASPECT
 O método não dá suporte ao aspecto especificado. O objeto não dá suporte ao aspecto solicitado ou o aspecto não é retangular.

Comentários

Esse método retorna um retângulo que descreve o aspecto de desenho especificado. O retângulo retornado está em unidades HIMETRIC , em relação à origem do objeto. O retângulo retornado depende do aspecto de desenho da seguinte maneira.

Aspecto de Desenho Descrição
DVASPECT_CONTENT Os objetos devem retornar o retângulo delimitador de todo o objeto. O canto superior esquerdo está na origem do objeto e o tamanho é igual à extensão retornada por IViewObject2::GetExtent.
DVASPECT_OPAQUE Objetos com uma região opaca retangular devem retornar esse retângulo. Outras pessoas devem falhar e retornar DV_E_DVASPECT de código de erro.

Se um retângulo for retornado, é garantido que ele seja completamente obscurecido chamando IViewObject::D raw para esse aspecto. O contêiner deve usar esse retângulo para cortar as partes opacas do objeto antes de desenhar qualquer objeto atrás dele durante a passagem de trás para a frente. Se esse método falhar em um objeto com uma região opaca não retangular, o contêiner deverá desenhar todo o objeto na parte de trás para a parte frontal usando o aspecto DVASPECT_CONTENT.
DVASPECT_TRANSPARENT Os objetos devem retornar o retângulo que abrange todas as partes transparentes ou irregulares. Se o objeto não tiver partes transparentes ou irregulares, ele poderá retornar DV_E_ASPECT. Um contêiner pode usar esse retângulo para determinar se há outros objetos sobrepondo as partes transparentes de um determinado objeto.

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

Confira também

Iviewobjectex