User Tools

Site Tools


en:documentation:toolbox_editor

This is an old revision of the document!


Tool box editor

This window is show when you click the Script button at the bottom of a Tool box. It allow to configure and program the action for the tool box.

Create the tool layout

First set the title for your tool in the top text field.

Then you need to add at least one Group: click the Group button, set the group title and the number of column element you want on each row. Then click the Add button.

Then use the same principle to add the elements you want, for example a text Edit and a Button.
This elements can only be added to a group.
A name is automatically assigned to each element, for example Edit_1 . This is this name you need to use to access the element properties from your script.
For some elements you can select a title or a height in pixel.
To change the number of elements per row, create a new group with the required value but without title.

Special elements are the Events. This not add anything visible on the screen but allow you to write the require script to process an event.
Event are :

  • Initialisation: Run once after you click the Apply button, or when the program start.
  • Activation: Run every time this tool box is show.
  • Timer: Run at periodic interval, enter the interval in second when you select this event.
  • Telescope move: Each time the telescope position change.
  • Chart refresh: Each time the chart redraw.
  • Object identification click: Each time and object is select by a click on the chart or as the result of a search.
  • Distance measurement: When you measure a distance on the chart.
  • Telescope connected: When the telescope is connected.
  • Telescope disconnected: When the telescope is disconnected.
  • Translation: Run after initialisation or when you change the program language.

The events are normally inactive when the tool is not show on the screen. One exception is the Timer event you can always activate by checking the corresponding box. But be careful with the performance issue this option can imply.
Use the Activation event to update your tool with the change that can occur on the map when the tool was inactive.

You can reorder the group or elements by using the vertical arrows or by drag and drop in the left tree.

If you select an element in the tree and change one of it's property the Update button appear to allow to apply the change.

A script can be attached to following elements: Button, Combo box, Event.
When you select one of this elements in the tree the “Edit script” button appear. See below for the details.

When you are ready click the Apply button to show your elements on the tool box and compile the scripts.
Don't forget to save your work to a file with the Save button (default file extension is .cdcps).
Also save the program configuration to have you tool box automatically loaded the next time you start the program.

Script editor

en/documentation/toolbox_editor.1402739265.txt.gz · Last modified: 2015/11/06 20:33 (external edit)