TdxBasePreviewOptions.VisibleOptions Property

Specifies UI element visibility flags in the Print Preview dialog.

Declaration

property VisibleOptions: TdxPreviewVisibleOptions read; write; default dxDefaultPreviewVisibleOptions;

Property Value

Type	Default	Description
TdxPreviewVisibleOptions	dxDefaultPreviewVisibleOptions	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 Visibility Flags

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

pvoHelp

The Print Preview dialog displays all UI elements associated with the Help user command.

This flag affects only Standard and Advanced window styles. The Print Preview dialog always displays the Help command in the Ribbon UI.

pvoPageBackground

All UI elements associated with page background customization are visible.

pvoPageSetup

All UI elements associated with the Page Setup dialog are visible.

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

pvoPreferences

All UI elements associated with Print Preview dialog customization are visible.

pvoPrint

All print-related UI elements are visible.

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

pvoReportDesign

All UI elements associated with the Report Designer dialog are visible.

Note

The Report Designer dialog is available only for the report links that register corresponding dialog form classes.

pvoPrintStyles

All UI elements associated with print style customization are visible.

This flag has no effect if the pvoPageSetup flag is not set.

pvoReportFileOperations

All UI elements that correspond to report file management are visible.

If this flag is set, users can load, save, and clear the report displayed in the Print Preview dialog.

pvoPageMargins

The Print Preview dialog can display page margins in a report.

The View | Margins command allows users to hide or display page margins.

pvoPrintDialog

All UI elements associated with the Print Dialog functionality are visible if the pvoPrint 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 VisibleOptions property’s default value is the dxDefaultPreviewVisibleOptions global constant.