TSLWinSelectOperation Class Reference

Detailed Description

The TSLWinSelectOperation class.

If this operation is used, then normally the default operation should be set to "winselect", either through the TSLEditor call, or by specification in the .ini file. This is done by default if the 'TSLAllWindows Operations::add' method is used.

Operation Name winselect

Additional Data none

This is a windows style operation. It enables the application to use a windows-style selection mechanism.

In this style of interaction, left-click on an object selects it. Any objects that are already selected are deselected. Left-click in an empty area clears the select list.

Shift-left-click on an object toggles it in or out of the select list.

Left-button drag will either trigger a move of currently selected objects or a select-by-rectangle.

If the initial mouse press is on an empty piece of the drawing surface, then a select-by-rectangle is started. If the shift button is pressed then all objects totally within the chosen extent are added to the select list. If it is not pressed then the select list is cleared first.

If the initial mouse press is on top of one of the selected objects, then the objects in the current select list are moved, anchored around the press location.

If the initial press is on top of a non-selected object, then the select list is cleared, the pressed object is selected and a move started, anchored around the press location.

Undo is available for selections, deselections and object moves.

Right click will trigger a call to the context handler passed to the 'add' function.

Static Public Member Functions
static bool	add (TSLEditor *editor, TSLWinContextHandler *contextHandler)

Member Function Documentation

add()

static bool TSLWinSelectOperation::add ( TSLEditor * editor, TSLWinContextHandler * contextHandler )

static

This method adds the operation to a TSLEditor object. It is passed a pointer to the editor object.

Arguments list details:

editor: a pointer to the TSLEditor object.

contextHandler: a pointer to a TSLWinContextHandler derived object. This is called if the righ-mouse button is pressed during the select mode - allowing a context menu to be invoked.

Returns true if added successfully, otherwise false.