PdfGraphics.AddLinkToPage(RectangleF, Int32) Method

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

Assembly : DevExpress.Pdf.v25.2.Drawing.dll

NuGet Package : DevExpress.Pdf.Drawing

Declaration

C#
VB.NET

csharp

public void AddLinkToPage(
    RectangleF linkArea,
    int pageNumber
)

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

Parameters

Name	Type	Description
linkArea	RectangleF

A page area (in world coordinate system) where you can add a link.

| | pageNumber | Int32 |

The page number.

Remarks

This method specifies the page area on which you can click to refer to the document page defined by the pageNumber parameter.

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

PdfGraphics.AddToPageForeground, PdfGraphics.AddToPageBackgroundThese methods allow you to draw content on an existing page.PdfDocumentProcessor.RenderNewPageDraws content on a new page.

Note

Coordinate system transformations (for example, system rotation) are not taken into account when the AddLinkToPage method is called.

the following code snippet adds a link to the second document page.

View Example

Program.cs
Program.vb

csharp

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

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

    // Create and draw graphics.
    using (PdfGraphics graphics = processor.CreateGraphicsPageSystem())
    {
        // Draw a link text.
        DXSolidBrush black = (DXSolidBrush)DXBrushes.Black;
        using (DXFont font = new DXFont("Times New Roman", 32, DXFontStyle.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);

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

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

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

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

        ' Draw a link text.
        Dim black As DXSolidBrush = CType(DXBrushes.Black, DXSolidBrush)
        Using font As DXFont = New DXFont("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)

        ' 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