Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 |