IXpsOMTileBrush::SetViewbox-Methode (xpsobjectmodel.h)
Legt den Teil des Quellinhalts fest, der als Kachelbild verwendet werden soll.
Syntax
HRESULT SetViewbox(
[in] const XPS_RECT *viewbox
);
Parameter
[in] viewbox
Eine XPS_RECT-Struktur , die den Teil des Quellinhalts beschreibt, der als Kachelbild verwendet werden soll.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
viewbox ist NULL. |
|
Das im Viewbox beschriebene Rechteck war ungültig. |
Hinweise
Das Ansichtsfeld des Pinsels gibt den Teil eines Quellbilds oder Visuals an, der als Kachelbild verwendet werden soll.
Die Koordinaten des Ansichtsfelds des Pinsels sind relativ zum Quellinhalt, sodass (0,0) die obere linke Ecke des Quellinhalts angibt. Bei Bildern werden die vom Viewbox des Pinsels angegebenen Dimensionen in den Einheiten 1/96" ausgedrückt. Die entsprechenden Pixelkoordinaten im Quellbild werden wie folgt berechnet:
In der folgenden Abbildung ist das Bild auf der linken Seite ein Beispiel für ein Quellbild, während sich auf der rechten Seite das Quellbild mit dem ausgewählten Ansichtsfeld für den Pinsel befindet, der als rotes Rechteck angezeigt wird. In diesem Beispiel ist der Teil des Quellbilds, der als Inhalt für den Kachelpinsel verwendet wird, der Bereich innerhalb des roten Rechtecks. Der schattierte Bereich des Bilds wird vom Pinsel nicht verwendet.
Wenn die Quellbildauflösung 96 x 96 Punkte pro Zoll beträgt und die Bilddimensionen 96 x 96 Pixel betragen, sind die Werte der Felder im Viewbox-Parameter wie folgt:Die obigen Parameterwerte entsprechen dem Quellimage wie:
- SourceLeft = 96 * 48 / 96 = 48 Pixel von der linken Seite
- SourceTop = 96 * 24 / 96 = 24 Pixel von oben
- SourceWidth = 96 * 24 / 96 = 24 Pixel breit
- SourceHeight = 96 * 48 / 96 = 48 Pixel hoch
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | xpsobjectmodel.h |