QCAD
Open Source 2D CAD
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
EAction Class Reference

Base class for all ECMAScript based actions. More...

Inheritance diagram for EAction:
RActionAdapter RAction Block BlockExamples CommandLineExamples Cross DefaultAction Dimension Draw DrawBasedOnThreeCircles DrawExamples Edit File Help Information IOExamples LanguagePreferences Layer LayerExamples LineBoxJoint LineDove LineRadicalAxis ListenerExamples MathExamples Misc Modify ModifyExamples MyScripts PointPole QtExamples Reset ScMirrored Select SelectByHandle Snap SnapXManual SnapYManual SystemExamples TextPreferences ToolBarPreferences View Widgets Window

List of all members.

Public Member Functions

void applyCommand (void event, void preview)
 High level event triggered when a command line command should be applied or previewed.
void applyOperation ()
 Applies the operation returned by this.getOperation().
void beginEvent ()
 Called when the user starts this action by clicking a button, choosing a menu, entering a command, etc.
void commandEvent (void event)
 Default implementation.
void commandEventPreview (void event)
 Default implementation.
void coordinateEvent (void event)
 Default implementation.
void coordinateEventPreview (void event)
 Default implementation.
void createDialog (void uiFile, void parent)
 Creates a new dialog based on the given UI file with the given parent.
void createWidget (void uiFile, void parent)
 Creates a new widget based on the given UI file with the given parent.
void EAction (void guiAction)
void entityPickEvent (void event)
 Default implementation.
void entityPickEventPreview (void event)
 Default implementation.
void escapeEvent ()
 Called when the user presses Escape or clicks the right mouse button.
void finishEvent ()
 Called when this action is terminated.
void getAuxPreview ()
 Called by updatePreview.
void getDocumentInterface ()
void getGraphicsView ()
void getGraphicsViews ()
void getHighlightedEntities ()
 Called by updatePreview.
void getOperation (void preview)
 Called by updatePreview.
void getScales ()
void hideUiOptions (void saveToSettings)
 Hides the UI options of this action.
void initState ()
 Called to initialize a new state of this action.
void initUiOptions (void resume)
 Overwrite to initialize combo boxes and other UI elements of the options tool bar.
void keyPressEvent (void event)
 Called when the user presses a key.
void keyReleaseEvent (void event)
 Called when the user releases a key.
void mousePressEvent (void event)
 Does nothing.
void mouseReleaseEvent (void event)
void pickCoordinate (void event, void preview)
 High level event triggered when a coordinate was specified by the user of a coordinate specification should be previewed.
void pickEntity (void event, void preview)
 High level event triggered when an entity was picked by the user or to preview picking an entity.
void propertyChangeEvent (void event)
 Allows all actions to handle property change events.
void resumeEvent ()
 Called whenver the action resumes its operation, for example after it was temporary suspended for another action.
void setArrowCursor ()
 Sets the current cursor of the current document interface (all views attached to it) to the normal arrow cursor.
void setCommandPrompt (void prompt)
void setCrosshairCursor ()
 Sets the current cursor of the current document interface (all views attached to it) to crosshair cursor.
void setCursor (void cursor, void name)
void setLeftMouseTip (void tip)
void setRightMouseTip (void tip)
void setState (void state)
 Set the state of this action.
void setUiOptions (void uiFile, void split)
 Sets the UI options toolbar content for this tool.
void showUiOptions (void resume, void restoreFromSettings)
 Shows the UI options of this action if this.uiFile is set.
void simulateMouseMoveEvent ()
void slotReset ()
 Called if the user clicks the reset button of an action.
void suspendEvent ()
 Called whenver the action is suspended, for example if another action is started while this action is active.
void updatePreview (void clear)
 Updates the preview based on the operation returned by getOperation and the auxiliary construction returned be getAuxPreview.
- Public Member Functions inherited from RActionAdapter
virtual void commandEvent (RCommandEvent &)
 Called when a command is entered in the command line.
virtual void commandEventPreview (RCommandEvent &)
 Called when a command is being edited in the command line.
virtual void coordinateEvent (RCoordinateEvent &)
 Called for every coordinate event.
virtual void coordinateEventPreview (RCoordinateEvent &)
 Called if the action is in PickCoordinate mode and the mouse is moved around.
virtual void entityPickEvent (REntityPickEvent &)
 
virtual void entityPickEventPreview (REntityPickEvent &)
 
virtual void keyPressEvent (QKeyEvent &)
virtual void keyReleaseEvent (QKeyEvent &)
virtual void mouseDoubleClickEvent (RMouseEvent &)
 Called on mouse double click events.
virtual void mouseMoveEvent (RMouseEvent &)
 Called on mouse move events.
