Skip to main content

RepositoryItemPictureEdit.AllowFocused Property

Gets or sets a value specifying whether a focus rectangle is displayed within the focused picture editor.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v24.2.dll

Declaration

[DefaultValue(true)]
[DXCategory("Appearance")]
public override bool AllowFocused { get; set; }

Property Value

Type Default Description
Boolean true

true if a focus rectangle is displayed in the focused picture editor; otherwise, false.

Remarks

Use the AllowFocused property to control whether a focused picture editor should display a focus rectangle.

If this property is true (the default behavior), a focus rectangle is drawn close to the client region’s border. The image below shows the effect of AllowFocusedon a focused picture editor.

PictureEdit_AllowFocused.gif

Users can focus a picture edit by clicking it with the mouse or by tabbing to it through the tab order. For the latter functionality to be available, the editor must be included in the tab order (i.e. the PictureEdit.TabStop property is true and the TabIndex is set to a non-negative integer), and its Visible and RepositoryItem.Enabled properties must both be set to true.

Changing the value of this property at runtime raises the RepositoryItem.PropertiesChanged event.

Note

This property is in effect only when the editor is in stand-alone mode. When used for in-place editing in data-aware controls (Data Grid, Vertical Grid, Tree List, etc.), this property is ignored and you should use related settings of the data-aware control instead (e.g., the TreeListOptionsView.ShowFocusedFrame property).

See Also