diff --git a/docs/syntax/static.html b/docs/syntax/static.html index 8ee87c9..6507b05 100644 --- a/docs/syntax/static.html +++ b/docs/syntax/static.html @@ -1,15 +1,101 @@ -

Static Items

+

Static Items


-

This section modifies context menu items added by the system or by a third party. more than one item can be added - with some properties to customize the context menu. explained below in more details.
The items must have the - property find. to search in the titles of the menu items to catches them and customize by other - properties such as changing the title, icon, visibility, or moving it to another location.

-

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

+

The optional static section contains entries to modify existing context menu items, + added by the system or by a third party.

+ +
Sub-items
+

The section can have the following entry types, all of which are optional:

+ +

While the var block should be at the top of the section, the other entries can appear in any order.

+ +
Example
+

In the following example, two instructions are defined:

shell 
 {
     static
     {
-        item(find = 'copy'image = #00ff00)
+        item(find = 'copy' image = #00ff00)
         item(find = 'paste' image = #0000ff)
     }
 }
+
+ +

Item Entries

+ +

item entries contain the instructions on how to identify existing menuitems (also referred to as Target), and when and what changes should be applied + to them.

This is done by matching an existing menuitem's title property against the static item's mandatory find property. If a match is found, the other properties of the static + item are applied to the appropriate menuitem, such as changing their properties (e.g. title, icon, visibility), or moving them to another location.

+ +
Syntax
+
item( title = value [property = value [...] ])
+
+ + +
Properties
+ +

item entries can define three different sets of properties:

+
+
Validation Properties
+
Determine if a given item entry should be processed when a context menu is displayed. Optional. +
+
Filter Properties:
+
Determine if a given menuitem is a valid target + for the process instructions + +
+
Process Instructions
+
Define what to do with the target. Optional. However, if there are no process instruction specified, the entry is of no practical use. For + further details refer to its separate section + below. +
+
+ +

For a complete overview and further details regarding applicable properties, please refer to the properties page.

+ +

Item Target

+ +

Item targets are menuitems of an existing context menu. Their properties or location can + be changed by applying the process instructions defined in a static item.

+ +
Process instructions
+

Instructions that should be applied to the Target. Basically they consist of properties from the two property + classes menuitem properties and command properties.

+

Once a item is validated and a target identified, then these values are applied to the targeted + menuitem.