1f97345e35
Further debugging functionality for KWin scripts. Added assert methods validate the to be tested parameter and throw a script error if the value is not valid. Following methods are available: * assert(value) * assertTrue(boolean) * assertFalse(boolean) * assertEquals(expected, actual) * assertNull(nullValue) * assertNotNull(notNullValue) All methods take an additional optional parameter which is used as the error message if provided. Methods to validate the number of arguments and types of the parameters are added and throw syntax or type errors. REVIEW: 104870
102 lines
6.7 KiB
XML
102 lines
6.7 KiB
XML
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
|
|
<doxygen xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="compound.xsd" version="1.7.6.1">
|
|
<!-- Documentation for global KWin scripting methods. In doxygen XML format as this can be converted to MediaWiki -->
|
|
<!-- Use script and XSLT from kde:scratch/graesslin/kwin-scripting-api-generator to generate the documentation -->
|
|
<!-- This xml is not meant to be doxygen complient -->
|
|
<compounddef>
|
|
<compoundname>Global</compoundname>
|
|
<briefdescription>Methods and properties added to the global JavaScript object.</briefdescription>
|
|
<sectiondef kind="property">
|
|
<memberdef kind="property" writable="no">
|
|
<type>KWin::Options</type>
|
|
<definition></definition>
|
|
<argsstring></argsstring>
|
|
<name>options</name>
|
|
<read></read>
|
|
<detaileddescription>Global property to all configuration values of KWin core.</detaileddescription>
|
|
</memberdef>
|
|
<memberdef kind="property" writable="no">
|
|
<type>KWin::Workspace</type>
|
|
<definition></definition>
|
|
<argsstring></argsstring>
|
|
<name>workspace</name>
|
|
<read></read>
|
|
<detaileddescription>Global property to the core wrapper of KWin.</detaileddescription>
|
|
</memberdef>
|
|
</sectiondef>
|
|
<sectiondef kind="public-func">
|
|
<memberdef kind="function">
|
|
<type>Q_SCRIPTABLE void</type>
|
|
<definition>void KWin::Scripting::print</definition>
|
|
<argsstring>(QVariant ... values)</argsstring>
|
|
<name>print</name>
|
|
<read></read>
|
|
<detaileddescription>Prints all provided values to kDebug and as a D-Bus signal</detaileddescription>
|
|
</memberdef>
|
|
<memberdef kind="function">
|
|
<type>Q_SCRIPTABLE QVariant</type>
|
|
<definition>QVariant KWin::Scripting::readConfig</definition>
|
|
<argsstring>(QString key, QVariant defaultValue = QVariant())</argsstring>
|
|
<name>readConfig</name>
|
|
<read></read>
|
|
<detaileddescription>Reads the config value for key in the Script's configuration with the optional default value. If not providing a default value and no value stored in the configuration an undefined value is returned.</detaileddescription>
|
|
</memberdef>
|
|
<memberdef kind="function">
|
|
<type>Q_SCRIPTABLE bool</type>
|
|
<definition>bool KWin::Scripting::registerShortcut</definition>
|
|
<argsstring>(QString title, QString text, QString keySequence, QScriptValue callback)</argsstring>
|
|
<name>registerShortcut</name>
|
|
<read></read>
|
|
<detaileddescription>Registers keySequence as a global shortcut. When the shortcut is invoked the callback will be called. Title and text are used to name the shortcut and make it available to the global shortcut configuration module.</detaileddescription>
|
|
</memberdef>
|
|
<memberdef kind="function">
|
|
<type>Q_SCRIPTABLE bool</type>
|
|
<definition>bool KWin::Scripting::assert</definition>
|
|
<argsstring>(bool value, QString message = QString())</argsstring>
|
|
<name>assert</name>
|
|
<read></read>
|
|
<detaileddescription>Aborts the execution of the script if value does not evaluate to true. If message is provided an error is thrown with the given message, if not provided an error with default message is thrown.</detaileddescription>
|
|
</memberdef>
|
|
<memberdef kind="function">
|
|
<type>Q_SCRIPTABLE bool</type>
|
|
<definition>bool KWin::Scripting::assertTrue</definition>
|
|
<argsstring>(bool value, QString message = QString())</argsstring>
|
|
<name>assertTrue</name>
|
|
<read></read>
|
|
<detaileddescription>Aborts the execution of the script if value does not evaluate to true. If message is provided an error is thrown with the given message, if not provided an error with default message is thrown.</detaileddescription>
|
|
</memberdef>
|
|
<memberdef kind="function">
|
|
<type>Q_SCRIPTABLE bool</type>
|
|
<definition>bool KWin::Scripting::assertFalse</definition>
|
|
<argsstring>(bool value, QString message = QString())</argsstring>
|
|
<name>assertFalse</name>
|
|
<read></read>
|
|
<detaileddescription>Aborts the execution of the script if value does not evaluate to false. If message is provided an error is thrown with the given message, if not provided an error with default message is thrown.</detaileddescription>
|
|
</memberdef>
|
|
<memberdef kind="function">
|
|
<type>Q_SCRIPTABLE bool</type>
|
|
<definition>bool KWin::Scripting::assertEquals</definition>
|
|
<argsstring>(QVariant expected, QVariant actual, QString message = QString())</argsstring>
|
|
<name>assertEquals</name>
|
|
<read></read>
|
|
<detaileddescription>Aborts the execution of the script if the actual value is not equal to the expected value. If message is provided an error is thrown with the given message, if not provided an error with default message is thrown.</detaileddescription>
|
|
</memberdef>
|
|
<memberdef kind="function">
|
|
<type>Q_SCRIPTABLE bool</type>
|
|
<definition>bool KWin::Scripting::assertNull</definition>
|
|
<argsstring>(QVariant value, QString message = QString())</argsstring>
|
|
<name>assertNull</name>
|
|
<read></read>
|
|
<detaileddescription>Aborts the execution of the script if value is not null. If message is provided an error is thrown with the given message, if not provided an error with default message is thrown.</detaileddescription>
|
|
</memberdef>
|
|
<memberdef kind="function">
|
|
<type>Q_SCRIPTABLE bool</type>
|
|
<definition>bool KWin::Scripting::assertNotNull</definition>
|
|
<argsstring>(QVariant value, QString message = QString())</argsstring>
|
|
<name>assertNotNull</name>
|
|
<read></read>
|
|
<detaileddescription>Aborts the execution of the script if value is null. If message is provided an error is thrown with the given message, if not provided an error with default message is thrown.</detaileddescription>
|
|
</memberdef>
|
|
</sectiondef>
|
|
</compounddef>
|
|
</doxygen>
|