Encapsulates a DAZ Script script context.

More...

Inherits :

• QObject
  • DzBase

All DzScripts are executed in the context of a DzScriptContext instance - therefore, all the properties and methods on DzScriptContext are accessible to a script as global functions and variables. It will usually not be necessary for a script to create or use this class directly.

---

void : acceptUndo( String caption )

Accept and finish a hold on the undo stack started by calling beginUndo().

See Also:

• Global::acceptUndo()

---

Boolean : backgroundProgressIsActive()

Return Value:

• true if there is an active background progress operation in the application, otherwise false.

See Also:

• Global::backgroundProgressIsActive()

---

Boolean : backgroundProgressIsCancelled()

Return Value:

• true if the user canceled the current background progress operation in the application, otherwise false.

See Also:

• Global::backgroundProgressIsCancelled()

---

void : beginNodeSelectionHold()

Captures a view of scene seletion.

See Also:

• Global::beginNodeSelectionHold()

Since:

• 4.9.4.109

---

void : beginUndo()

Starts a hold on the undo stack.

See Also:

• Global::beginUndo()

---

void : cancelUndo()

Cancel a hold on the undo stack started by calling beginUndo().

See Also:

• Global::cancelUndo()

---

void : clearBusyCursor()

Clears the application-standard busy cursor and returns the mouse cursor to the previous cursor. Match every call to setBusyCursor() with a call to this function.

See Also:

• Global::clearBusyCursor()

---

void : clearNodeSelectionHolds()

Clears all selection holds without restoring the selection.

See Also:

• Global::clearNodeSelectionHolds()

Since:

• 4.9.4.109

---

void : clearOverrideCursor()

Clears the override cursor stack.

See Also:

• Global::clearOverrideCursor()

Since:

• 4.6.4.30

---

void : clearUndoStack()

Clears the undo stack.

See Also:

• Global::clearUndoStack(), DzUndoStack::clearAll()

---

void : dropNodeSelectionHold()

Removes a scene node selection hold on scene selection without restoring the selection.

See Also:

• Global::dropNodeSelectionHold()

Since:

• 4.9.4.109

---

void : dropUndo()

Drops a hold on the undo stack started by calling beginUndo().

See Also:

• Global::dropUndo()

---

void : finishBackgroundProgress()

Ends the current background progress operation in the application from script.

See Also:

• Global::finishBackgroundProgress()

---

void : finishProgress()

Ends the current progress operation in the application from script.

See Also:

• Global::finishProgress()

---

Array : getArguments()

Return Value:

• The list of arguments for the current script execution.

See Also:

• Global::getArguments()

---

String : getErrorMessage( Number errCode )

This function converts an error code into a string message.

Return Value:

• A user-readable message that describes the error represented by the error code.

See Also:

• Global::getErrorMessage()

---

QObject : getObjectParent( QObject obj )

Return Value:

• The QObject parent of obj.

---

DzAuthor : getScriptAuthor()

Return Value:

• The author of the current script (if any), otheriwse and empty string.

See Also:

• Global::getScriptAuthor()

---

String : getScriptFileName()

Return Value:

• The file name of the current script (if any), otherwise an empty string.

See Also:

• Global::getScriptFileName()

---

String : getScriptType()

Return Value:

• The file type that this script was saved out as.

See Also:

• Global::getScriptType()

---

String : getScriptVersionString()

Return Value:

• The version of the current script (if any).

See Also:

• Global::getScriptVersionString()

---

Boolean : pointersAreEqual( QObject ptr1, QObject ptr2 )

This function allows a script to test if two QObject-derived variables point to the same instance.

Return Value:

• true if the pointers point to the same object, otherwise false.

See Also:

• Global::pointersAreEqual()

---

void : processEvents()

Pauses execution of the script and allows the GUI thread time to process events.

See Also:

• Global::processEvents()

---

Boolean : progressIsActive()

Return Value:

• true if there is an active progress operation in the application, otherwise false.

See Also:

• Global::progressIsActive()

---

Boolean : progressIsCancelled()

Return Value:

• true if the user cancelled the current progress operation in the application, otherwise false.

See Also:

• Global::progressIsCancelled()

---

void : restoreNodeSelectionHold()

Restores the scene selection to the view at last call to beginNodeSelectionHold().

See Also:

• Global::restoreNodeSelectionHold()

Since:

• 4.9.4.109

---

void : setBusyCursor()

Sets the application-standard busy cursor. Match every call to this function with a call to clearBusyCursor() to restore the previous cursor.

See Also:

• Global::setBusyCursor()

---

void : sleep( Number milliseconds )

Pauses the script for the specified number of milliseconds without blocking the application event loop.

See Also:

• Global::sleep()

Since:

• 4.8.0.45

---

void : startBackgroundProgress( String info, Number totalSteps=0, Boolean isCancellable=false )

Starts a background progress operation in the application from script.

See Also:

• Global::startBackgroundProgress()

---

void : startProgress( String info, Number totalSteps=0, Boolean isCancellable=false, Boolean showTimeElapsed=false )

Starts a progress operation in the application from script.

See Also:

• Global::startProgress()

---

void : stepBackgroundProgress( Number numSteps=1 )

Steps the current background progress operation in the application from script.

See Also:

• Global::stepBackgroundProgress()

---

void : stepProgress( Number numSteps=1 )

Steps the current progress operation in the application from script.

See Also:

• Global::stepProgress()

---

void : updateBackgroundProgress( Number position )

Updates the background current progress operation in the application from script.

See Also:

• Global::updateBackgroundProgress()

---

void : updateProgress( Number position )

Updates the current progress operation in the application from script.

See Also:

• Global::updateProgress()

---

Boolean : shiftPressed()

Deprecated

Exists only to keep old code working. Do not use in new code. Use DzApp::modifierKeyState() instead.

var bShiftPressed = App.modifierKeyState() & 0x02000000;

---

Boolean : ctrlPressed()

Deprecated

Exists only to keep old code working. Do not use in new code. Use DzApp::modifierKeyState() instead.

var bControlPressed = App.modifierKeyState() & 0x04000000;

---

QDesktopWidget (deprecated) : getDesktop()

Deprecated

Exists only to keep old code working. Do not use in new code. Use DzDesktopWidget instead.

var wDesktop = new DzDesktopWidget();