Tools Toolbar

The commands in the Tools toolbar are used to insert new points, lines and areas into a drawing or to paint regions of pixels into images. Objects may be created "free hand" or pre-built shapes may be used. Note that the contents of this toolbar depend on what component window or map layer is active.

Drawings

$images\tbar_tools_drawings.gif$

The Tools toolbar for drawings hosts drawing editing tools. The difference between on-center and regular versions of these tools is exactly analogous to the difference between on-center and regular version of these tools used for images. See the Image Editing Tools topic for examples of the difference between regular and on-center versions of painting tools.

Insert Area	$images\btn_shp_area.gif$	Draw areas within the mouse cursor region defined by a series of clicks followed by a right click.
Insert Freeform Area	$images\btn_shp_freeform_area.gif$	Draw areas within the mouse cursor region defined by clicking and dragging, followed by a right click.
Insert Freeform Line	$images\btn_shp_freeform_line.gif$	Draw lines as defined by clicking and dragging, followed by a right click.
Insert Line	$images\btn_shp_line.gif$	Draw lines as defined by a series of clicks followed by a right click.
Insert Line Sequence	$images\btn_shp_lineseq.gif$	Draw lines as a sequence of separate lines.
Insert Point	$images\btn_shp_point.gif$	Draw points - click to create a point.
Insert Box	$images\btn_shp_box.gif$	Draw a rectangular box shape with a click and a drag.
Insert Box on Center	$images\btn_shp_cbox.gif$	Draw a rectangular box shape centered on initial mouse click.
Insert Circle	$images\btn_shp_circ.gif$	Draw a circle with a click and a drag..
Insert Circle on Center	$images\btn_shp_ccirc.gif$	Draw a circle centered on initial mouse click.
Insert Ellipse	$images\btn_shp_ellip.gif$	Draw an ellipse with a click and a drag..
Insert Ellipse on Center	$images\btn_shp_cellip.gif$	Draw an ellipse centered on initial mouse click.
Insert Geographic Circle	$images\btn_shp_geocirc.gif$	Draw a shape centered on the initial mouse click that forms a circle on the Earth. That is, each location on the shape will be the same distance from the center point. May appear to be a non-circular shape depending on the projection of the drawing.
Create Lines	$images\btn_shpmodeline.gif$	Create lines when drawing shapes.
Create Points	$images\btn_shpmodepoint.gif$	Create points when drawing shapes.

See the Adding Shapes topic for additional details and examples of working with drawings.

If Snap modes are not on, the ALT key toggles between non-center and on-center version of whatever tool is selected.

Images

$images\tbar_tools_images.gif$

The Tools toolbar for images hosts painting tools. See the Image Editing Tools topic for examples of the difference between regular and on-center versions of painting tools.

Paint Areas	$images\btn_shpmodearea.gif$	A mode button: the selected tool will create filled regions of pixels.
Paint Lines	$images\btn_shpmodeline.gif$	A mode button: the selected tool will create lines.
Paint Points	$images\btn_shpmodepoint.gif$	A mode button: the selected tool will create points where the mouse cursor changes direction on clicks.
Paint Area	$images\btn_paint_area.gif$	Paint pixels within the region clicked. Creates lines or points if shape modes so specify.
Paint Freeform	$images\btn_paint_freeform.gif$	Paint pixels within region about which the mouse is clicked and dragged.
Paint Line	$images\btn_paint_line.gif$	Paint a line defined by straight-line segments between clicks.
Paint Box	$images\btn_paint_box.gif$	Paint a rectangular box using a mouse click and a drag.
Paint Box on Center	$images\btn_paint_box_center.gif$	Paint a rectangular box centered on initial mouse click.
Paint Circle	$images\btn_paint_circle.gif$	Paint a circle using a mouse click and a drag.
Paint Circle on Center	$images\btn_paint_circle_center.gif$	Paint a circle centered on initial mouse click.
Paint Ellipse	$images\btn_paint_ellipse.gif$	Paint an ellipse using a mouse click and a drag.
Paint Ellipse on Center	$images\btn_paint_ellipse_center.gif$	Paint an ellipse centered on initial mouse click.
Brush	$images\btn_paint_brush.gif$	Paint a dot with one click or a continuous line with a click and a drag.
Paint Bucket	$images\btn_paint_bucket.gif$	Click to fill a contiguous or enclosed region with color. Fills to a given threshold of color. SHIFT click to pour into the given color in all regions of the image, even if not contiguous. Use this as a "replace color" operation. CTRL click to replace colors within the threshold while retaining the same intensity. CTRL and SHIFT may be combined to replace non-contiguous colors while retaining intensity.
Gradient	$images\btn_gradient.gif$	Click, drag and release to create a color gradient between click point and release point.
Pick Color	$images\btn_pick_color.gif$	Click to pick the color at that location as the foreground color. Shift click to pick the color at that location as the background color.

See the Image Editing Tools topic for additional information on painting into images.

If Snap modes are not on, the ALT key toggles between non-center and on-center version of whatever tool is selected.

Layouts

$images\tbar_tools_layouts.gif$

