ImageLocation Enum

Enumerates possible locations for an image within a control.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v18.1.dll

Declaration

C#

public enum ImageLocation

VB.NET

Public Enum ImageLocation

Members

Name	Description
Default	The same as MiddleLeft.
TopCenter	The image is vertically aligned at the top, and horizontally aligned in the center.
TopLeft	The image is vertically aligned at the top, and horizontally aligned on the left.
TopRight	The image is vertically aligned at the top, and horizontally aligned on the right.
MiddleCenter	The image is centered vertically and horizontally. The control’s text is not displayed in this mode.
MiddleLeft	The image is vertically centered, and horizontally aligned on the left.
MiddleRight	The image is vertically centered, and horizontally aligned on the right.
BottomCenter	The image is vertically aligned at the bottom, and horizontally aligned in the center.
BottomLeft	The image is vertically aligned at the bottom, and horizontally aligned on the left.
BottomRight	The image is vertically aligned at the bottom, and horizontally aligned on the right.

Related API Members

The following properties accept/return ImageLocation values:

• EditorButton.ImageLocation
• SimpleButton.ImageLocation

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ImageLocation enum.

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#

how-to-make-the-buttonedits-buttons-work-as-check-buttons-e1931/CS/Form1.cs#L146

this.repositoryItemMyButtonEdit1.Buttons.AddRange(new DevExpress.XtraEditors.Controls.EditorButton[] {
new DevExpress.XtraEditors.Controls.EditorButton(DevExpress.XtraEditors.Controls.ButtonPredefines.Glyph, "Button", -1, true, true, false, DevExpress.XtraEditors.ImageLocation.MiddleCenter, null, new DevExpress.Utils.KeyShortcut(System.Windows.Forms.Keys.None), serializableAppearanceObject1, "", null, null, true)});
this.repositoryItemMyButtonEdit1.CheckedChar = '1';

how-to-prevent-buttonedits-buttons-from-filling-the-entire-editors-height-e2174/CS/CS/Form1.cs#L107

new DevExpress.XtraEditors.Controls.EditorButton(),
new DevExpress.XtraEditors.Controls.EditorButton(DevExpress.XtraEditors.Controls.ButtonPredefines.Glyph, "", -1, true, true, true, DevExpress.XtraEditors.ImageLocation.MiddleCenter, ((System.Drawing.Image)(resources.GetObject("myButtonEdit4.Properties.Buttons"))), new DevExpress.Utils.KeyShortcut(System.Windows.Forms.Keys.None), serializableAppearanceObject1, "", null, null, true)});
this.myButtonEdit4.Properties.ButtonsAlignment = DevExpress.Utils.VertAlignment.Bottom;

how-to-add-a-custom-drawbutton-event-for-buttonedit-e4089/CS/CustomDrawButtonEvent/DrawButtonEventArgs.cs#L51

    public ButtonPredefines Kind { get { return info.Button.Kind; } }
    public ImageLocation ImageLocation { get { return info.Button.ImageLocation; } }
}

how-to-display-a-context-menu-when-a-buttonedits-button-is-clicked-e818/CS/Form1.cs#L142

new DevExpress.XtraEditors.Controls.EditorButton(),
new DevExpress.XtraEditors.Controls.EditorButton(DevExpress.XtraEditors.Controls.ButtonPredefines.Combo, "", -1, true, true, false, DevExpress.XtraEditors.ImageLocation.MiddleCenter, null, new DevExpress.Utils.KeyShortcut(System.Windows.Forms.Keys.None), serializableAppearanceObject1, "Click to open a context menu", null, null, true)});
this.repositoryItemButtonEdit1.Name = "repositoryItemButtonEdit1";

gridview-how-to-add-a-custom-button-to-the-filterpanel-t375271/CS/Form1.cs#L30

b.Image = Image.FromFile(Directory.GetParent(Directory.GetCurrentDirectory()).Parent.FullName + @"\Filter_16x16.png");
b.ImageLocation = DevExpress.XtraEditors.ImageLocation.MiddleLeft;
customGridView1.AddButton(b);

VB.NET

how-to-make-the-buttonedits-buttons-work-as-check-buttons-e1931/VB/Form1.vb#L127

Me.repositoryItemMyButtonEdit1.AutoHeight = False
Me.repositoryItemMyButtonEdit1.Buttons.AddRange(New DevExpress.XtraEditors.Controls.EditorButton() {New DevExpress.XtraEditors.Controls.EditorButton(DevExpress.XtraEditors.Controls.ButtonPredefines.Glyph, "Test", -1, True, True, False, DevExpress.XtraEditors.ImageLocation.MiddleCenter, Nothing, New DevExpress.Utils.KeyShortcut(System.Windows.Forms.Keys.None), SerializableAppearanceObject1, "", Nothing, Nothing)})
Me.repositoryItemMyButtonEdit1.CheckedChar = Global.Microsoft.VisualBasic.ChrW(49)

how-to-prevent-buttonedits-buttons-from-filling-the-entire-editors-height-e2174/VB/VB/Form1.vb#L98

Me.myButtonEdit4.Properties.Appearance.Options.UseFont = True
Me.myButtonEdit4.Properties.Buttons.AddRange(New DevExpress.XtraEditors.Controls.EditorButton() { New DevExpress.XtraEditors.Controls.EditorButton(), New DevExpress.XtraEditors.Controls.EditorButton(DevExpress.XtraEditors.Controls.ButtonPredefines.Glyph, "", -1, True, True, True, DevExpress.XtraEditors.ImageLocation.MiddleCenter, (CType(resources.GetObject("myButtonEdit4.Properties.Buttons"), System.Drawing.Image)), New DevExpress.Utils.KeyShortcut(System.Windows.Forms.Keys.None), serializableAppearanceObject1, "", Nothing, Nothing, True)})
Me.myButtonEdit4.Properties.ButtonsAlignment = DevExpress.Utils.VertAlignment.Bottom

how-to-add-a-custom-drawbutton-event-for-buttonedit-e4089/VB/CustomDrawButtonEvent/DrawButtonEventArgs.vb#L85

End Property
Public ReadOnly Property ImageLocation() As ImageLocation
    Get

how-to-display-a-context-menu-when-a-buttonedits-button-is-clicked-e818/VB/Form1.vb#L131

Me.repositoryItemButtonEdit1.AutoHeight = False
Me.repositoryItemButtonEdit1.Buttons.AddRange(New DevExpress.XtraEditors.Controls.EditorButton() { New DevExpress.XtraEditors.Controls.EditorButton(), New DevExpress.XtraEditors.Controls.EditorButton(DevExpress.XtraEditors.Controls.ButtonPredefines.Combo, "", -1, True, True, False, DevExpress.XtraEditors.ImageLocation.MiddleCenter, Nothing, New DevExpress.Utils.KeyShortcut(System.Windows.Forms.Keys.None), serializableAppearanceObject1, "Click to open a context menu", Nothing, Nothing, True)})
Me.repositoryItemButtonEdit1.Name = "repositoryItemButtonEdit1"

gridview-how-to-add-a-custom-button-to-the-filterpanel-t375271/VB/Form1.vb#L28

b.Image = Image.FromFile(Directory.GetParent(Directory.GetCurrentDirectory()).Parent.FullName & "\Filter_16x16.png")
b.ImageLocation = DevExpress.XtraEditors.ImageLocation.MiddleLeft
customGridView1.AddButton(b)