LayoutViewInfoCustomizingEventArgs.ShouldRecalculateLayout Property

Forces layout recalculation after applying changes specified in the event handler.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v23.2.dll

NuGet Package: DevExpress.Win.Scheduler

Declaration

C#

public bool ShouldRecalculateLayout { get; set; }

VB.NET

Public Property ShouldRecalculateLayout As Boolean

Property Value

Type	Description
Boolean	True, to recalculate the layout to properly display modified visual elements; otherwise, false.

Remarks

Set the ShouldRecalculateLayout option to true to force layout recalculation, so that changes applied to the header in the SchedulerControl.LayoutViewInfoCustomizing event handler display correctly.

This setting is useful when certain changes, such as larger font or longer text, results in a header content that does not fit its previously calculated bounds.

Note

This setting affects only date and resource headers. Other visual elements layouts are not recalculated.

Example

This example handles the SchedulerControl.LayoutViewInfoCustomizing event to change resource header captions.

Longer text or a new line in the caption require that the header increases its height to fit the content. The ShouldRecalculateLayout option set to true forces layout recalculation so that changes applied to the header display correctly.

CustomizingVisualElements.cs

    scheduler.GroupType = SchedulerGroupType.Resource;
    scheduler.ActiveViewType = SchedulerViewType.Timeline;
    scheduler.LayoutViewInfoCustomizing += scheduler_LayoutViewInfoCustomizingResourceHeaders; ;

public static void scheduler_LayoutViewInfoCustomizingResourceHeaders(object sender, LayoutViewInfoCustomizingEventArgs e) {
    if (e.Kind == LayoutElementKind.ResourceHeader) {
        ResourceHeader header = e.ViewInfo as ResourceHeader;
        header.Caption = header.Resource.Caption + "\r\nNew long text line";
        e.ShouldRecalculateLayout = true;
    }
}

CustomizingVisualElements.vb

    scheduler.GroupType = SchedulerGroupType.Resource
    scheduler.ActiveViewType = SchedulerViewType.Timeline
    AddHandler scheduler.LayoutViewInfoCustomizing, AddressOf scheduler_LayoutViewInfoCustomizingResourceHeaders

Public Shared Sub scheduler_LayoutViewInfoCustomizingResourceHeaders(ByVal sender As Object, ByVal e As LayoutViewInfoCustomizingEventArgs)
    If e.Kind = LayoutElementKind.ResourceHeader Then
        Dim header As ResourceHeader = TryCast(e.ViewInfo, ResourceHeader)
        header.Caption = header.Resource.Caption & ControlChars.CrLf & "New long text line"
        e.ShouldRecalculateLayout = True
    End If
End Sub