Layout da Página de Imagem

Layout de Página de Imagem

Esta página documenta a classe de configuração MultiPageLayout e suas enumerações relacionadas à renderização de imagens, e explica por que elas não possuem um caminho de salvamento funcional nesta edição.

Aspose.Words FOSS para .NET inclui um pequeno conjunto de classes de modelo para descrever como várias páginas de documento seriam organizadas quando renderizadas em uma única saída baseada em imagem — MultiPageLayout e suas enumerações de suporte. Esta edição não inclui o próprio motor de layout de página e renderização (veja Recursos e Funcionalidades e o resumo do produto), portanto esses tipos existem na superfície pública de API como primitivas de configuração sem um caminho de salvamento que os consuma nesta compilação.

MultiPageLayout

MultiPageLayout é uma classe selada cujos métodos de fábrica estáticos criam cada um um arranjo de múltiplas páginas diferente: Vertical(verticalGap) empilha páginas de cima para baixo com o espaçamento especificado entre elas; Horizontal(horizontalGap) coloca as páginas lado a lado, da esquerda para a direita; Grid(columns, horizontalGap, verticalGap) organiza as páginas da esquerda para a direita, de cima para baixo em uma grade com a contagem de colunas especificada; TiffFrames() mantém cada página como um quadro separado em vez de combiná-las em uma única imagem; e SinglePage() renderiza apenas uma única página. Depois de construído, uma instância de MultiPageLayout expõe BackColor e BorderColor (ambos Color) e BorderWidth (float) para estilizar a saída combinada.

Enumerações de Renderização Relacionadas

Três enumerações adicionais descrevem o mesmo domínio “páginas de documento como imagens”: ImageColorMode (None, Grayscale, BlackAndWhite) controla o modo de cor das imagens de página geradas; ImagePixelFormat lista os formatos de pixel disponíveis para as imagens de página geradas (como Format24BppRgb e Format32BppArgb); e ImageBinarizationMethod (Threshold, FloydSteinbergDithering) especifica como uma imagem é convertida para preto-e-branco. Assim como MultiPageLayout, estas são definidas na superfície API mas não estão atualmente conectadas a uma classe de opções de salvamento nesta edição — esta compilação FOSS não inclui exportação de imagem, PDF ou XPS.

Dicas e Melhores Práticas

• Trate MultiPageLayout e suas enumerações relacionadas como apenas de referência nesta edição — não há caminho Save() na superfície pública do API que consome uma instância MultiPageLayout para realmente produzir uma imagem.
• Se o seu fluxo de trabalho precisar renderizar documentos Word para TIFF, PNG, JPEG ou outros formatos de imagem, use a versão comercial Aspose.Words para .NET, que inclui o mecanismo de renderização completo para o qual esses tipos foram projetados.
• Não confunda esta área de layout de página para imagens com a inserção de imagens dentro de um documento (o Shape / ImageData API) — isso é um recurso separado e normal de conteúdo de documento, não de renderização de página.

Problemas Comuns

FAQ

Posso usar MultiPageLayout para exportar meu documento como um TIFF multipágina?

Não nesta edição. MultiPageLayout e suas enumerações de suporte (ImageColorMode, ImagePixelFormat, ImageBinarizationMethod) estão presentes na superfície do API, mas o pipeline de salvamento de renderização de imagem que as consumiria não faz parte desta compilação FOSS.

Por que essa classe existe se não é funcional aqui?

Aspose.Words FOSS para .NET é a base de código Aspose.Words genuína reduzida a um núcleo livre, não uma reescrita — algumas classes da camada de modelo vinculadas ao motor de renderização removido permanecem compiladas na biblioteca, embora nenhum caminho de salvamento suportado atualmente as utilize.

A incorporação de uma imagem dentro de um documento também está excluída?

Não — inserir e formatar imagens dentro do conteúdo de um documento (via Shape e ImageData) é um recurso normal e suportado de edição de documentos. Apenas a renderização de páginas inteiras para um formato de imagem está excluída.

API Reference Resumo