Creating Custom Folder Behavior

Last Updated: 03/28/2018 Introduced in Version: 2.0

Overview

New folder behaviors can be created to modify the default folder behavior. Many aspects of a folder’s behavior can be modified. All the overridable methods for a folder’s default behavior are listed at the end of this document. The most common overrides are highlighted as examples below.
 

Examples

ShowInTreeView: Overriding lets us control whether this folder type shows up in the folder tree. By default it is shown. Here is an example showing how to cause to be hidden from the tree.

Using this override will cause the folder to show up only in the folder view of the parent folder as shown below. Even though New Folder is a child of Root Folder it is not show in the folder tree; it appears only as part of the Folder Data when Root Folder is selected.
2017-02-16_121227
 
 
GetFolderActions: Overriding allows us to control which actions are shown on a folder. In the example below, in addition to the default action that are supplied for a folder, we have added an action to open the URL www.decisions.com.

 

With this override, the action would show up looking like the following:

 
 2017-02-16_121340
  
 
CanBeSetByUser: Overriding allows us to control whether or not this folder type is allowed to be added by users via the actions menu. By default, this value is set to false. Below is example code showing how to override to equal true.

Setting to true causes the folder type to show up in the actions menu as shown below: 

 
2017-02-16_121741 
 
CanAddEntity: Overriding allows us to control what entity types are allowed to be added to this folder type. For example, you may want to create a folder type that is only allowed to contain Designer Project folders. To do this, you would write an override as follows:

CanBeRootFolder: Overriding allows us to control whether or not this folder is allowed to be a root folder. By default any folder type other than DefaultFolderBehavior are NOT allowed to be root folders. Setting this override to true will allow the folder to be a root folder. The following sample demonstrates this:

 
List of All Properties that Can be Overridden

 

Additional Resources