TdxBasePreviewOptions.EnableOptions Property

Specifies UI element availability flags in the Print Preview dialog.

Declaration

property EnableOptions: TdxPreviewEnableOptions read; write; default dxDefaultPreviewEnableOptions;

Property Value

Type	Default	Description
TdxPreviewEnableOptions	dxDefaultPreviewEnableOptions	The set of flags that correspond to individual user commands in the Print Preview dialog.

Remarks

Use EnableOptions and VisibleOptions properties to specify what user commands are visible and available to users in the Print Preview dialog.

Preview Command Availability Flags

The EnableOptions property value can include any number of the following flags in any combination:

peoCanChangeMargins

Users can change page margins in the Print Preview dialog.

peoHelp

Users can display offline documentation for the Print Preview dialog.

The dialog’s PreviewOptions.HelpFile property specifies the name of the required Help file.

peoPageBackground

Users can customize page background fill settings.

peoPageSetup

Users can invoke the Page Setup dialog in the Print Preview dialog.

peoPreferences

Users can invoke the Options dialog to customize the Print Preview dialog.

peoPrint

All UI elements associated with the Print command and the corresponding dialog are enabled.

If this flag is not set, the peoPrintDialog flag has no effect.

peoReportDesign

Users can invoke the Report Designer dialog if it is available for the current report link.

peoPrintDialog

Users can invoke the Print dialog if the peoPrint flag is set.

Code Example

The following code example displays the Help command and disables the Page Setup command in the Print Preview dialog:

Delphi

var
  APreviewOptions: TdxPreviewOptions;
begin
  APreviewOptions := dxComponentPrinter1.PreviewOptions;
  APreviewOptions.EnableOptions := APreviewOptions.EnableOptions - [peoPageSetup];
  APreviewOptions.EnableOptions := APreviewOptions.EnableOptions + [peoHelp];
  APreviewOptions.VisibleOptions := APreviewOptions.VisibleOptions + [pvoHelp];
end;

C++

  TdxPreviewOptions *APreviewOptions;
  // ...
  APreviewOptions = dxComponentPrinter1->PreviewOptions;
  APreviewOptions->EnableOptions = TdxPreviewEnableOptions() << peoCanChangeMargins << peoPageBackground <<
       peoPreferences << peoPrint << peoReportDesign << peoPrintDialog << peoHelp;
  APreviewOptions->VisibleOptions = TdxPreviewVisibleOptions() << dxDefaultPreviewVisibleOptions << pvoHelp;

Default Value

The EnableOptions property’s default value is the dxDefaultPreviewEnableOptions global constant.