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:
GoToActioncom:FitTypepara 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:
GoToRemoteActionEm 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ão | Causa da morte | Correção |
|---|---|---|
| Bookmark não navega | Acção não definida na rubrica de esboço | Acompanhar um GoToAction a) para o OutlineItemCollection.Action |
| GoTo ação alvos página errada | O índice de página é baseado internamente em 0 mas as páginas são baseadas em 1 | Utilização: doc.Pages[n] diretamente no constructor GoToAction |
| Ação denominada não tem efeito | Visualizar não suporta a acção nomeada | Usar 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étodo | Descrição: |
|---|---|
OutlineCollection | Coleção de marcadores do nível superior no documento |
OutlineItemCollection | Entrada única de marcador com título e ação |
GoToAction | Navegue para uma página dentro do mesmo documento |
GoToRemoteAction | Navegue para uma página em um PDF externo |
LaunchAction | Abrir um arquivo externo |
NamedAction | Ativar um comando de visualização predefinido |
PdfAction.CreateGoTo | Fábrica para acções do Governo da União Europeia |
PdfAction.CreateNamed | Fábrica para ações denominadas |
ActionCollection | Coleção de ações numa página ou anotação |
DestinationCollection | Registo de destino designado |
ActionType | Enumeration: GoTo, URI, JavaScript, Nomeado, Lançamento |