virtual void mousePressEvent (RMouseEvent &)
 Called on mouse press events.
virtual void mouseReleaseEvent (RMouseEvent &)
 Called on mouse release events.
virtual void panGestureEvent (QPanGesture &)
 Called on pan gesture events.
virtual void pinchGestureEvent (QPinchGesture &)
 Called on pinch gesture events.
virtual void propertyChangeEvent (RPropertyEvent &)
 Called when the value of a property is modified while this action is active.
 RActionAdapter (RGuiAction *guiAction=NULL)
virtual void setGraphicsView (RGraphicsView *)
 Called if this action is set as a navigation action of a graphics view.
virtual void swipeGestureEvent (QSwipeGesture &)
 Called on swipe gesture events.
virtual void tabletEvent (RTabletEvent &)
 Called on tablet events.
virtual void wheelEvent (RWheelEvent &)
 Called on mouse wheel events.
- Public Member Functions inherited from RAction
RAction::ClickMode getClickMode ()
RDocumentgetDocument ()
QList< RGraphicsScene * > getGraphicsScenes ()
virtual RGuiActiongetGuiAction ()
RActiongetOverrideBase ()
RStoragegetStorage ()
QString getUniqueGroup ()
bool hasNoState ()
bool isOverride ()
bool isTerminated ()
 RAction (RGuiAction *guiAction=NULL)
 Copyright (c) 2011-2013 by Andrew Mustun.
void setClickMode (RAction::ClickMode m)
 Sets the current click mode.
void setDocumentInterface (RDocumentInterface *di)
void setGuiAction (RGuiAction *guiAction)
void setNoState ()
void setOverride ()
void setOverrideBase (RAction *base)
void setUniqueGroup (const QString &ug)
RVector snap (RMouseEvent &event)
 Uses the currently active snap function to snap to the closest object or grid point.
void terminate ()
 Terminates the action.
virtual ~RAction ()

Public Attributes

int additionalOptionsToolBars
int guiAction
int includeBasePath
int optionsToolBarEnabled
int settingsGroup
int splitUiOptions
int state
int uiFile

Detailed Description

Base class for all ECMAScript based actions.


Constructor & Destructor Documentation

void EAction::EAction ( void  guiAction)
inline

Member Function Documentation

void EAction::applyCommand ( void  event,
void  preview 
)
inline

High level event triggered when a command line command should be applied or previewed.

Reimplemented in DimDiametric, DimRadial, CircleCR, ArcCPA, CircleCP, and EllipseArcCPPA.

void EAction::applyOperation ( )
inline

Applies the operation returned by this.getOperation().

Reimplemented in ClipboardOperation, Delete, and Reverse.

void EAction::beginEvent ( )
inlinevirtual

Called when the user starts this action by clicking a button, choosing a menu, entering a command, etc.

Shows the GUI elements that refer to this action as checked. Displays GUI options if this.uiFile is set to a valid UI file. Displays tool help in Help Viewer if available.

Reimplemented from RActionAdapter.

