PrintSettingsDialog
Represents an UI dialog for editing print settings.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
public class PrintSettingsDialog : RadForm, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, IComponentTreeHandler, ILayoutHandler, ISupportInitializeNotification, ISupportInitialize, INotifyPropertyChanged, IAnalyticsProvider, ISupportRootUIAutomation
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlFormRadFormControlBaseRadFormPrintSettingsDialog...
Derived Classes:
Implements:
Inherited Members
Constructors
Initializes the print-settings pages and subscribes to localization and theme changes.
public PrintSettingsDialog()
Initializes the dialog and loads settings from the supplied print document.
public PrintSettingsDialog(RadPrintDocument document)
The print document to configure.
Fields
Closes the dialog with a canceled result without applying the edited settings.
protected RadButton buttonCancel
Inserts the current-date token into the last-focused header or footer text box.
protected CommandBarButton buttonCurDate
Inserts the current-time token into the last-focused header or footer text box.
protected CommandBarButton buttonCurTime
Inserts the logo token into the last-focused header or footer text box.
protected CommandBarButton buttonLogo
Applies the edited settings and closes the dialog; its caption changes to Preview when preview is enabled.
protected RadButton buttonOK
Inserts the page-number token into the last-focused header or footer text box.
protected CommandBarButton buttonPageNum
Opens the system print dialog and prints the document with the edited settings when accepted.
protected RadButton buttonPrint
Inserts the total-page-count token into the last-focused header or footer text box.
protected CommandBarButton buttonTotalPages
Inserts the Windows user-name token into the last-focused header or footer text box.
protected CommandBarButton buttonUser
Controls whether the footer is reversed on even-numbered pages.
protected RadCheckBox checkBoxReverseFooter
Controls whether the header is reversed on even-numbered pages.
protected RadCheckBox checkBoxReverseHeader
Hosts the strip of header/footer token-insertion commands.
protected CommandBarRowElement commandBarRowElement1
Contains commands that insert print-document tokens into the last-focused header or footer text box.
protected RadCommandBar commandBarSnippets
Contains the buttons for inserting page, date, time, user, and logo tokens.
protected CommandBarStripElement commandBarStripElement1
Selects a paper source available from the document's printer settings.
protected RadDropDownList dropDownPageSource
Groups the four page-margin fields; values use inches or centimeters based on the current region.
protected RadGroupBox groupBoxMargins
Groups the portrait and landscape orientation options.
protected RadGroupBox groupBoxOrientation
Groups the paper type and source controls.
protected RadGroupBox groupBoxPage
Labels the bottom-margin field.
protected RadLabel labelBottomMargin
Labels the footer font control.
protected RadLabel labelFooter
Labels the header font control.
protected RadLabel labelHeader
Labels the left-margin field.
protected RadLabel labelLeftMargin
Labels the paper-source selector.
protected RadLabel labelPageSource
Labels the right-margin field.
protected RadLabel labelRightMargin
Labels the top-margin field.
protected RadLabel labelTopMargin
Lists available paper sizes from the document's printer settings, with dimensions in regional units.
protected RadListControl listBoxPaperType
Edits the bottom page margin in the current region's units.
protected RadMaskedEditBox maskBoxBottomMargin
Edits the left page margin in the current region's units.
protected RadMaskedEditBox maskBoxLeftMargin
Edits the right page margin in the current region's units.
protected RadMaskedEditBox maskBoxRightMargin
Edits the top page margin in the current region's units.
protected RadMaskedEditBox maskBoxTopMargin
Hosts the control-specific settings added by CreateFormatControl().
protected RadPageViewPage pageFormat
Contains the header and footer text, font, and even-page options.
protected RadPageViewPage pageHeaderFooter
Contains paper-size, paper-source, margin, and orientation settings.
protected RadPageViewPage pagePaper
Displays an orientation illustration that updates when the selected page orientation changes.
protected PictureBox pictureBoxOrientation
Selects landscape page orientation.
protected RadRadioButton radioButtonLandscape
Selects portrait page orientation.
protected RadRadioButton radioButtonPortrait
Hosts the format, paper, and header/footer settings pages.
protected RadPageView radPageView1
textBoxFooterCenterText
RadTextBox
Edits the centered footer text.
protected RadTextBox textBoxFooterCenterText
textBoxFooterLeftText
RadTextBox
Edits the left-aligned footer text.
protected RadTextBox textBoxFooterLeftText
textBoxFooterRightText
RadTextBox
Edits the right-aligned footer text.
protected RadTextBox textBoxFooterRightText
textBoxHeaderCenterText
RadTextBox
Edits the centered header text.
protected RadTextBox textBoxHeaderCenterText
textBoxHeaderLeftText
RadTextBox
Edits the left-aligned header text.
protected RadTextBox textBoxHeaderLeftText
textBoxHeaderRightText
RadTextBox
Edits the right-aligned header text.
protected RadTextBox textBoxHeaderRightText
Properties
Gets the page view control of the dialog.
public RadPageView PageView { get; }
The page view.
Gets the RadPrintDocument shown in this dialog.
public RadPrintDocument PrintDocument { get; set; }
If [true] a Preview button is shown, otherwise an OK button is shown.
public bool ShowPreviewButton { get; set; }
Methods
Saves all settings from the dialog into the RadPrintDocument.
protected virtual void ApplySettings()
Creates the specific control for editing the settings of the printed control.
protected virtual Control CreateFormatControl()
The that will be displayed on the first page of this dialog
Clean up any resources being used.
protected override void Dispose(bool disposing)
true if managed resources should be disposed; otherwise, false.
Overrides:
Loads the settings when the dialog is shown.
protected virtual void LoadSettings()
Applies the current printing-dialog localization provider to the dialog's labels and buttons.
protected virtual void LocalizeStrings()
Loads the document settings when available and selects the format page when that page is present.
Treats Escape as cancellation and closes the dialog; other keys use base processing.
Detaches the dialog from notifications that the current printing-dialog localization provider changed.
protected virtual void UnwireEvents()