TileItem.SetContent(TileItemFrame, Boolean) Method

Forces the current tile item to display a specific TileItemFrame.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v19.2.dll

Declaration

C#

public virtual void SetContent(
    TileItemFrame frame,
    bool animated
)

VB.NET

Public Overridable Sub SetContent(
    frame As TileItemFrame,
    animated As Boolean
)

Parameters

Name	Type	Description
frame	TileItemFrame	A TileItemFrame to be displayed.
animated	Boolean	A Boolean value indicating whether the frame should be displayed using the frame animation.

Remarks

TileItems support frame animation. See the Tile Animation topic to learn more.

The SetContent method allows you to display any TileItemFrame as the current tile item’s content. The frame to be displayed doesn’t need to be a member of the current tile item’s TileItem.Frames collection. This allows you to display custom frames or frames used within other tile items.

Note

Notice that calling the SetContent method to display a frame within an animated TileItem doesn’t break its own animation consequence. When the time specified via the TileItem.FrameAnimationInterval or the TileItemFrame.Interval property elapses, frame change will occur according to the original tile item’s animation cycle. Use the TileControl.SuspendAnimation method to temporarily pause item animation.

The SetContent method can be used to set the content of both static and animated tile items.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SetContent(TileItemFrame, Boolean) method.

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-animate-tile-frames-on-hovering-over-with-the-mouse-t549254/CS/FrameHoverHelper.cs#L35

if (value != null && IsTileValidForAnimation(value))
    value.SetContent(value.Frames[1], true);
if (_HoveredItem != null && IsTileValidForAnimation(_HoveredItem))

VB.NET

how-to-animate-tile-frames-on-hovering-over-with-the-mouse-t549254/VB/FrameHoverHelper.vb#L37

If value IsNot Nothing AndAlso IsTileValidForAnimation(value) Then
    value.SetContent(value.Frames(1), True)
End If