Back to Devexpress

CommandVisibility Enum

corelibraries-devexpress-dot-xtraprinting-e52e3917.md

latest4.1 KB
Original Source

CommandVisibility Enum

Specifies the visibility levels for the printing system commands.

Namespace : DevExpress.XtraPrinting

Assembly : DevExpress.Printing.v25.2.Core.dll

NuGet Package : DevExpress.Printing.Core

Declaration

csharp
public enum CommandVisibility
vb
Public Enum CommandVisibility

Members

NameDescription
None

Both the command’s toolbar button and menu item are invisible.

| | Menu |

Deprecated; use CommandVisibility All instead. Both the command’s toolbar item and menu item are visible.

| | Toolbar |

Deprecated; use CommandVisibility All instead. Both the command’s toolbar item and menu item are visible.

| | All |

Both the command’s toolbar item and menu item are visible.

|

Remarks

This enumeration’s members are used to specify the visibility level for the printing system commands via the PrintingSystemBase.SetCommandVisibility method. A list of all the printing system commands is provided by the PrintingSystemCommand enumeration.

Example

This example illustrates how to change the visibility of the toolbar buttons and menu items of a print preview by using the PrintingSystemBase.SetCommandVisibility method that defines the availability of commands in print preview.

The following code hides the Watermark button from the toolbar (together with the corresponding menu item), makes the DocumentMap button and menu item visible, and then makes the ExportToCsv and ExportToTxt commands visible (in both the window’s menu, and in the toolbar).

All available commands are listed in the PrintingSystemCommand enumeration.

csharp
using DevExpress.XtraPrinting;
// ...

// Get the printing system of the DocumentViewer control.
PrintingSystemBase ps = documentViewer1.PrintingSystem;

// Hide the Watermark toolbar button, and also the Watermark menu item.
if (ps.GetCommandVisibility(PrintingSystemCommand.Watermark) != CommandVisibility.None){
   ps.SetCommandVisibility(PrintingSystemCommand.Watermark, CommandVisibility.None);
}

// Show the Document Map toolbar button and menu item.
ps.SetCommandVisibility(PrintingSystemCommand.DocumentMap, CommandVisibility.All);

// Make the "Export to Csv" and "Export to Txt" commands visible.
ps.SetCommandVisibility(new PrintingSystemCommand[] 
   {PrintingSystemCommand.ExportCsv, PrintingSystemCommand.ExportTxt}, CommandVisibility.All);
vb
Imports DevExpress.XtraPrinting
' ...

' Get the printing system of the DocumentViewer control.
Dim ps As PrintingSystemBase = documentViewer1.PrintingSystem

' Hide the Watermark toolbar button, and also the Watermark menu item.
If ps.GetCommandVisibility(PrintingSystemCommand.Watermark) <> CommandVisibility.None Then
   ps.SetCommandVisibility(PrintingSystemCommand.Watermark, CommandVisibility.None)
End If

' Show the Document Map toolbar button and menu item.
ps.SetCommandVisibility(PrintingSystemCommand.DocumentMap, CommandVisibility.All)

' Make the "Export to Csv" and "Export to Txt" commands visible.
ps.SetCommandVisibility(New PrintingSystemCommand() _
  {PrintingSystemCommand.ExportCsv, PrintingSystemCommand.ExportTxt}, CommandVisibility.All)

See Also

SetCommandVisibility

DevExpress.XtraPrinting Namespace