Reimplemented in PropertyEditor, Print, PrintPreview, AbstractPreferences, ScMirrored, Select, Stretch, Information, NewFile, Dimension, Projection, SnapIntersectionManual, WindowZoom, DrawPolyline, InfoAngle, BreakOut, SnapDistanceManual, CommandLine, InfoArea, SelectContour, SelectIntersectedEntities, DimDiametric, DimRadial, Image, LibraryBrowser, About, InfoDistanceEP, DefaultAction, Line2PEx, Rotate2, Scale, SelectLayerByEntity, ClipboardOperation, BitmapExport, InfoPosition, Bevel, Modify, Rotate, PanZoom, Leader, CheckForUpdates, InfoDistancePP, Mirror, DeselectAll, InvertSelection, SelectAll, LockRelativeZero, SnapCoordinatePolar, SnapDistance, SnapMiddleManual, SnapXManual, SnapYManual, ToggleStatusBar, CreateBlock, CreateLibraryItem, DeselectBlockReferences, EditBlock, EditMainDrawing, HideAllBlocks, RemoveBlock, SelectBlockReferences, ShowAllBlocks, ToggleBlockVisibility, Text, DrawingPreferences, Esc, RecentFiles, SvgImport, BrowseAddOns, BrowseUserManual, FAQ, Forum, ReportBug, ReportTranslationError, ShowReadme, Website, DeselectLayer, SelectLayer, ShowActiveLayer, ToggleLayerVisibility, ExThreePoints, MolImport, MenusAndToolBars, MyAction, PersistentWidgets, Explode, ToBack, ToFront, RestrictHorizontal, RestrictOff, RestrictOrthogonal, RestrictVertical, SnapAuto, SnapCenter, SnapEnd, SnapFree, SnapGrid, SnapIntersection, SnapMiddle, SnapOnEntity, SnapPerpendicular, SnapReference, AutoZoom, CommandLineFocus, OptionsToolBarFocus, PreviousView, ZoomIn, ZoomOut, ZoomToSelection, CloseAll, NextWindow, PreviousWindow, Hatch, LineRectangleSize, Polyline, EditText, LinetypeMode, InsertBlockItem, Arc2PR, Circle2TR, Paste, Translate, IsometricProjection, Snap, InsertBlock, Arc, Arc2PA, Circle, DimAngular, Ellipse, Line, Point, Spline, ArcTangential, Circle2PR, Line2P, LineAngle, LineOrthogonalTangent, LineParallel, LineTangent2, SplineControlPoints, LineBoxJoint, ModifyCorner, Trim, BlockList, EllipseInscribedQuad, Divide, Lengthen, Circle3T, DrawBasedOnThreeCircles, LineParallelThrough, LineTangent1, LineRadicalAxis, PointPole, EditFromReference, Circle2TP, CircleT2P, LineBisector, LineFreehand, LineRelativeAngle, SelectRectangle, Arc3P, Circle2P, Circle3P, CircleCR, LineRectangle, ExAddBlock, LineDove, IsometricGridTop, ToggleGrid, BlockInsert, InsertScriptItem, ArcCPA, EllipseArcCPPA, LinePolygonCP, LinePolygonPP, ExFixBlockNames, ExDrawBoundingBox, ExDrawColors, ExMathSpiral, SelectByHandle, CircleCP, Delete, Save, ExImportPoints, Cross, Reverse, TrimBoth, LayerList, AddBlock, DimAligned, DimOrdinate, DimRegen, DimRotated, LineHorizontal, LineVertical, Point1P, Redo, Undo, OpenFile, SetRelativeZero, SnapCoordinate, CloseFile, PdfExport, AddLayer, HideAllLayers, ShowAllLayers, ExDumpPolyline, ExTransactionListener, ExResizeWindow, ExDirListing, BlockListExport, Reset, RenameBlock, SaveAs, EditLayer, RemoveLayer, ExText, ExLayerWhiteToBlack, ExChangeArcDirection, ExChangeFontToArial, ExMainWindow, and DraftMode.

void EAction::commandEvent ( void  event)
inline

Default implementation.

Calls applyCommand(event, false)

Reimplemented in Line2PEx.

void EAction::commandEventPreview ( void  event)
inline

Default implementation.

Calls applyCommand(event, true)

void EAction::coordinateEvent ( void  event)
inline
void EAction::coordinateEventPreview ( void  event)
inline
void EAction::createDialog ( void  uiFile,
void  parent 
)
inline

Creates a new dialog based on the given UI file with the given parent.

This is a helper function for WidgetFactory.createDialog.

void EAction::createWidget ( void  uiFile,
void  parent 
)
inline

Creates a new widget based on the given UI file with the given parent.

This is a helper function for WidgetFactory.createWidget.

void EAction::entityPickEvent ( void  event)
inline

Default implementation.

Calls pickEntity(event, false)

Reimplemented in SelectLayerByEntity, SelectContour, SnapIntersectionManual, and LineBisector.

void EAction::entityPickEventPreview ( void  event)
inline

Default implementation.

Calls pickEntity(event, true)

Reimplemented in SnapIntersectionManual, SelectContour, SelectLayerByEntity, and LineBisector.

void EAction::finishEvent ( void  )
inlinevirtual

Called when this action is terminated.

Shows the GUI elements that refer to this action as un-checked. Hides GUI options if this.uiFile is set to a valid UI file. Clears up mouse tips, etc.

Reimplemented from RActionAdapter.

Reimplemented in PropertyEditor, PrintPreview, SnapIntersectionManual, WindowZoom, CommandLine, PanZoom, LockRelativeZero, ToggleStatusBar, LibraryBrowser, LinetypeMode, Snap, InsertBlockItem, IsometricGridTop, ToggleGrid, BlockList, InsertScriptItem, LineBisector, DraftMode, and LayerList.

void EAction::getAuxPreview ( )
inline

Called by updatePreview.

Implementations must return an array of RShape objects that should be displayed as auxiliary construction.

Reimplemented in Stretch, DrawPolyline, BreakOut, Scale, Rotate, Mirror, Hatch, Arc2PR, Circle2TR, Paste, Arc2PA, ArcTangential, Circle2PR, LineOrthogonalTangent, LineTangent2, SplineControlPoints, EllipseInscribedQuad, Divide, Circle3T, LineTangent1, ArcCPA, Circle2TP, CircleT2P, EllipseArcCPPA, and Round.

