IXpsOMTileBrush::GetViewbox-Methode (xpsobjectmodel.h)
Ruft den Teil des Quellimages ab, der von der Kachel verwendet werden soll.
Syntax
HRESULT GetViewbox(
[out, retval] XPS_RECT *viewbox
);
Parameter
[out, retval] viewbox
Die XPS_RECT Struktur, die den Bereich des Quellinhalts beschreibt, der von der Kachel verwendet werden soll.
Rückgabewert
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
viewbox ist NULL. |
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 links ein Beispiel für ein Quellbild, das Bild in der Mitte zeigt das ausgewählte Ansichtsfeld und das Bild rechts den resultierenden Pinsel.
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 × 4 / 96 = 24 Pixel von oben
- SourceWidth = 96 × 24 / 96 = 24 Pixel breit
- SourceHeight = 96 × 48 / 96 = 48 Pixel hoch
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |