20.27. Das ControlFilter Attribut

Das ControlFilter Attribut dient dazu Steuerelemente in der Toolbox wahlweise ein oder auszublenden. Insebsondere wird dies benötigt, um Steuerelemente in der Navigationskonfiguration nur bei bestimmten Typen der Navigationskonfiguration anzuzeigen.

Dazu hat das Attribut zwei Möglichkeiten zu definieren, ob das Steuerelement in der Toolbox sichtbar sein soll oder nicht. Die Optionen sind OptOut und OptIn. Wenn das Attribut eine OptOut-Option verwendet und die Bedingung erfüllt ist, wird das Steuerelement nicht in der Toolbox angezeigt. Wenn das Attribut die Option OptIn verwendet und die Bedingung erfüllt ist, wird das Steuerelement angezeigt. OptOut hat Vorrang vor OptIn, d. h. wenn das Steuerelement aufgrund von OptOut nicht sichtbar ist, wird OptIn überhaupt nicht beachtet.

[Serializable]
[Toolbox(EnumConfigurationType.NavigationConfigurationGuid)]
[ControlFilter("NavigationConfigurationType", ExpressionType.Equal, EnumNavigationConfigurationType.BusinessMailNavigationGuid, EnumControlFilterApplyState.OptOut)]
[ControlFilter("NavigationConfigurationType", ExpressionType.Equal, EnumNavigationConfigurationType.OrmActionsNavigationGuid, EnumControlFilterApplyState.OptOut)]
public class ClientActionUserSettings : ClientActionBase

Dieses Steuerelement ist in der Toolbox verfügbar, wenn der Konfigurationstyp nicht BusinessMail und der Typ nicht OrmActions ist.

[Serializable]
[Toolbox(EnumConfigurationType.NavigationConfigurationGuid)]
[ControlFilter(nameof(NavigationConfiguration.NavigationConfigurationType), ExpressionType.Equal, EnumNavigationConfigurationType.RibbonNavigationGuid, EnumControlFilterApplyState.OptIn)]
[ControlFilter(nameof(NavigationConfiguration.NavigationConfigurationType), ExpressionType.Equal, EnumNavigationConfigurationType.MainNavigationGuid, EnumControlFilterApplyState.OptIn)]
[ControlFilter(nameof(NavigationConfiguration.NavigationConfigurationType), ExpressionType.Equal, EnumNavigationConfigurationType.MenuNavigationGuid, EnumControlFilterApplyState.OptIn)]
public class ServerActionShowDashboard : ServerActionBase

Dieses Steuerelement ist in der Toolbox verfügbar, wenn der Konfigurationstyp der Navigation Ribbon, Main oder Menu ist.