ChartOptionsPrint.PrintCrosshair Property

Gets or sets the value specifying whether to draw the crosshair when printing/exporting the chart.

Namespace: DevExpress.XtraCharts.Printing

Assembly: DevExpress.XtraCharts.v18.2.dll

Declaration

C#

[XtraSerializableProperty]
[TypeConverter(typeof(BooleanTypeConverter))]
public bool PrintCrosshair { get; set; }

VB.NET

<XtraSerializableProperty>
<TypeConverter(GetType(BooleanTypeConverter))>
Public Property PrintCrosshair As Boolean

Property Value

Type	Description
Boolean	true, if the crosshair should be printed/exported with a chart; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to PrintCrosshair
ChartControl	.OptionsPrint.PrintCrosshair

Remarks

Refer to the Print and Export help topic for more information on printing/exporting the chart.

Example

This example demonstrates how the Print and Export functionality relies upon the ChartOptionsPrint.PrintCrosshair property. The Ribbon control contains two items: the Show Print Preview button and the Print Crosshair check button. The Chart Control displays the Crosshair Cursor on mouse click. When the check button is checked, the Crosshair Cursor that the Chart Control currently shows will be printed:

Tip

This example is available on GitHub.

C#

private void OnChartControlMouseUp(object sender, MouseEventArgs e) {
    var diagram = (XYDiagram)chartControl.Diagram;
    diagram.ShowCrosshair(e.Location.X, e.Location.Y);
}

private void OnShowPrintPreviewItemClick(object sender, ItemClickEventArgs e) {
    chartControl.ShowPrintPreview();
}

private void OnPrintCrosshairItemClick(object sender, ItemClickEventArgs e) {
    chartControl.OptionsPrint.PrintCrosshair = bciPrintCrosshair.Checked;
}

VB.NET

Private Sub OnChartControlMouseUp(sender As Object, e As MouseEventArgs)
    var diagram = CType(chartControl.Diagram, XYDiagram)
    diagram.ShowCrosshair(e.Location.X, e.Location.Y)
End Sub

Private Sub OnShowPrintPreviewItemClick(sender As Object, e As ItemClickEventArgs)
    chartControl.ShowPrintPreview()
End Sub

Private Sub OnPrintCrosshairItemClick(sender As Object, e As ItemClickEventArgs)
    chartControl.OptionsPrint.PrintCrosshair = bciPrintCrosshair.Checked
End Sub

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the PrintCrosshair property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-charts-manage-crosshair-cursor-visibility-in-printed-chart/CS/PrintCrosshairSample/Form1.cs#L51

private void OnPrintCrosshairItemClick(object sender, ItemClickEventArgs e) {
    chartControl.OptionsPrint.PrintCrosshair = bciPrintCrosshair.Checked;
}

VB.NET

winforms-charts-manage-crosshair-cursor-visibility-in-printed-chart/VB/PrintCrosshairSample/Form1.vb#L54

Private Sub OnPrintCrosshairItemClick(ByVal sender As Object, ByVal e As ItemClickEventArgs) Handles bciPrintCrosshair.ItemClick
    chartControl.OptionsPrint.PrintCrosshair = bciPrintCrosshair.Checked
End Sub