Navegação e Ações

Navegação e Ações

Aspose.PDF FOSS for .NET supports PDF navigation structures — bookmarks (outlines), page destinations, and document actions. These let you create interactive documents with table-of-contents navigation, cross-page links, and JavaScript triggers.


Descrição do documento (marcas de favoritos)

OutlineCollection Cada um deles contém a árvore de marcadores do documento. OutlineItemCollection é uma entrada de marcador com título e destino.

using var doc = Document.Open(pdfBytes);

foreach (var item in doc.Outlines)
{
    Console.WriteLine($"Bookmark: {item.Title}");
}

Criar marcadores

using var doc = Document.Open(pdfBytes);

var bookmark = new OutlineItemCollection(doc.Outlines);
bookmark.Title = "Chapter 1";
bookmark.Action = new GoToAction(doc.Pages[1]);
doc.Outlines.Add(bookmark);

doc.Save("with-bookmarks.pdf");

Ações de GoTo

GoToAction navega para uma página específica e encaixa no mesmo tipo de documento.

var goTo = new GoToAction(doc.Pages[3]);

Acções denominadas

NamedAction Trigger comandos de visualização PDF predefinidos, como NextPage;, PrevPage, Primeira página e Última página.

var nextPage = PdfAction.CreateNamed("NextPage");

Ações GoToRemote

GoToRemoteAction abre um arquivo PDF externo e navega para uma determinada página de página.

var remote = new GoToRemoteAction("other.pdf", 1);

Ações de lançamento

LaunchAction abre um ficheiro externo (qualquer formato) a partir de uma ligação PDF.

var launch = new LaunchAction("readme.txt");

Coleções de destino

DestinationCollection mapas com nomes de destinos para páginas, apoiando Navegação de referência cruzada em documentos grandes.

var dest = doc.Destinations;
int pageNum = dest.GetPageNumber("section2");

Dicas e melhores práticas

  • Crie uma árvore de marcadores que reflita a hierarquia das seções do seu documento para navegação intuitiva.
  • Utilização: GoToAction com: FitType para controlar a forma como é exibida a página-alvo (largura de encaixe, página de ajustamento etc.).
  • Ações nomeadas são dependentes do espectador aderir aos nomes padrão (NextPage, PrevPagina, Primeira Página e Última página).
  • Para ligações entre documentos, utilizar: GoToRemoteAction Em vez de URI ações apontando para arquivos PDF.
  • Coleções de ação em uma página permitem que você adicione várias ações que disparam na página aberta.

Problemas comuns

EmissãoCausa da morteCorreção
Bookmark não navegaAcção não definida na rubrica de esboçoAcompanhar um GoToAction a) para o OutlineItemCollection.Action
GoTo ação alvos página erradaO índice de página é baseado internamente em 0 mas as páginas são baseadas em 1Utilização: doc.Pages[n] diretamente no constructor GoToAction
Ação denominada não tem efeitoVisualizar não suporta a acção nomeadaUsar apenas nomes padrão

FAQ

Como faço para criar uma tabela de conteúdos?

Criar OutlineItemCollection As inscrições para cada secção, com um número de pontos. GoToAction A segmentar a primeira página da secção.

Posso colocar as marcas?

Sim, adicione criança. OutlineItemCollection entradas para um marcador principal a criar um esboço hierárquico.

Que tipos de ajustes estão disponíveis para ações GoTo?

Fit, FitH (largura do ajuste), FitV (altura do Ajuste) e FitB.


Resumo de referência da API

Classe / MétodoDescrição:
OutlineCollectionColeção de marcadores do nível superior no documento
OutlineItemCollectionEntrada única de marcador com título e ação
GoToActionNavegue para uma página dentro do mesmo documento
GoToRemoteActionNavegue para uma página em um PDF externo
LaunchActionAbrir um arquivo externo
NamedActionAtivar um comando de visualização predefinido
PdfAction.CreateGoToFábrica para acções do Governo da União Europeia
PdfAction.CreateNamedFábrica para ações denominadas
ActionCollectionColeção de ações numa página ou anotação
DestinationCollectionRegisto de destino designado
ActionTypeEnumeration: GoTo, URI, JavaScript, Nomeado, Lançamento

Ver também:

 Português