Edit

Share via

Control the visibility of an icon or decorator

  • Article

A decorator is an icon or line of text that appears on a shape in a domain-specific language (DSL). You can make the decorator appear and disappear depending on the state of properties in the model. For example, on a shape representing a Person, you could have different icons that appear, depending on the person's gender, number of children, and so on.

The following procedures assume that you've already defined a shape and its mapping to a domain class. For more information, see How to Define a Domain-Specific Language.

Control the visibility of an icon or text decorator

  1. In the DSL Definition diagram, add to the shape class the icons or text decorators that you want to appear.

    1. Right-click the shape class, select Add, and then select the required type of decorator.

    2. Set the decorator's Position property. More than one decorator can have the same position. For example, you could have icons for male and female sharing the same position.

    3. Set the Default Icon property of an icon decorator.

  2. Select the diagram element map, which is the gray line between the shape class and the domain class on the DSL Definition diagram.

  3. In the DSL Details window, in the Decorator Maps tab, select a decorator. For example, the MaleDecorator.

  4. Select the Visibility Filter checkbox.

  5. If the domain property that should control visibility is on the immediate domain class, leave Path to Filter Property blank.

    Otherwise, select the dropdown menu and navigate to the relationship or class where the property is located.

    • To avoid an error report, don't navigate through a relationship marked with "*" in the navigation tool.

  6. Set the Filter Property to a domain property. For example, Gender.

  7. In the Visibility Entries list, add values of this domain property for which the decorator should be visible. For example, Male.

  8. Repeat the steps for each icon.

  9. Select Transform All Templates, build, and run. Open a test diagram.

    When you change the controlling property value, the decorators should appear and disappear.

Frequently, you want visibility to be controlled by a more complex formula than a simple set of values. For example, to have an icon depend on the number of links of a particular type, or to make it depend on whether a number is in a particular range. In that case, use the following procedure.

Control the visibility of a decorator based on a formula

  1. Add a calculated domain property to the domain class. In the Properties window, set the following values:

    1. IsBrowsable = False. This value hides the property from the user.

    2. Kind = Calculated. This value means that you provide code that calculates its value.

    3. Name, for example DecoratorControl.

    4. Type = Boolean.

    For more information, see Calculated and Custom Storage Properties.

  2. Make the new property control the decorator visibility.

    1. Select the diagram element map, which is the gray line from the domain class to the shape. In the DSL Details window, open the DecoratorMap tab.

    2. Select the Visibility Filter checkbox.

    3. In Filter Property, select the control property DecoratorControl.

    4. Under Visibility Entries, enter True.

  3. Select Transform All Templates in the Solution Explorer toolbar.

  4. Select Build Solution on the Build menu.

  5. Double-click the error report that has appeared: "YourClass does not contain a definition for GetDecoratorControlValue ...".

    The text editor opens on Dsl\GeneratedCode\DomainClasses.cs. Above the highlighted error is a comment that requests you to add a method.

  6. Note the namespace, class and method that are missing. For example, Company.FamilyTree.Person.GetDecoratorControlValue().

  7. In a separate code file, write a partial class definition that contains the missing method. For example:

    namespace Company.FamilyTree
{
  partial class Person
  {
    bool GetDecoratorControlValue()
    {
      return this.Children.Count > 0;
    }
  }
}

    For more information about customizing the model with program code, see Navigating and Updating a Model in Program Code.

  8. Rebuild and run the solution.

Related content