IOleInPlaceSiteWindowless::AdjustRect-Methode (ocidl.h)

  • Artikel

Passt ein bestimmtes Rechteck an, wenn es vollständig oder teilweise durch Überschneidung nicht transparenter Objekte abgedeckt wird.

Syntax

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

Parameter

[in, out] prc

Das rechteck, das angepasst werden soll.

Rückgabewert

Diese Methode gibt S_OK zurück, wenn das Rechteck erfolgreich angepasst wurde. Dies bedeutet, dass das Rechteck nicht vollständig abgedeckt war. Weitere mögliche Rückgabewerte:

Rückgabecode Beschreibung
S_FALSE
 Das Rechteck wurde erfolgreich ausgerichtet. Hinweis S_FALSE bedeutet, dass das Rechteck vollständig abgedeckt wurde. Breite und Höhe sind jetzt NULL.

Hinweise

Die Standard Verwendung dieser Methode besteht darin, die Größe des Carets anzupassen. Ein Objekt, das bereit ist, ein Caret zu erstellen, sollte das Caret-Rechteck an sein Websiteobjekt übermitteln, indem es diese Methode aufruft und das von ihm zurückgegebene angepasste Rechteck für das Caret verwendet. Wenn der Caret vollständig ausgeblendet ist, gibt diese Methode S_FALSE zurück, und der Caret sollte in diesem Fall überhaupt nicht angezeigt werden.

In einer Situation, in der Objekte überlappen, sollte diese Methode das größte Rechteck zurückgeben, das vollständig sichtbar ist.

Diese Methode kann auch verwendet werden, um zu ermitteln, ob ein Punkt oder ein rechteckiger Bereich durch überlappende Objekte sichtbar oder ausgeblendet ist.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

IOleInPlaceSiteWindowless