Obter e Definir Propriedades da Página
Aspose.PDF para .NET permite ler e configurar propriedades de páginas em um arquivo PDF em suas aplicações .NET. Esta seção mostra como obter o número de páginas em um arquivo PDF, obter informações sobre propriedades de páginas de PDF como cor e configurar propriedades da página. Os exemplos dados são em C#, mas você pode usar qualquer linguagem .NET como VB.NET para alcançar o mesmo.
O seguinte trecho de código também funciona com a biblioteca Aspose.PDF.Drawing.
Obter Número de Páginas em um Arquivo PDF
Ao trabalhar com documentos, você frequentemente quer saber quantas páginas eles contêm. Com Aspose.PDF isso leva não mais do que duas linhas de código.
Para obter o número de páginas em um arquivo PDF:
- Abra o arquivo PDF usando a classe Document.
- Em seguida, use a propriedade Count da coleção PageCollection (do objeto Document) para obter o número total de páginas no documento.
O seguinte trecho de código mostra como obter o número de páginas de um arquivo PDF. O seguinte trecho de código mostra como obter o número de páginas de um arquivo PDF.
Obter a contagem de páginas sem salvar o documento
Às vezes, geramos os arquivos PDF em tempo real e, durante a criação do arquivo PDF, podemos nos deparar com a necessidade (criação de Sumário, etc.) de obter a contagem de páginas do arquivo PDF sem salvar o arquivo no sistema ou stream. Assim, para atender a essa necessidade, um método ProcessParagraphs foi introduzido na classe Document. Por favor, veja o seguinte trecho de código que mostra os passos para obter a contagem de páginas sem salvar o documento.
Obter Propriedades da Página
Cada página em um arquivo PDF possui uma série de propriedades, tais como largura, altura, sangramento, caixa de corte e caixa de margem. Cada página em um arquivo PDF possui uma série de propriedades, como a largura, altura, sangria, caixa de corte e caixa de acabamento.
Entendendo as Propriedades das Páginas: a Diferença entre Artbox, BleedBox, CropBox, MediaBox, TrimBox e a Propriedade Rect
- Caixa de mídia: A caixa de mídia é a maior caixa de página. Ela corresponde ao tamanho da página (por exemplo, A4, A5, Carta dos EUA, etc.) selecionado quando o documento foi impresso em PostScript ou PDF. Em outras palavras, a caixa de mídia determina o tamanho físico da mídia na qual o documento PDF é exibido ou impresso.
- Caixa de sangria: Se o documento possui sangria, o PDF também terá uma caixa de sangria. Sangria é a quantidade de cor (ou arte) que se estende além da borda de uma página. É usada para garantir que, quando o documento é impresso e cortado no tamanho (“acabado”), a tinta irá até a borda da página. Mesmo que a página seja cortada imprecisamente - cortada ligeiramente fora das marcas de corte - não aparecerão bordas brancas na página.
- Caixa de acabamento: A caixa de acabamento indica o tamanho final de um documento após a impressão e o corte.
- Trim box: A caixa de corte indica o tamanho final de um documento após a impressão e corte.
- Art box: A caixa de arte é a caixa desenhada ao redor do conteúdo real das páginas em seus documentos. Esta caixa de página é usada ao importar documentos PDF em outras aplicações.
- Crop box: A caixa de corte é o tamanho de “página” no qual seu documento PDF é exibido no Adobe Acrobat. Na visualização normal, apenas o conteúdo da caixa de corte é exibido no Adobe Acrobat. Para descrições detalhadas dessas propriedades, leia a especificação Adobe.Pdf, particularmente 10.10.1 Limites de Página.
- Page.Rect: a interseção (retângulo comumente visível) da MediaBox e DropBox. A imagem abaixo ilustra essas propriedades.
Para mais detalhes, por favor visite esta página.
Acessando Propriedades da Página
A classe Page fornece todas as propriedades relacionadas a uma página PDF específica. A classe Page fornece todas as propriedades relacionadas a uma página PDF específica.
A partir daí, é possível acessar objetos Page individuais usando seu índice, ou percorrer a coleção, usando um loop foreach, para obter todas as páginas. Uma vez que uma página individual é acessada, podemos obter suas propriedades. O seguinte trecho de código mostra como obter as propriedades da página.
Obter uma Página Específica do Arquivo PDF
Aspose.PDF permite que você divida um PDF em páginas individuais e as salve como arquivos PDF. Obter uma página especificada em um arquivo PDF e salvá-la como um novo PDF é uma operação muito semelhante: abrir o documento fonte, acessar a página, criar um novo documento e adicionar a página a este.
O objeto Document possui um PageCollection que contém as páginas no arquivo PDF. O objeto Document possui uma PageCollection que contém as páginas do arquivo PDF.
- Especifique o índice da página usando a propriedade Pages.
- Crie um novo objeto Document.
- Adicione o objeto Page ao novo objeto Document.
- Salve a saída usando o método Save.
O seguinte trecho de código mostra como obter uma página específica de um arquivo PDF e salvá-la como um novo arquivo.
Determinar Cor da Página
A classe Page fornece as propriedades relacionadas a uma página específica em um documento PDF, incluindo o tipo de cor - RGB, preto e branco, escala de cinza ou indefinido - que a página utiliza. A classe Page fornece as propriedades relacionadas a uma página específica em um documento PDF, incluindo que tipo de cor - RGB, preto e branco, escala de cinza ou indefinido - a página utiliza.
Todas as páginas dos arquivos PDF estão contidas na coleção PageCollection. A propriedade ColorType especifica a cor dos elementos na página. Para obter ou determinar a informação de cor para uma página PDF específica, use a propriedade ColorType do objeto Page.
O seguinte trecho de código mostra como iterar através de cada página de um arquivo PDF para obter informações sobre a cor.