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

  • Artículo

Recupera un rectángulo que describe un aspecto de dibujo solicitado.

Sintaxis

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

Parámetros

[in] dwAspect

Aspecto de dibujo solicitado.

[out] pRect

Puntero al rectángulo que describe el aspecto de dibujo solicitado.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
DV_E_DVASPECT
 El método no admite el aspecto especificado. El objeto no admite el aspecto solicitado o el aspecto no es rectangular.

Comentarios

Este método devuelve un rectángulo que describe el aspecto de dibujo especificado. El rectángulo devuelto está en unidades HIMETRIC , en relación con el origen del objeto. El rectángulo devuelto depende del aspecto del dibujo como se indica a continuación.

Aspecto del dibujo Descripción
DVASPECT_CONTENT Los objetos deben devolver el rectángulo delimitador de todo el objeto. La esquina superior izquierda está en el origen del objeto y el tamaño es igual a la extensión devuelta por IViewObject2::GetExtent.
DVASPECT_OPAQUE Los objetos con una región opaca rectangular deben devolver ese rectángulo. Otros deben producir errores y devolver código de error DV_E_DVASPECT.

Si se devuelve un rectángulo, se garantiza que está completamente oculto llamando a IViewObject::D raw para ese aspecto. El contenedor debe usar ese rectángulo para recortar las partes opacas del objeto antes de dibujar cualquier objeto detrás de él durante el retroceso al paso frontal. Si se produce un error en este método en un objeto con una región opaca no rectangular, el contenedor debe dibujar todo el objeto en la parte frontal mediante el aspecto DVASPECT_CONTENT.
DVASPECT_TRANSPARENT Los objetos deben devolver el rectángulo que cubre todas las partes transparentes o irregulares. Si el objeto no tiene ninguna parte transparente o irregular, puede devolver DV_E_ASPECT. Un contenedor puede usar este rectángulo para determinar si hay otros objetos superpuestos a las partes transparentes de un objeto determinado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IViewObjectEx