Coordinate Systems

  • 2 minutes to read

The PDF Viewer for WPF uses the following coordinate systems:

Client Coordinate System

The PDF Viewer control uses the client coordinates (measured in pixels) to specify the points' position. This coordinate system’s starting point is at the top-left corner of the PDF Viewer's client area. Refer to the Windows Forms Coordinates article for more details.

IMAGE

Page Coordinate System

The page coordinate system's starting point (0,0) is the left-bottom corner of a page. The Y axis is directed from the bottom of the page to the top.

IMAGE

The page coordinate system uses points (1/72 of an inch) as a measurement unit.

Use Coordinate Systems in API

The table below lists methods that work with client and page coordinates, and methods used to convert one coordinate type into another.

Use Client Coordinates

Use Page Coordinates

Convert Coordinates

PdfViewerControl.HitTest

PdfViewerControl.SelectWord

PdfViewerControl.Select

PdfViewerControl.GetText

PdfViewerControl.ConvertDocumentPositionToPixel

PdfViewerControl.ConvertPixelToDocumentPosition

Convert client coordinates to page coordinates when you need to determine what page was clicked in a document. Refer to the How to: Determine the Page Number of a Clicked Page example for more information.

TIP

You can use the PdfViewerControl.HitTest method to convert between client coordinates to page coordinates. This method returns an PdfHitTestResult object. Check the PdfHitTestResult.DocumentPosition property to obtain the page coordinates and the page number of a hit point.