Compartilhar via


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

Ajusta um retângulo especificado se ele estiver totalmente ou parcialmente coberto por objetos opacos sobrepostos.

Sintaxe

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

Parâmetros

[in, out] prc

O retângulo a ser ajustado.

Valor retornado

Esse método retornará S_OK se o retângulo tiver sido ajustado com êxito; o que significa que o retângulo não foi completamente coberto. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
S_FALSE
O retângulo foi ajustado com êxito. Observe S_FALSE significa que o retângulo foi completamente coberto. Sua largura e altura agora são NULL.

Comentários

O main uso desse método é ajustar o tamanho do cursor. Um objeto disposto a criar um cursor deve enviar o retângulo de cursor para seu objeto de site chamando esse método e usando o retângulo ajustado retornado dele para o cursor. Se o cursor estiver totalmente oculto, esse método retornará S_FALSE e o cursor não deverá ser mostrado neste caso.

Em uma situação em que os objetos estão sobrepostos, esse método deve retornar o maior retângulo totalmente visível.

Esse método também pode ser usado para descobrir se um ponto ou uma área retangular é visível ou oculto por objetos sobrepostos.

Requisitos

   
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

Ioleinplacesitewindowless