MagnifierDialog.ShowDialog(IWin32Window, Single, Boolean, Boolean, ColorFormat, Boolean, Boolean) Method

Displays the MagnifierDialog with custom parameters.

Assembly : DevExpress.Utils.v25.2.dll

NuGet Packages : DevExpress.Utils, DevExpress.Wpf.Core

Declaration

C#
VB.NET

csharp

public static MagnifierDialogResult ShowDialog(
    IWin32Window owner,
    float initialZoomFactor,
    bool closeOnMouseClick,
    bool pickColorToClipboard,
    ColorFormat colorFormat,
    bool showPixelGrid,
    bool showColors
)

Public Shared Function ShowDialog(
    owner As IWin32Window,
    initialZoomFactor As Single,
    closeOnMouseClick As Boolean,
    pickColorToClipboard As Boolean,
    colorFormat As ColorFormat,
    showPixelGrid As Boolean,
    showColors As Boolean
) As MagnifierDialogResult

Parameters

Name	Type	Description
owner	IWin32Window

A form that owns this dialog.

| | initialZoomFactor | Single |

The initial zoom ratio.

| | closeOnMouseClick | Boolean |

true if the dialog should close when a user clicks the left mouse button, false if left clicks should not close the dialog. In the latter case, a user should press Esc to hide the magnifier.

| | pickColorToClipboard | Boolean |

Specifies whether a color under the magnifier crosshair should be copied to the clipboard when a user clicks the left mouse button.

| | colorFormat | DevExpress.Utils.ColorFormat |

Specifies whether the magnifier should store clicked colors as Hexadecimal or ARGB values.

| | showPixelGrid | Boolean |

true to show a pixel grid inside the magnifier; otherwise, false.

| | showColors | Boolean |

Specifies whether the magnifier should display the previously clicked and currently hovered colors in its upper right corner.

Returns

Type	Description
MagnifierDialogResult

A structure that stores the last remembered magnifier zoom level and colors selected by a user.