dwww Home | Show directory contents | Find package

<FILENAME filename="index.html"><html><head><title>Device Actions</title><link rel="stylesheet" type="text/css" href="help:/kdoctools5-common/kde-default.css"><link rel="stylesheet" type="text/css" href="help:/kdoctools5-common/kde-docs.css"><link rel="stylesheet" type="text/css" href="help:/kdoctools5-common/kde-localised.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><meta name="keywords" content="Plasma, System Settings, Solid, actions, devices, hardware"><link rel="home" href="index.html" title="Device Actions"><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="GENERATOR" content="KDE XSL Stylesheet V1.14 using libxslt"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div id="content"><div id="header"><div id="header_content"><div id="header_left"><div id="header_right"><img src="help:/kdoctools5-common/top-kde.jpg" width="36" height="34"> Device Actions</div></div></div></div><div class="navCenter"><table class="navigation"><tr><td class="prevCell"></td><td class="upCell"> </td><td class="nextCell"></td></tr></table></div><div id="contentBody"><div lang="en" class="article"><div class="titlepage"><div><div><h2 class="title"><a name="solid-actions"></a>Device Actions</h2></div><div><div class="authorgroup"><p class="author"><span class="firstname">Ben</span> <span class="surname">Cooksley</span> </p><p class="author"><span class="firstname">Anne-Marie</span> <span class="surname">Mahfouf</span> </p></div></div><div>Revision <span class="releaseinfo"><span class="productname">Plasma<br></span> 5.14 (<span class="date">2018-12-10</span>)</span></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="index.html#kcm_solid_actions">Actions for new devices</a></span></dt><dd><dl><dt><span class="sect2"><a href="index.html#icons-intro">Introduction</a></span></dt><dt><span class="sect2"><a href="index.html#add-action">Add Action</a></span></dt><dt><span class="sect2"><a href="index.html#edit-action">Edit Action</a></span></dt></dl></dd></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="kcm_solid_actions"></a>Actions for new devices</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="icons-intro"></a>Introduction</h3></div></div></div><p>This module allows you to set up the actions you want to associate when
you plug new devices.</p><p>
</p><div class="screenshot"><div xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="mediaobject"><img src="main.png" alt="Screenshot of the Device Actions Manager"></div></div><p>
</p><p>You will see listed all of the possible actions that are available when
devices are plugged in.
Please note that they will only be available under certain conditions.</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">Add</span></span>
   This will ask you to supply a name for your new action, then will open that
action for editing.
   If you do not supply all the required details in that dialog, then your
action will be deleted.
</p></li><li class="listitem"><p>
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">Edit</span></span>
   This will allow you to change the Name, Icon, command to execute 
   and the conditions the action must match to be shown. 
</p></li><li class="listitem"><p>
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">Discard / Cannot be deleted / Remove</span></span>
   This will do different actions, depending on if it was supplied with your
system or created by you.
   You can only discard changes to system wide actions, if there are no changes
then these actions cannot be deleted.
   User created actions are completely removed, including all changes.
</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="add-action"></a>Add Action</h3></div></div></div><p>
The <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">Add</span></span> button brings you a dialog to enter the
new action name.
</p><p>
</p><div class="screenshot"><div xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="mediaobject"><img src="add-action.png" alt="Screenshot of the Add Action dialog"></div></div><p>
</p><p>
The action name should correctly describe the action. After entering a name and
clicking <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">OK</span></span>, the Edit Action dialog will show to allow
you to set up the action properties.
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="edit-action"></a>Edit Action</h3></div></div></div><p>This dialog allows you to change the settings of the action you
selected.</p><p>
</p><div class="screenshot"><div xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="mediaobject"><img src="edit-action.png" alt="Screenshot of the Edit Action dialog"></div></div><p>
</p><p>
This includes the icon, the action name, the action command and the various
parameters.
You can change the icon by clicking on it.</p><p>The parameters are displayed in a
tree, the top item having to be true in order for the action to be shown.</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="edit-parameter"></a>Edit parameter</h4></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Parameter type</span></span></span></dt><dd><p>This controls what can be contained inside it, or
what matching is performed to check if it is true.

</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Property Match</span></span></span></dt><dd><p>Compares the specified property of the Device (using 
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Device type</span></span> and <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Value name</span></span>) and using the evaluator, compares it against the
text provided.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Content Conjunction</span></span></span></dt><dd><p>All sub-properties of this must be true for
it to be true itself.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Content Disjunction</span></span></span></dt><dd><p>Any sub-property of this may be true for it
to be true itself.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Device interface match</span></span></span></dt><dd><p>Checks to see if the Device can be
classed as the selected Device type.</p></dd></dl></div><p>
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Device type</span></span></span></dt><dd><p>These are the possible device types supported by <span class="productname">Plasma</span> on
your system.
They are used in both Property and Device interface matches.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Value name</span></span></span></dt><dd><p>This is a list of all possible property names for the
selected device type.
It also provides the selection of the value evaluator (which is either 
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Equals</span></span> or <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Contains</span></span>), and allows
entry of the text to be compared with.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">Reset Parameter</span></span></span></dt><dd><p>Reverts any unsaved changes you have made to this parameter.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">Save Parameter changes</span></span></span></dt><dd><p>Saves the changes you have made to the parameter.</p></dd></dl></div></div></div></div></div></div><div id="footer"><div class="navCenter"><table class="navigation"><tr><td class="prevCell"></td><td class="upCell"> </td><td class="nextCell"></td></tr><tr><td class="prevCell"> </td><td class="upCell"> </td><td class="nextCell"> </td></tr></table></div><div id="footer_text">Would you like to make a comment or contribute an update to this page?<br>Send feedback to the <a href="mailto:kde-doc-english@kde.org" class="footer_email">KDE Docs Team</a></div></div></div></body></html></FILENAME>

Generated by dwww version 1.15 on Sun Jun 16 05:08:57 CEST 2024.