[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Collapse]PDF Viewer
   [Expand]Getting Started
    Coordinate Systems
   [Expand]Access and Edit Document Content
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Coordinate Systems

This document describes the coordinate systems the PDF Viewer uses.

Expanded Client Coordinate System

Points' position in the PDF Viewer control is specified using the client coordinates (measured in pixels). The client coordinate system’s origin is at the top-left corner of the PDF Viewer's client area. See Windows Forms Coordinates for more details.

The dimensions of the client area are described by a System.Drawing.RectangleF structure that contains client coordinates for the area.

Expanded Page Coordinate System

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

The PDF Viewer's pages are measured in points (1/72 of an inch).

Expanded Using Coordinate System in API

The following methods use client coordinates:

The page coordinates are used in the following methods:

Expanded Coordinate Transformations

The PDF Viewer provides the following methods to convert client coordinates to page coordinates and vice versa:

The page coordinates should be transformed into client coordinates to perform some tasks with the PDF Viewer, for example, draw custom graphics on the Control.Paint event in the PDF Viewer. See the How to: Custom Draw in the PDF Viewer example.

The conversion from client coordinates to page coordinates should be provided, for example, when you need to determine what page was clicked in a document. See the How to: Determine the Page Number of a Clicked PDF Page example.

Is this topic helpful?​​​​​​​