Metodo IXpsOMTileBrush::SetViewbox (xpsobjectmodel.h)
Imposta la parte del contenuto di origine da usare come immagine del riquadro.
Sintassi
HRESULT SetViewbox(
[in] const XPS_RECT *viewbox
);
Parametri
[in] viewbox
Struttura XPS_RECT che descrive la parte del contenuto di origine da usare come immagine del riquadro.
Valore restituito
Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per informazioni sui valori restituiti dall'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
viewbox è NULL. |
|
Il rettangolo descritto nella casella di visualizzazione non è valido. |
Commenti
La casella di visualizzazione del pennello specifica la parte di un'immagine di origine o un oggetto visivo da utilizzare come immagine del riquadro.
Le coordinate della casella di visualizzazione del pennello sono relative al contenuto di origine, in modo che (0,0) specifica l'angolo superiore sinistro del contenuto di origine. Per le immagini, le dimensioni specificate dalla casella di visualizzazione del pennello sono espresse nelle unità di 1/96". Le coordinate pixel corrispondenti nell'immagine di origine vengono calcolate come segue:
Nell'illustrazione seguente, l'immagine a sinistra è un esempio di un'immagine di origine, mentre a destra è l'immagine di origine con la casella di visualizzazione selezionata per il pennello visualizzato come rettangolo rosso. In questo esempio, la parte dell'immagine di origine usata come contenuto per il pennello del riquadro è l'area all'interno del rettangolo rosso. L'area ombreggiata dell'immagine non viene usata dal pennello.
Se la risoluzione dell'immagine di origine è 96 per 96 punti per pollice e le dimensioni dell'immagine sono 96 per 96 pixel, i valori dei campi nel parametro della casella di visualizzazione saranno:I valori dei parametri precedenti corrispondono all'immagine di origine come:
- SourceLeft = 96 * 48 / 96 = 48 pixel dal lato sinistro
- SourceTop = 96 * 24 / 96 = 24 pixel dalla parte superiore
- SourceWidth = 96 * 24 / 96 = 24 pixel wide
- SourceHeight = 96 * 48 / 96 = 48 pixel elevati
Requisiti
| Client minimo supportato | Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | xpsobjectmodel.h |