Metodo IXpsRasterizationFactory::CreateRasterizer (xpsrassvc.h)

  • Articolo

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

Vedi anche

IXpsRasterizationFactory

IXpsRasterizer

IXpsRasterizer::RasterizeRect

XPSRAS_RENDERING_MODE