Frame.SetControllersActive(String, Boolean) Method

Activates or deactivates the current Frame‘s Controllers for a specified reason.

Namespace: DevExpress.ExpressApp

Assembly: DevExpress.ExpressApp.v24.1.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

public void SetControllersActive(
    string reason,
    bool isActive
)

VB.NET

Public Sub SetControllersActive(
    reason As String,
    isActive As Boolean
)

Parameters

Name	Type	Description
reason	String	A string value that specifies a reason by which Controllers are activated or deactivated.
isActive	Boolean	true if you need to activate Controllers; otherwise, false.

Remarks

Use this method to add a specified element to the Controller.Active collection of each Controller from the Frame‘s Frame.Controllers collection. This element, which represent a key/value pair, will be formed from values passed as the reason and isActive parameters. By calling this method, you can change a Controller’s active state. A Controller is active, when none of the Controller.Activecollection elements have the false value. So, use this method in the following situations:

• Deactivate all Controllers. To do this, pass false as the isActive parameter.
• Activate the Controllers that have been deactivated by a particular reason. To do this, pass true as the isActive parameter and the required reason as the reason parameter. The Controllers that have been deactivated by another reason will not be activated until you call this method and pass this reason. *