RepositoryItemColorEdit.ColorAlignment Property

Specifies the alignment of the preview color box within the control’s edit region.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v19.2.dll

Declaration

C#

[DXCategory("Behavior")]
[DefaultValue(HorzAlignment.Near)]
public HorzAlignment ColorAlignment { get; set; }

VB.NET

<DXCategory("Behavior")>
<DefaultValue(HorzAlignment.Near)>
Public Property ColorAlignment As HorzAlignment

Property Value

Type	Default	Description
HorzAlignment	**Near**	A HorzAlignment value specifying the alignment of the preview color box within the control’s edit region.

Available values:

Name	Description
Default	Places an object or text at the default position, which is determined by a control.
Near	Places an object/text at a near position.
Center	Centers an object or text within a region.
Far	Places an object/text at a far position.

Remarks

The ColorAlignment property controls the alignment of the preview color box and text within the control’s edit region. You can align the color box to the left, right or center it. If the color box is centered, the color text is not displayed.

The following table shows how ColorAlignment affects the edit box.

ColorAlignment value	Image
HorzAlignment.Default	The color box is not displayed. The color text is aligned to the left.
HorzAlignment.Near	The color box and text are aligned to the left.
HorzAlignment.Center	Only the color box is displayed and it is centered within the edit box.
HorzAlignment.Far	The color box is aligned to the right and the color text is aligned to the left.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ColorAlignment 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#

colorpickedit-how-to-modify-boundaries-of-the-color-box-that-shows-the-selected-color-t121728/CS/WindowsFormsApplication475/MyColorEditViewInfo.cs#L18

fColorTextRect = MaskBoxRect;
if (Item.ColorAlignment == HorzAlignment.Default) return;
fColorBoxRect = Rectangle.Inflate(MaskBoxRect, 0, 0);

how-to-provide-in-place-editors-for-row-headers-in-a-vertical-grid-t244577/CS/S170863/Form1.cs#L29

new RowInplaceEditorHelper(vGridControl1.GetRowByFieldName("Name"), riColorEdit);
riColorEdit.ColorAlignment = HorzAlignment.Center;
riColorEdit.EditValueChanged += riColorEdit_EditValueChanged;

how-to-provide-in-place-editors-for-row-headers-in-the-vertical-grid-t493645/CS/S170863/Form1.cs#L20

new RowInplaceEditorHelper(vGridControl1.GetRowByFieldName("Name"), riColorEdit);
riColorEdit.ColorAlignment = HorzAlignment.Center;
riColorEdit.EditValueChanged += riColorEdit_EditValueChanged;

VB.NET

colorpickedit-how-to-modify-boundaries-of-the-color-box-that-shows-the-selected-color-t121728/VB/WindowsFormsApplication475/MyColorEditViewInfo.vb#L20

fColorTextRect = MaskBoxRect
If Item.ColorAlignment = HorzAlignment.Default Then
    Return

how-to-provide-in-place-editors-for-row-headers-in-a-vertical-grid-t244577/VB/S170863/Form1.vb#L31

Dim TempRowInplaceEditorHelper1 As RowInplaceEditorHelper = New RowInplaceEditorHelper(vGridControl1.GetRowByFieldName("Name"), riColorEdit)
riColorEdit.ColorAlignment = HorzAlignment.Center
AddHandler riColorEdit.EditValueChanged, AddressOf riColorEdit_EditValueChanged

how-to-provide-in-place-editors-for-row-headers-in-the-vertical-grid-t493645/VB/S170863/Form1.vb#L18

Dim TempRowInplaceEditorHelper2 As RowInplaceEditorHelper = New RowInplaceEditorHelper(vGridControl1.GetRowByFieldName("Name"), riColorEdit)
riColorEdit.ColorAlignment = HorzAlignment.Center
AddHandler riColorEdit.EditValueChanged, AddressOf riColorEdit_EditValueChanged