void EAction::getDocumentInterface ( )
inline
Returns:
Reference to the document interface that owns this action or NULL for actions that run on an application level (e.g. file - new).

Reimplemented from RAction.

void EAction::getGraphicsView ( )
inline
void EAction::getGraphicsViews ( )
inline
void EAction::getHighlightedEntities ( )
inline
void EAction::getScales ( )
inline
void EAction::hideUiOptions ( void  saveToSettings)
inline

Hides the UI options of this action.

Usually this function does not need to be called directly by implementing actions.

Parameters:
saveToSettingsif true, the state is saved to settings

Reimplemented in PrintPreview, and Line2PEx.

void EAction::initState ( void  )
inline

Called to initialize a new state of this action.

Overwrite to set mouse tips, show desired toolbars, etc.

Reimplemented in DrawPolyline, LineParallel, LineParallelThrough, and Translate.

void EAction::initUiOptions ( void  resume)
inline

Overwrite to initialize combo boxes and other UI elements of the options tool bar.

Reimplemented in PrintPreview, Dimension, Paste, InsertBlockItem, LineRectangleSize, and InsertBlock.

void EAction::keyPressEvent ( void  event)
inline

Called when the user presses a key.

By default, the event is ignored.

Reimplemented in Line2PEx.

void EAction::keyReleaseEvent ( void  event)
inline

Called when the user releases a key.

By default, the event is ignored.

Reimplemented in Line2PEx.

void EAction::mousePressEvent ( void  event)
inline

Does nothing.

Needs to be implemented here to avoid recursion when child classes call the base class implementation.

Reimplemented in PrintPreview, WindowZoom, PanZoom, DefaultAction, and LineFreehand.

void EAction::mouseReleaseEvent ( void  event)
inline
void EAction::pickCoordinate ( void  event,
void  preview 
)
inline
void EAction::pickEntity ( void  event,
void  preview 
)
inline
void EAction::propertyChangeEvent ( void  event)
inline

Allows all actions to handle property change events.

This is neccessary to ensure that properties can be changed even if a tool is active (e.g. while drawing lines).

void EAction::resumeEvent ( )
inlinevirtual

Called whenver the action resumes its operation, for example after it was temporary suspended for another action.

Reimplemented from RActionAdapter.

Reimplemented in Information, DefaultAction, and CloseFile.

void EAction::setArrowCursor ( )
inline

Sets the current cursor of the current document interface (all views attached to it) to the normal arrow cursor.

void EAction::setCommandPrompt ( void  prompt)
inline
void EAction::setCrosshairCursor ( )
inline

Sets the current cursor of the current document interface (all views attached to it) to crosshair cursor.

void EAction::setCursor ( void  cursor,
void  name 
)
inline
void EAction::setLeftMouseTip ( void  tip)
inline
void EAction::setRightMouseTip ( void  tip)
inline
void EAction::setUiOptions ( void  uiFile,
void  split 
)
inline

Sets the UI options toolbar content for this tool.

By default, a tool shows the options toolbar defined in "DefaultOptions.ui".

Parameters:
uiFileA path to a single UI file or an array of UI file paths.
splitIf true, the options are split up into multiple toolbars.
void EAction::showUiOptions ( void  resume,
void  restoreFromSettings 
)
inline

Shows the UI options of this action if this.uiFile is set.

UI options are typically shown in a horizontal toolbar at the top of the drawing area.

Usually this function does not need to be called directly by implementing actions.

Parameters:
resumeAction was resumed from suspension.
restoreFromSettingsRestore settings from document / config file (default).
void EAction::simulateMouseMoveEvent ( )
inline
void EAction::slotReset ( )
inline

Called if the user clicks the reset button of an action.

A reset button may be displayed as part of the UI options of this action and must have the object name "Reset".

Reimplemented in BlockInsert, and InsertBlock.

void EAction::suspendEvent ( )
inlinevirtual

Called whenver the action is suspended, for example if another action is started while this action is active.

Reimplemented from RActionAdapter.

Reimplemented in PrintPreview, and DefaultAction.

void EAction::updatePreview ( void  clear)
inline

Updates the preview based on the operation returned by getOperation and the auxiliary construction returned be getAuxPreview.

Parameters:
clearTrue to clear the preview first. This is necessary if the preview is updated not as a result of a mouse move event, e.g. when changing action parameters in the options toolbar.

Member Data Documentation

int EAction::additionalOptionsToolBars
int EAction::guiAction

Reimplemented from RAction.

int EAction::includeBasePath
int EAction::optionsToolBarEnabled
int EAction::settingsGroup
int EAction::splitUiOptions
int EAction::uiFile

The documentation for this class was generated from the following file: