Example

====== Search ShowLibrary ======

^ by: | Sebastian Beutel |
^ published: | March 2018 |
^ description: | opens the ShowLibrary with a specific search string. |
^ remarks: | Idea by Alex del Bondio, see https://www.facebook.com/groups/1811437589141428/permalink/2067393396879178/ |

{{tag>ShowLibrary Search}}

==== functions ====
  * [[:macros:function:ActionScript.SetProperty]]

==== affected properties ====
  * [[:macros:property:Windows.ShowLibrary.SelectedFilter]]
  * [[:macros:property:Windows.ShowLibrary.FilterText]]

==== control structures ====
  * [[macros:control_structures:menulink|menuLink]]
 
===== Code =====
<code xml showlib_abc.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="Avolites.Menus.xsd">
<!-- Sets Search to 'abc', filter to 'Macros', and opens the show library -->
  <macro id="UserMacro.ShowLibAbc">
    <name>ShowLib abc</name>
    <sequence>
      <step pause="0.001">ActionScript.SetProperty("Windows.ShowLibrary.SelectedFilter","Macros")</step>
      <step pause="0.001">ActionScript.SetProperty("Windows.ShowLibrary.FilterText","abc")</step>
      <step pause="0.001"><menuLink id="Windows.ShowLibrary" stack="mainWindowStack" behaviour="PushOrRaise" /></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("Windows.ShowLibrary.SelectedFilter","Macros")'' sets the filter of the ShowLibrary workspace window to 'Macros'.\\
''ActionScript.SetProperty("Windows.ShowLibrary.FilterText","abc")'' sets a specific search text. Alter 'abc' to your needs.\\
''<menuLink id="Windows.ShowLibrary" stack="mainWindowStack" behaviour="PushOrRaise" />'' finally brings up the ShowLibrary workspace window with the set filter and search.


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

  * [[:macros:deploying|make this macro available]]
  * you might want to adjust 'abc' to your needs. E.g. if you decide to give all you preferred macros a specific prefix the this macro lets you quickly find them.


~~DISCUSSION~~