Documentation

Dynamic Items


This section adds new menu items to the context menu.

Dynamic items have three types (menu, item, and separator). with properties to add new items with customization explained below in more details.
The types (menu and item) must contain the property title at least and their value cannot be null.
A separator-type item can be added without any properties.

In the following example, it shows how to write add an items to dynamic:

shell 
{
    dynamic
    {
        item(title = 'Hello, World!')
        separtor
        menu(title = 'sub menu' image = #0000ff)
        {
            item(title = 'test subitem')
        }
    }
}


Properties

Property Summary
Where Allow menu item to be passed if a true value is returned
Default = true
Title Sets a value indicating the caption of the menuitem.

This property must be included with menu and item if image propery is not defined, not required for separator.

Default = null

Required for menu, item.

Mode Accept item by selections behavior. Value have one of the following parameters:
None Accept item when there are no selections.
Single Accept menuitem when there are single selection.
MultiUnique Accept when multiple selections are single type.
MultiSingle Accept when multiple selections are single file extension.
Multiple Accept all types.
Default = Single

Required for menu, item, separator.

Type Specify the types of object files allowed for the menu item to appear. The property is assigned to one or more of these parameters and this character | is used to separate types.
Add a character ~ before single type to exclude.

The property not supported syntax expressions.

File Accept menuitem when file are selected.
Dirctory(Dir) Accept menuitem when Dirctory are selected.
Drive Drive objects
USB Accept menuitem when USB flash drive are selected.
DVD The drive is a DVD-ROM drive
Fixed Accept menuitem when Fixed drive are selected. The drive has fixed media; for example, a hard disk drive or flash drive.
VHD Accept menuitem when Virtual Hard Disk are selected.
Removable The drive has removable media; for example, a floppy drive, thumb drive, or flash card reader.
Remote The drive is a remote (network) drive.
Back Accept menu item when the background of all types are selected or can specify of this types for the background (back.directory, back.drive[back.fixed, back.usb, back.dvd, back.vhd, back.Removable], back.namespace[back.computer, back.recyclebin])
Desktop Accept menuitem when the Desktop are selected.
Namespace Accept menuitem when Namespace are selected. Can be virtual objects such as the My Network Places and Recycle Bin.
Computer Accept menuitem when the My Computer are selected.
Recyclebin Accept menuitem when the Recycle bin are selected.
Taskbar Accept menuitem when the Taskbar are selected.
Default = All types

Required for menu, item, separator.

Visibility (vis) Visibility of menuitem and can have one of the following parameters:
Hidden Them menuitem will not be displayed.
Normal Enabled the menuitem.
Disable Disabled the menuitem.
Static Display item as label with/out an image
Label Display item as label without an image
Extended The menuitem appears when the Shift key is pressed.
ExtendedHidden The item appears disabled when the Shift key is pressed.
ExtendedDisable Hide the menuitem when the Shift key is pressed.
Default = Noraml

Required for menu, item, separator.

Find

Accept menuitem when the specified path name or path extension is contains or equal to the current find property.
Use this delimiter | to separate patterns.

Default = null

Syntax

find = 'exe' Find any word contains "exe"
find = '"exe"' Match whole word only
find = '*exe' Find a word that ends with
find = 'exe*' Find a word that starts with

find = '!exe' Find any word not contains "exe"
find = '!"exe"' Search for any word not equal to "exe"
find = '!*exe' Find a word that not ends with
find = 'exe*!' Find a word that starts with

find = '.exe' Find an equal extension for ".exe"
find = '!.exe' Find an not equal extension for ".exe"

find = '.exe|.dll' Find an equal extension for ".exe" or ".dll"
Separator (sep) Add separator with menuitem position by parameters:
None Not adding a separator with the menuitem.
Before Add a separator before the menuitem.
After Add a separator after the menuitem.
Both Add a separator before and after the menuitem.
Default = none

Required for menu, item.

Position (pos) The position at which a menuitem should be inserted into the menu.
Position can have one of the following parameters:
Auto Insert the menuitem to the current position.
Middle Insert the menuitem to the middle of the menu.
Top Insert the menuitem to the top of the menu.
Bottom Insert the menuitem to the bottom of the menu.
Number sets Insert the menuitem to a specified position with integer numbers.
Default = auto

Required for menu, item, separator.

Image The icon that appears in a menuitem, This property can be assigned as image files, resource icons, glyph or color. With one of the following parameters
null Show menuitem without icon.
Inherit @*Inheriting the image from the parent.*@ Inherits this property from its parent element.
Cmd Assign image from the command property.
Glyph Assign image as Glyph.
Color Assign image as color.
Path Assign image from location path or resource icon.
Default = null

Required for menu, item.

Parent

Move current item to another menu.

Default = null
Command (cmd)

The command associated with the menuitem. Occurs when the menuitem is clicked or selected using a shortcut key or access key defined for the menuitem.

Default = null

Required for item.

Arguments (arg, args)

The parameter to pass to the Command property of a menuitem.

Default = null

Required for item.

Window Controls how the window is to be shown. can be one of the following parameters:

Hidden, Show, Visible, Minimized, Maximized

Default = show

Required for item.

Directory (dir)

Specify the work directory to execute the command.

Default = null

Required for item.

admin

Execute the command with administrative permissions.

Default = false

Required for item.

Verb Specifies that the operation is the default for the selected file. value type string and can have one of the following parameters:
null Specifies that the operation is the default for the selected file type.
Open Opens a file or a application.
OpenAs Opener dialog when no program is associated to the extension.
RunAs In Windows 7 and Vista, opens the UAC dialog andin others, open the Run as... Dialog.
Edit Opens the default text editor for the file.
Explore Opens the Windows Explorer in the folder specified in Directory.
Properties Opens the properties window of the file.
Print Start printing the file with the default application.
Find Start a search.
Default = open

Required for item.

Wait

Waiting Until end of command.

Default = false

Required for item.

Checked

Value that indicates whether the menuitem is checked.

Default = false

Required for item.

Default

Specifies that the menuitem is the default. A menu can contain only one default menuitem, which is displayed in bold.

Default = false

Required for item.

Column(col)

Create a new column.

Default = true

Required for item, menu.

Keys

Show keyboard shortcuts.

Default = null
Tip

Show a tip for the current item

Default = null
Syntax

tip = "Lorem Ipsum is simply dummy text."
tip = ["Lorem Ipsum is simply dummy text.", tip.info]
tip = ["Lorem Ipsum is simply dummy text.", tip.info, 1.2]

This page is open source. Noticed a typo? Or something unclear?
Improve this page on GitHub