Método IViewObjectEx::GetRect (ocidl.h)
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 |
---|---|
|
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 |