Método IXpsRasterizationFactory::CreateRasterizer (xpsrassvc.h)
O método CreateRasterize cria um objeto de rasterizador XPS.
Sintaxe
HRESULT CreateRasterizer(
[in, optional] IXpsOMPage *xpsPage,
[in] FLOAT DPI,
[in] XPSRAS_RENDERING_MODE nonTextRenderingMode,
[in] XPSRAS_RENDERING_MODE textRenderingMode,
[out, optional] IXpsRasterizer **ppIXPSRasterizer
);
Parâmetros
[in, optional] xpsPage
Ponteiro para um objeto IXpsOMPage que representa a página fixa XPS a ser renderizada. Esse objeto encapsula uma seção FixedPage de um documento XPS. Para obter mais informações, consulte IXpsOMPage.
[in] DPI
Pontos por polegada na saída rasterizada. Esse parâmetro se aplica às dimensões x e y do bitmap de saída. O DPI valor é a resolução do dispositivo que deve imprimir ou exibir a página fixa XPS.
[in] nonTextRenderingMode
Modo de renderização para itens nontext na saída rasterizada. Esse parâmetro indica se a saída anáralia deve ser gerada. Defina esse parâmetro como um dos seguintes valores de enumeração XPSRAS_RENDERING_MODE:
XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED
[in] textRenderingMode
Modo de renderização para texto na saída rasterizada. Esse parâmetro indica se a saída anáralia deve ser gerada. Defina esse parâmetro como um dos seguintes valores de enumeração XPSRAS_RENDERING_MODE:
XPSRAS_RENDERING_MODE_ANTIALIASED
XPSRAS_RENDERING_MODE_ALIASED
[out, optional] ppIXPSRasterizer
Esse parâmetro aponta para um local no qual o método grava um ponteiro na interface IXpsRasterizer do objeto de rasterizador XPS recém-criado. Se o método falhar, ele gravará NULL nesse local e retornará um código de erro.
Valor de retorno
CreateRasterizer retornará S_OK se a chamada tiver sido bem-sucedida. Caso contrário, o método retornará um código de erro.
Os valores de retorno de erro possíveis incluem:
| Código de retorno | Descrição |
|---|---|
| E_POINTER | O parâmetro xpsPage ou ppIXPSRasterizer é NULL |
| E_INVALIDARG | O parâmetro nonTextRenderingMode ou textRenderingMode não é um valor de enumeração XPSRAS_RENDERING_MODE válido. |
| E_OUTOFMEMORY | Memória insuficiente |
Observações
Esse método tem suporte no Windows 7 e posterior.
Normalmente, um filtro XPSDrv em um pipeline XPS chama esse método para obter um rasterizador XPS. Em seguida, ele usa o rasterizador para rasterizar a página fixa XPS encapsulada pelo objeto ao qual o parâmetro xpsPage pontos.
O parâmetro de DPI especifica a resolução da impressora, que é considerada a mesma nas dimensões horizontal e vertical. A largura e a altura da página fixa XPS, que podem ser obtidas do método IXpsOMPage::GetPageDimensions, são expressas em unidades de 1/96 polegadas. Multiplique esses valores de largura e altura DPI/96 para determinar a largura e a altura, em pixels, da página rasterizada. Para obter mais informações sobre IXpsOMPage::GetPageDimensions, consulte IXpsOMPage. Para obter mais informações sobre como o objeto rasterizador XPS usa o valor de DPI, consulte IXpsRasterizer::RasterizeRect.
Se bem-sucedido, o método cria um objeto de rasterizador XPS e passa para o chamador uma referência contada para a interface IXpsRasterizer do objeto. Quando o objeto não é mais necessário, o chamador é responsável por liberar o objeto chamando o método Release na interface IXpsRasterizer do objeto.
Se o método falhar e ppIXPSRasterizer não forNULL, o método definirá *ppIXPSRasterizer = NULL.
Para obter um exemplo de código que chama o método CreateRasterizer, consulte o exemplo XPSRasFilter no WDK. Este exemplo está localizado na pasta Src\Print\Xpsrasfilter na instalação do WDK.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 7 e versões posteriores do sistema operacional Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | xpsrassvc.h |