TileControl.ItemBackgroundImageAlignment Property
Gets or sets the background image position for all TileItems within the current TileControl.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.XtraEditors.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[DefaultValue(TileItemContentAlignment.Default)]
[DXCategory("Appearance")]
public TileItemContentAlignment ItemBackgroundImageAlignment { get; set; }
Property Value
Type | Default | Description |
---|---|---|
TileItemContentAlignment | Default | A TileItemContentAlignment enumerator value that specifies the background image position for all TileItems within the current TileControl. |
Available values:
Name | Description |
---|---|
Default | Default content alignment. |
TopLeft | Content appears vertically aligned on the top, and horizontally aligned on the left. |
TopCenter | Content appears vertically aligned on the top, and horizontally aligned at the center. |
TopRight | Content appears vertically aligned on the top, and horizontally aligned on the right. |
MiddleLeft | Content appears vertically aligned at the center, and horizontally aligned on the left. |
MiddleCenter | Content is horizontally and vertically aligned at the center. |
MiddleRight | Content appears vertically aligned at the center, and horizontally aligned on the right. |
BottomLeft | Content appears vertically aligned at the bottom, and horizontally aligned on the left. |
BottomCenter | Content appears vertically aligned at the bottom, and horizontally aligned at the center. |
BottomRight | Content appears vertically aligned at the bottom, and horizontally aligned on the right. |
Manual | Indicates that manual text alignment, based on the TileItemElement.TextLocation coordinates, should be used. |
Remarks
Tiles’ background image is specified via the TileItem.BackgroundImage property. The ItemBackgroundImageAlignment property specifies the alignment of background images common to all TileItems within the current tile control. Use the TileItem.BackgroundImageAlignment property to override these default settings for individual tiles.
Besides the alignment, you can also specify the background image’s stretch mode via the TileControl.ItemBackgroundImageScaleMode property. See the Tile Item Structure topic to learn more.