Compartir a través de

Método IOleInPlaceSiteWindowless::AdjustRect (ocidl.h)

  • Artículo

Ajusta un rectángulo especificado si está cubierto total o parcialmente mediante objetos opacos superpuestos.

Sintaxis

HRESULT AdjustRect(
  [in, out] LPRECT prc
);

Parámetros

[in, out] prc

Rectángulo que se va a ajustar.

Valor devuelto

Este método devuelve S_OK si el rectángulo se ha ajustado correctamente; lo que significa que el rectángulo no estaba completamente cubierto. Otros posibles valores devueltos son los siguientes.

Código devuelto Descripción
S_FALSE
 El rectángulo se ajustó correctamente. Observe que S_FALSE significa que el rectángulo estaba cubierto totalmente. Su ancho y alto ahora son NULL.

Comentarios

El uso principal de este método es ajustar el tamaño del símbolo de intercalación. Un objeto dispuesto a crear un símbolo de intercalación debe enviar el rectángulo de intercalación a su objeto de sitio llamando a este método y usando el rectángulo ajustado devuelto por él para el símbolo de intercalación. Si el símbolo de intercalación está completamente oculto, este método devolverá S_FALSE y el símbolo de intercalación no debe mostrarse en absoluto en este caso.

En una situación en la que los objetos se superponen a este método deben devolver el rectángulo más grande que es totalmente visible.

Este método también se puede usar para determinar si un punto o un área rectangular están visibles u ocultas por objetos superpuestos.

Requisitos

   
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

IOleInPlaceSiteWindowless