Frame.SetView(View, Boolean, Frame, Boolean) Method

Sets a specified View for the current Frame.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v23.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public bool SetView(
    View view,
    bool updateControllers,
    Frame sourceFrame,
    bool disposeOldView
)

VB.NET

Public Function SetView(
    view As View,
    updateControllers As Boolean,
    sourceFrame As Frame,
    disposeOldView As Boolean
) As Boolean

Parameters

Name	Type	Description
view	View	A View object which is set for the current Frame.
updateControllers	Boolean	true, if the Frame’s Controllers are activated after setting a new View; otherwise, false.
sourceFrame	Frame	A Frame object in which creating a new View was requested.
disposeOldView	Boolean	true, if the Frame’s old View should be disposed; otherwise, false.

Returns

Type	Description
Boolean	true, if an old View can be changed by another one; otherwise, false.

Remarks

This overload of the SetView method allows you to apply Application Model changes to a View without recreating it. Save the Frame’s View to a variable, then set the Frame’s View to null. Make the required changes to the model and then set the saved View back to the Frame.

C#

View view = Frame.View;
if(Frame.SetView(null, true, null, false)) {
    // Make required changes with the model here.
    // ...
    view.LoadModel(false);
    Frame.SetView(view);
}

VB.NET

Dim view As View = Frame.View
If Frame.SetView(Nothing, True, Nothing, False) Then
    ' Make required changes with the model here.
    ' ...
    view.LoadModel(False)
    Frame.SetView(view)
End If

It is recommended to pass false to the View.LoadModel method to avoid creating controls within this method. Otherwise, the OnViewControlCreated methods of View’s Controllers will not be called.

The complete example of a Controller that uses the SetView method is provided in the How to: Apply Application Model Changes to the Current View Immediately topic.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SetView(View, Boolean, Frame, 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#

xaf-save-and-share-custom-view-settings/CS/ViewSettingsSolution.Module/Controllers/ViewVariantsController.cs#L32

isLayoutProcessed = true;
if(Frame.SetView(null, true, null, false)) {
    if(isDefaultViewSelected) {

VB.NET

xaf-save-and-share-custom-view-settings/VB/ViewSettingsSolution.Module/Controllers/ViewVariantsController.vb#L43

isLayoutProcessed = True
If Frame.SetView(Nothing, True, Nothing, False) Then
    If isDefaultViewSelected Then