Layouts are used to specify how printing jobs should appear. Items that appear in a layout may be dragged and dropped from the project pane into the layout window. The tools toolbar for layouts allows us to insert additional design elements.

Insert Horizontal Line	$images\btn_layout_insert_horiz_line.gif$	Create a horizontal line in the layout. Default line size is 1/20th of a point.
Insert Vertical Line	$images\btn_layout_insert_vert_line.gif$	Create a vertical line in the layout. . Default line size is 1/20th of a point.
Insert Box	$images\btn_shp_box.gif$	Create a rectangular box with a click and a drag. Boxes have foreground and background color and line thickness that can be set by selecting the box and using the format toolbar. Default line size is 1/20th of a point.
Insert Box on Center	$images\btn_shp_cbox.gif$	Create a rectangular box centered on initial mouse click. Default line size is 1/20th of a point.
Insert Text	$images\btn_layout_insert_label.gif$	Add a text box, such as a caption, copyright notice or title, to the layout. Click on the text box to select it and then use the format toolbar to format the text. Double-click a text box in the layout to edit the text it contains.
Insert Legend	$images\btn_insert_legend.gif$	Add a legend to the layout, based upon a component used in the layout.
Insert North Arrow	$images\btn_insert_north_arrow.gif$	Add a North arrow to the layout, based upon a component used in the layout.
Insert Scale Bar	$images\btn_insert_scale_bar.gif$	Add a scale bar to the layout, based upon a component used in the layout.

See the Layouts topic for additional information on creating and using layouts.

Scripts

$images\tbar_tools_scripts.gif$

Scripts provide programming instructions used to customize Manifold or to create new capabilities. See Programming Manifold and Scripts for an introduction to scripts.

If the Manifold Debugger is installed, when a script has the focus the tools toolbar will have debugger commands enabled. The debugger helps us develop and debug scripts in the scripting language of our choice. Commands will be enabled in the debugger toolbar as make sense given the execution state of the script.

Run	$images\btn_run_query.gif$	Run a script.
Run under Debugger	$images\btn_scripts_run.gif$	Run a script under control of the debugger.
Pause	$images\btn_scripts_pause.gif$	Pause execution of a script.
Stop	$images\btn_scripts_stop.gif$	Stop execution of a script.
Step Over	$images\btn_scripts_step_over.gif$	Step over a routine.
Step Into	$images\btn_scripts_step_into.gif$	Step into a routine.
Step Out	$images\btn_scripts_step_out.gif$	Step out of a routine.

Labels

$images\tbar_tools_labels.gif$

The tools toolbar has three commands available when a labels component has the focus. These commands are used to manually add labels to an unbound labels component. An unbound labels component is one in which label text is not automatically created from fields for all objects in a parent drawing but rather a labels component in which labels are added manually. Labels components are normally used within maps so that when adding labels by hand there are other components visible (such as a drawing) to provide correct positioning context.

Insert Label	$images\btn_insert_label_point.gif$	Add a text label to the labels component.
Insert Line Label	$images\btn_insert_label_line.gif$	Add a text label aligned to the guideline composed of straight line segments that is drawn with the insert tool.
Insert Freeform Line Label	$images\btn_insert_label_freeform.gif$	Add a text label aligned to the freeform, curved guideline that is drawn with the insert tool.

See the Adding Text Labels topic for examples of the above.

Forms

$images\tbar_controls.gif$

The Tools toolbar is used with Forms to create frequently used Windows standard user interface controls. The toolbar is enabled when a Form is the active window. Forms are used to provide user interfaces to scripts, to view tables and for other functions within Manifold.

Click on a control in the Tools toolbar and then click and drag in the Form window to insert the control in the form in the position and size indicated by the mouse click and drag. Forms are then customized using the properties for each control as well as the View - Info Window for the Form.

See the individual controls topics for details on each control.

$images\btn_ctrl_checkbox.gif$	Insert Check Box - Inserts check box controls.
$images\btn_ctrl_optionbtn.gif$	Insert Option Button - Inserts option button controls. Only one option button in a group may be selected.
$images\btn_ctrl_button.gif$	Insert Command Button - Inserts command button controls.
$images\btn_ctrl_frame.gif$	Insert Frame - Draws frame with caption. Frames are used to set off groups of controls, often option buttons.
$images\btn_ctrl_text.gif$	Insert Text Box - Inserts text box. Also called an edit field or edit control. This control can display text entered by the programmer at design time or entered by the user or assigned to the control by other code at run time.
$images\btn_ctrl_static_text.gif$	Insert Static Text Box - Add a customized text box.
$images\btn_ctrl_listbox.gif$	Insert List Box - Inserts list box controls.
$images\btn_ctrl_combobox.gif$	Insert Combo Box - Inserts combo box controls.
$images\btn_ctrl_horscroll.gif$	Insert Horizontal Scroll Bar - Inserts horizontal scroll bar controls.
$images\btn_ctrl_verscroll.gif$	Insert Vertical Scroll Bar - Inserts vertical scroll bar controls.

See the Tools (Advanced) Toolbar topic for additional controls used with forms.