Setting page characteristics

Setting the physical page size

• To set the physical rectangle, which represents the actual page size, you can instantiate the page description with a TGRect that specifies the size, or call TStandardPageDescription::SetPhysicalRect on your page description.

You can use the constants defined in TPageDescription to set standard page sizes.


// Create a page description with a custom page size
TStandardPageDescription    pageDescription(kCustom,

TGRect(TGPoint(0,0),TGPoint(298.370)));

//Change the physical rectangle to tabloid size (11 x 17)
pageDescription.SetPhysicalRect(TPageDescription::kTabloid);

• To set the printable rectangle, call TStandardPageDescription::SetPrintableRect on your page description.

  // Create a page description for a legal-size page
  TStandardPageDescription    pageDescription(kLegal, TPageDescription::kUSLegal);
  //Set the printable rectangle to be inset .5" from the edge of the page
  pageDescription.SetPrintableRect(
          TGRect(TPageDescription::kUSLegal)
          .Inset(TGPoint(0.5, 0.5)));

• To set the active rectangle, call TStandardPageDescription::SetActiveRectChoice on your page description.

  // Create a page description for a legal-size page
  TStandardPageDescription    pageDescription(kLegal, TPageDescription::kUSLegal);
  /// Set the active rectangle to be the printable rectangle
  pageDescription.SetActiveRectChoice(TPageDescription::ePrintableRect);

• To set the page orientation to portrait, call TStandardPageDescription::SetNarrow on your page description.

To set the page orientation to landscape, call TStandardPageDescription::SetWide on your page description.


// Create a page description for a legal-size page
TStandardPageDescription    pageDescription(kLegal, TPageDescription::kUSLegal);
// Set the page orientation to portrait
sample.SetNarrow();
// Set the page orientation to landscape
pageDescription.SetWide();

• To set the print media, adopt an instance of TPrintMedia that represents the media type you want to use.

  // Create a page description for a legal-size page
  
  TStandardPageDescription    pageDescription(kLegal, TPageDescription::kUSLegal);
  // Get a TPrintMedia* from a page description for legal-size paper, legalDescription
  TMediaType* legalPaper = legalDescription.GetPrintMedia;
  
  //Set the print media
  pageDescription.AdoptMedia(legalPaper);