IViewObjectEx::GetRect-Methode (ocidl.h)
Ruft ein Rechteck ab, das einen angeforderten Zeichnungsaspekt beschreibt.
Syntax
HRESULT GetRect(
[in] DWORD dwAspect,
[out] LPRECTL pRect
);
Parameter
[in] dwAspect
Der angeforderte Zeichnungsaspekt.
[out] pRect
Ein Zeiger auf das Rechteck, das den angeforderten Zeichnungsaspekt beschreibt.
Rückgabewert
Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:
| Rückgabecode | Beschreibung |
|---|---|
|
Die -Methode unterstützt den angegebenen Aspekt nicht. Entweder unterstützt das Objekt den angeforderten Aspekt nicht oder der Aspekt ist nicht rechteckig. |
Hinweise
Diese Methode gibt ein Rechteck zurück, das den angegebenen Zeichnungsaspekt beschreibt. Das zurückgegebene Rechteck befindet sich relativ zum Ursprung des Objekts in HIMETRIC-Einheiten . Das zurückgegebene Rechteck hängt wie folgt vom Zeichnungsaspekt ab.
| Zeichnungsaspekt | BESCHREIBUNG |
|---|---|
| DVASPECT_CONTENT | Objekte sollten das umgebende Rechteck des gesamten Objekts zurückgeben. Die obere linke Ecke befindet sich am Ursprung des Objekts, und die Größe entspricht dem von IViewObject2::GetExtent zurückgegebenen Umfang. |
| DVASPECT_OPAQUE |
Objekte mit einem rechteckigen undurchsichtigen Bereich sollten dieses Rechteck zurückgeben. Andere Sollten fehlschlagen und Fehlercode DV_E_DVASPECT zurückgeben.
Wenn ein Rechteck zurückgegeben wird, wird es garantiert vollständig verschleiert, indem für diesen Aspekt IViewObject::D raw aufgerufen wird. Der Container sollte dieses Rechteck verwenden, um die undurchsichtigen Teile des Objekts auszuschneiden, bevor während des Durchgangs von hinten nach vorne ein Objekt dahinter gezeichnet wird. Wenn diese Methode bei einem Objekt mit einem nicht rechteckigen undurchsichtigen Bereich fehlschlägt, sollte der Container das gesamte Objekt im Vorder- und Rückseitenteil mit dem DVASPECT_CONTENT-Aspekt zeichnen. |
| DVASPECT_TRANSPARENT | Objekte sollten das Rechteck zurückgeben, das alle transparenten oder unregelmäßigen Teile abdeckt. Wenn das Objekt keine transparenten oder unregelmäßigen Teile aufweist, kann es DV_E_ASPECT zurückgeben. Ein Container kann dieses Rechteck verwenden, um zu bestimmen, ob es andere Objekte gibt, die die transparenten Teile eines bestimmten Objekts überlappen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |