SimpleButton.ShowFocusRectangle Property

Gets or sets whether the dotted focus rectangle is displayed within the SimpleButton when it has focus.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Appearance")]
public DefaultBoolean ShowFocusRectangle { get; set; }

VB.NET

<DXCategory("Appearance")>
<DefaultValue(DefaultBoolean.Default)>
Public Property ShowFocusRectangle As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	The DefaultBoolean value that specifies whether the dotted focus rectangle is displayed within the SimpleButton when it has focus.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Remarks

A focused SimpleButton can be displayed with or without the dotted focus rectangle. By default, the dotted focus rectangle is displayed when the SimpleButton is focused. Set the ShowFocusRectangle property to DefaultBoolean.False to display the focused SimpleButton without the dotted focus rectangle. In the following images, the SimpleButton is displayed with and without the dotted focus rectangle accordingly.

You can also specify whether the SimpleButton can be focused via the SimpleButton.AllowFocus property.