Href Editor

To add function to the widget, the user can include href functions when modifying the widget. The user just has to click on the "Value" next to the Href Property for that particular widget as shown below.

A new Href Editor window will pop up. An example of the Href Editor window is shown below.

To customize the look and feel of the Href Editor, select “options” from the drop down Tools menu on the top of the Project window.

The user can customize the Editor with the following options:

Syntax Highlighting

1. Keywords: customize the color from a color picker that pops up when you click on the color selection, and font style (bold, italic and/or underline).

2. Comments: customize the color from a color picker that pops up when you click on the color selection, and font style (bold, italic and/or underline).

3. Strings: customize the color from a color picker that pops up when you click on the color selection, and font style (bold, italic and/or underline).

4. Numbers: customize the color from a color picker that pops up when you click on the color selection, and font style (bold, italic and/or underline).

Other Code Editor Options:

1. Autocomplete Applies Standard Case: CHECKED or UNCHECKED. If CHECKED, then GEMstudio will autocomplete the METAs using the font case from the GEMstudio libraries. If UNCHECKED, then GEMstudio will autocomplete using the same case font the user was typing with.

2. Auto Close Brackets: CHECKED or UNCHECKED. If CHECKED, GEMstudio will automatically provide a closing bracket.

3. Auto Indent New Lines: CHECKED or UNCHECKED. If CHECKED, GEMstudio will automatically indent new lines of code.

4. Highlight Block When Hovering Mouse Over Gutter: If CHECKED, GEMstudio will highlight a block of code when the mouse hovers over the gutter as shown in the figure below.

5. Circle Matching Brackets: CHECKED or UNCHECKED. If CHECKED, GEMstudio will circle the matching brackets as the user closes the bracket.

6. Display Line Numbers: CHECKED or UNCHECKED. If CHECKED, GEMstudio will display line number in a gutter on the left of the Page Functions Editor.

Href Editor Tips:

1. Auto complete is activated with the TAB key. If the cursor is not at the end of a line, auto complete will not show visual gray. The user must hit TAB to show the available options. If the cursor is at the end of a line and there are multiple options available, the user must hit TAB to show options. However, if there is only one option available, hitting TAB will auto complete the visually grayed function.

2. C style comments (/* … */) are supported as shown in the Figure below. Auto complete is not available inside comments.

3. The user can fold and unfold blocks of comments (unlike the Page Functions Editor) for easier reading and navigation. The user can access these commands from the Folding drop down menu. Arrows shown in the left gutter of the editor can also be used to collapse or expand blocks of code. An example is shown below:

For more information on the usage of href editor functions, please go to Inter-Widget Communications and Appendix C.

NOTE: If at any time, you need further explanation on widget or parameter in your project, select the widget or parameter and click on the  button on the lower left hand corner of the project window or press "F1". A help window will pop up and explain the selected widget or parameter.