Coordinate System
DynamicPDF Core Suite for .NET uses a points based coordinate system. An inch equals 72 points and there are 28.35 points in a centimeter.
- 1 point = 1/72 inch = 0.353 mm
- 18 points = 1/4 inch
- 72 points = 1 inch
- 28.35 points = 1 centimeter
- 12 points = 1 pica = 1/6 inch
A page has a width, height, and four margins (top, bottom, left, right) and are specified as parameters in a Page constructor. You can use predefined values from the PageSize and PageOrientation enumerations or specify custom width and height values. After creating a page, its dimensions can be modified through the page's Dimensions property.
When adding page elements to a page, you must set the page's coordinate properties. Measure these values from the upper left margin of the page. Measure the X properties from the left margin and measure the Y properties from the top margin.
Use the LayoutGrid page element to display a grid on a page which is useful when placing page elements on the page.
NOTE: Although you can simply swap width and height for landscape pages (792 width, 612 height), you can also use the PageOrientation.Landscape property to set a page's dimensions. The following example illustrates using the Landscape property.
ceTe.DynamicPDF.Page page = new ceTe.DynamicPDF.Page(PageSize.Letter, PageOrientation.Landscape, 54.0f);
Dim MyPage As ceTe.DynamicPDF.Page = New ceTe.DynamicPDF.Page(PageSize.Letter, PageOrientation.Landscape, 54.0f)