Example

====== Delete Workspace X ======

^ by: | Sebastian Beutel |
^ published: | June 2018 |
^ description: | deletes a designated workspace |

{{tag>delete workspace handle}}

==== functions ====
  * [[:macros:function:ActionScript.SetProperty.Boolean]]
  * [[:macros:function:Handles.SetSourceHandle]]
  * [[:macros:function:Handles.ConfirmDelete]]

==== affected properties ====
  * [[:macros:property:Handles.AllowEditWorkspaces]]
 
===== Code =====
<code xml DeleteWorkspace.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="Avolites.Menus.xsd">
<macro id="UserMacro.sb_delWs2">
  <name>sb delete ws 2</name>
  <sequence>
    <step pause="0.001">ActionScript.SetProperty.Boolean("Handles.AllowEditWorkspaces", true)</step>
    <step pause="0.001">Handles.SetSourceHandle("Workspaces", 2)</step>
    <step pause="0.001">Handles.ConfirmDelete()</step>
    <step pause="0.001">ActionScript.SetProperty.Boolean("Handles.AllowEditWorkspaces", false)</step>
  </sequence>
</macro>
</avolites.macros>
</code>


===== Explanation =====

This explains the functional steps within the sequence. For all the other XML details please refer to [[:macros:formats_and_syntax#xml_format|Formats and syntax]]
  * ''ActionScript.SetProperty.Boolean("Handles.AllowEditWorkspaces", true)'' unlocks the workspaces to be edited/deleted
  * ''Handles.SetSourceHandle("Workspaces", 2)'' marks the workspace #3 as sourHandle for the next operation
  * ''Handles.ConfirmDelete()'' deletes the previously selected handle (the workspace #3)
  * ''ActionScript.SetProperty.Boolean("Handles.AllowEditWorkspaces", false)'' locks the workspaces from being edited/deleted


===== How to use it =====

  * [[:macros:deploying|make this macro available]]
  * while it may be interesting to delete a workspace by individual macro, a good use case is shown in [[macros:example:createworkspaces|]]

~~DISCUSSION~~