See the following procedures for customizing the predefined SysMLElementCreationDialog configuration for the Element Creation dialog and submenu.

Updating the Element Creation dialog/submenu

Once you have created the new Element Creation dialog/submenu, activate it via the (2026x Refresh1) Activating Element Creation dialog.

The procedures on this page use the example of customizing the SysMLElementCreationDialog part definition. However, you can similarly customize any other custom element creation dialog customization part definition you may have.

Reusing an Element Creation dialog/submenu

To reuse an Element Creation dialog/submenu

  1. In the Containment tree, create a new root namespace.
  2. Open the Textual Editor for the new namespace.
  3. In the Textual Editor, create a package and name it.
  4. Within the body of the package, declare a part definition, specify the name for the dialog instance, and subclassify the SysMLElementCreationDialog definition from the DS_UIComponents::UIComponents package, then, within the body of the definition:
    1. Renaming the Create Element command
    2. Modify the Element Creation dialog/submenu command categories
    3. Modify the Element Creation dialog/submenu commands
  5. Click the Synchronize button.

package CustomElementCreationDialogs {
    part def CustomizedElementCreationDialog :> DS_UIComponents::UIComponents::SysMLElementCreationDialog { // redefining and renaming the SysMLElementCreationDialog
    }
}

Renaming the Create Element command

The default name for the Element Creation dialog's invocation command is Create Element.

To rename the Create Element command

  1. Within the body of the part definition element of the new Element Creation dialog instance, redefine the actionName attribute with the new element creation command name. 
  2. Click the Synchronize button.

package CustomElementCreationDialogs {
    part def CustomizedElementCreationDialog :> DS_UIComponents::UIComponents::SysMLElementCreationDialog {
        attribute :>> actionName default "Create SysMLv2 Element"; // renaming the element creation command to "Create SysMLv2 Element"
    }
}

Modifying the Element Creation dialog/submenu command categories

Command menus

Element Creation dialog/submenu command categories predefined in the 3DS SysML Customization library's DS_UIComponents::UIComponents::SysMLElementCreationDialog are: 

  • sysMLElementsMenu - a singular element creation commands' category in the Element Creation dialog/submenu.

Creating element creation command categories for the Element Creation dialog/submenu

To create element creation command categories for the Element Creation dialog/submenu

Removing element creation command categories from the Element Creation dialog/submenu

To remove element creation command categories from the Element Creation dialog/submenu

  1. Within the body of the part definition element of the new Element Creation dialog instance, redefine the command category you want to customize, inherited from the specified definition (e.g., SysMLElementCreationDialog), and set the multiplicity to zero.
  2. Click the Synchronize button.

package CustomElementCreationDialogs {    part def CustomizedElementCreationDialog :> DS_UIComponents::UIComponents::SysMLElementCreationDialog {
        part :>> sysMLElementsMenu [0]; // removing the sysMLElementsMenu command category by setting the multiplicity to zero
    }
}

Modifying the element creation command category attributes of the Element Creation dialog/submenu

Command menu attributes

Element Creation dialog/submenu command category attributes predefined for sysMLElementsMenu in DS_UIComponents::UIComponents::SysMLElementCreationDialog are:

  • attribute :>> label default "General"; // attribute specifies the category name
  • attribute :>> isCollapsed default false; // attribute specifies whether the category is collapsed or expanded by default

If the dialog/submenu contains fewer than ten element creation commands, then the category cannot be collapsed. In this case, the isCollapsed attribute is ignored.

To modify the element creation command category attributes of the Element Creation dialog/submenu

  1. Within the body of the part definition element of the new Element Creation dialog instance, redefine the command category you want to customize, inherited from the SysMLElementCreationDialog definition.
  2. Within the body of the redefining category, redefine the inherited attributes that you want to modify with the needed values.
  3. Click the Synchronize button.

package CustomElementCreationDialogs {
    part def CustomizedElementCreationDialog :> DS_UIComponents::UIComponents::SysMLElementCreationDialog {
        part :>> sysMLElementsMenu {
            attribute :>> label default "SysMLv2 Elements"; // naming the element creation command category
            attribute :>> isCollapsed default true; // modified category's default collapse state
        }
    }
}

Modifying the Element Creation dialog/submenu commands

Commands in menus

You can see all the Element Creation dialog/submenu commands predefined for the sysMLElementsMenu in DS_UIComponents::UIComponents::SysMLElementCreationDialog::sysMLElementsMenu.

Removing element creation commands from the Element Creation dialog/submenu command categories

To remove element creation commands from the Element Creation dialog/submenu command categories

  1. Place the cursor within the body of the part element redefining an Element Creation dialog/submenu command category.
  2. Declare a part usage, then redefine the command you want to remove and set its multiplicity to zero.
  3. Click the Synchronize button.

package CustomElementCreationDialogs {
    part def CustomizedElementCreationDialog :> DS_UIComponents::UIComponents::SysMLElementCreationDialog {
        part :>> sysMLElementsMenu {
            part :>> actionUsageItem [0]; // removing the actionUsageItem element creation command from the sysMLElementsMenu category by setting the multiplicity to zero
        }
    }
}

Renaming element creation commands in the Element Creation dialog/submenu command category

To rename element creation commands in the Element Creation dialog/submenu command category

  1. Place the cursor within the body of the part element redefining an Element Creation dialog/submenu command category and declare a part usage, then redefine the command you want to modify.
  2. Within the body of the redefining usage, redefine the inherited label attribute with the needed value.
  3. Click the Synchronize button.

package CustomElementCreationDialogs {
    part def CustomizedElementCreationDialog :> DS_UIComponents::UIComponents::SysMLElementCreationDialog {
        part :>> sysMLElementsMenu {
            part :>> actionUsageItem {
                attribute :>> label default "Action Usage";  // modified command name
            }
        }
    }
}

Adding element creation commands to the Element Creation dialog/submenu command categories

To add element creation commands to the Element Creation dialog/submenu command categories