PdfGraphics.AddLinkToPage(RectangleF, Int32, Single) Method

Adds a link that refers to the document page with the specified number and zoom factor.

Namespace: DevExpress.Pdf

Assembly: DevExpress.Pdf.v21.1.Drawing.dll

NuGet Package: DevExpress.Pdf.Drawing

Declaration

C#

public void AddLinkToPage(
    RectangleF linkArea,
    int pageNumber,
    float zoom
)

VB.NET

Public Sub AddLinkToPage(
    linkArea As RectangleF,
    pageNumber As Integer,
    zoom As Single
)

Parameters

Name	Type	Description
linkArea	RectangleF	A page area (in the world coordinate system) where you can add a link.
pageNumber	Int32	The target page number.
zoom	Single	A zoom factor by which the document is scaled after you click a link.

Remarks

This method specifies the page area on which you can click to refer to the document page defined by the pageNumber parameter. After you click the added link, the target page is scaled by the specified zoom factor.

To draw a link on the PDF page, use one of the following methods:

PdfGraphics.AddToPageForeground, PdfGraphics.AddToPageBackground

These methods allow you to draw content on an existing page.

PdfDocumentProcessor.RenderNewPage

Draws content on a new page.

The code sample below adds a link that refers to the second document page and scales this page by 300%.

View Example

Program.cs

using System;
using DevExpress.Pdf;
using System.Drawing;
//...

using (PdfDocumentProcessor processor = new PdfDocumentProcessor())
{
    // Create an empty document.
    processor.CreateEmptyDocument("..\\..\\Result.pdf");

    // Create and draw graphics.
    using (PdfGraphics graphics = processor.CreateGraphics())
    {
        // Draw a link text.
        SolidBrush black = (SolidBrush)Brushes.Black;
        using (Font font = new Font("Times New Roman", 32, FontStyle.Bold))
        {
            graphics.DrawString("PDF Document API", font, black, 180, 150);
        }

        // Create a link to the second document page.
        graphics.AddLinkToPage(new RectangleF(180, 160, 480, 30), 2, 3);

        // Render a page with graphics.
        processor.RenderNewPage(PdfPaperSize.Letter, graphics);

        // Create the second document page to which the link refers.
        processor.AddNewPage(PdfPaperSize.A4);
    }
}

Program.vb

Imports System
Imports DevExpress.Pdf
Imports System.Drawing
'...

Using processor As PdfDocumentProcessor = New PdfDocumentProcessor()
    ' Create an empty document.
    processor.CreateEmptyDocument("..\..\Result.pdf")
    ' Create and draw graphics.
    Using graphics As PdfGraphics = processor.CreateGraphics()        

        ' Draw a link text.
        Dim black As SolidBrush = CType(Brushes.Black, SolidBrush)
        Using font As Font = New Font("Times New Roman", 32, FontStyle.Bold)
            graphics.DrawString("PDF Document API", font, black, 180, 150)
        End Using

        ' Create a link to the second document page.
        graphics.AddLinkToPage(New RectangleF(180, 160, 480, 30), 2, 3)

        ' Render a page with graphics.
        processor.RenderNewPage(PdfPaperSize.Letter, graphics)

        ' Create the second document page to which the link refers.
        processor.AddNewPage(PdfPaperSize.A4)
    End Using
End Using