Metodo IXpsRasterizationFactory::CreateRasterizer (xpsrassvc.h)
Il metodo CreateRasterize crea un oggetto rasterizzatore XPS.
Sintassi
HRESULT CreateRasterizer(
[in, optional] IXpsOMPage *xpsPage,
[in] FLOAT DPI,
[in] XPSRAS_RENDERING_MODE nonTextRenderingMode,
[in] XPSRAS_RENDERING_MODE textRenderingMode,
[out, optional] IXpsRasterizer **ppIXPSRasterizer
);
Parametri
[in, optional] xpsPage
Puntatore a un oggetto IXpsOMPage che rappresenta la pagina fissa XPS di cui eseguire il rendering. Questo oggetto incapsula una sezione FixedPage da un documento XPS. Per altre informazioni, vedere IXpsOMPage.
[in] DPI
Punti per pollice nell'output rasterizzato. Questo parametro si applica alle dimensioni x e y della bitmap di output. Il valore DPI è la risoluzione del dispositivo che deve stampare o visualizzare la pagina fissa XPS.
[in] nonTextRenderingMode
Modalità di rendering per gli elementi non di testo nell'output rasterizzato. Questo parametro indica se generare un output antialiased. Impostare questo parametro su uno dei valori di enumerazione XPSRAS_RENDERING_MODE seguenti:
XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED
[in] textRenderingMode
Modalità di rendering per il testo nell'output rasterizzato. Questo parametro indica se generare un output antialiased. Impostare questo parametro su uno dei valori di enumerazione XPSRAS_RENDERING_MODE seguenti:
XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED
[out, optional] ppIXPSRasterizer
Questo parametro punta a una posizione in cui il metodo scrive un puntatore nell'interfaccia IXpsRasterizer dell'oggetto rasterizzatore XPS appena creato. Se il metodo ha esito negativo, scrive NULL in questo percorso e restituisce un codice di errore.
Valore restituito
CreateRasterizer restituisce S_OK se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore.
I valori restituiti di errore possibili includono:
| Codice restituito | Descrizione |
|---|---|
| E_POINTER | Il parametro xpsPage o ppIXPSRasterizer è NULL |
| E_INVALIDARG | Il parametro nonTextRenderingMode o textRenderingMode non è un valore di enumerazione XPSRAS_RENDERING_MODE valido. |
| E_OUTOFMEMORY | Memoria insufficiente |
Commenti
Questo metodo è supportato in Windows 7 e versioni successive.
In genere, un filtro XPSDrv in una pipeline XPS chiama questo metodo per ottenere un rasterizzatore XPS. Usa quindi il rasterizzatore per rasterizzare la pagina fissa XPS incapsulata dall'oggetto a cui punta il parametro xpsPage .
Il parametro DPI specifica la risoluzione della stampante, che si presuppone che sia la stessa nelle dimensioni orizzontali e verticali. La larghezza e l'altezza della pagina fissa XPS, che può essere ottenuta dal metodo IXpsOMPage::GetPageDimensions , sono espresse in unità da 1/96 pollici. Moltiplicare questi valori di larghezza e altezza per DPI/96 per determinare la larghezza e l'altezza, in pixel, della pagina rasterizzata. Per altre informazioni su IXpsOMPage::GetPageDimensions, vedere IXpsOMPage. Per altre informazioni su come l'oggetto rasterizzatore XPS usa il valore DPI, vedere IXpsRasterizer::RasterizeRect.
In caso di esito positivo, il metodo crea un oggetto rasterizzatore XPS e passa al chiamante un riferimento contato all'interfaccia IXpsRasterizer dell'oggetto. Quando l'oggetto non è più necessario, il chiamante è responsabile del rilascio dell'oggetto chiamando il metodo Release sull'interfaccia IXpsRasterizer dell'oggetto.
Se il metodo ha esito negativo e ppIXPSRasterizer non è NULL, il metodo imposta *ppIXPSRasterizer = NULL.
Per un esempio di codice che chiama il metodo CreateRasterizer , vedere l'esempio XPSRasFilter in WDK. Questo esempio si trova nella cartella Src\Print\Xpsrasfilter nell'installazione di WDK.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive del sistema operativo Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | xpsrassvc.h |