<doc>

<legacy_id>1782</legacy_id>

<name>hide taskbar</name>

<type>command</type>

<syntax>

<example>hide taskbar</example>

</syntax>

<library></library>

<objects>

</objects>

<synonyms>

</synonyms>

<classification>

<category>The System Environment</category>

</classification>

<references>

<command tag="show taskbar">show taskbar Command</command>

<command tag="hide menubar">hide menubar Command</command>

</references>

<history>

<introduced version="2.1">Added.</introduced>

<changed version="5.5.3"></changed>

</history>

<platforms>

<windows/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

</classes>

<security>

</security>

<summary>Hides the <glossary tag="task bar">task bar</glossary> on <glossary tag="Windows">Windows systems</glossary>.</summary>

<examples>

<example>hide taskbar</example>

<example>if the hilite of button "Kiosk Mode" then hide taskbar</example>

</examples>

<description>

<p>Use the <b>hide taskbar</b> <glossary tag="command">command</glossary> to use the full screen. For example, in a kiosk or multimedia application, the <glossary tag="task bar">task bar</glossary> is a distraction for users and in this case you may prefer to hide it.</p><p/><p>

The <b>hide taskbar</b> <glossary tag="command">command</glossary> can produce unexpected result when used in conjunction with <property tag="backdrop">backdrop</property> operations. The following syntax is supported:</p><p/><p>

hide taskbar</p><p>

set the backdrop to "red" -- or whatever you want</p><p/><p>

This is the case where the <property tag="backdrop">backdrop</property> is visible but the taskbar is hidden when the application is active.

After these two commands, the taskbar is hidden for the LiveCode application, the backdrop fills the screen and the taskbar reappears when switching to other applications.</p><p/><p>

Functionality that is partially functional, due to the lack of operating system support and works sufficiently well for restricted applications is as follows:</p><p/><p>

If the taskbar is visible before showing the backdrop, the backdrop occupies the 'working rect' of the screen, or almost the working rect of the screen if the taskbar is set to auto-hide. In the latter case, a small gap is left at the bottom of the backdrop to ensure the taskbar can still pop up when the mouse is moved to the edge of the screen.</p><p/><p>

<b>Comments:</b></p><p>The task bar can be hidden only on Windows systems. This command has no effect on Mac OS, OS X, or Unix systems.</p>

</description>

</doc>