Editing Guide to XML frames part2 (section)

== Closing up shop ==
While we are on the subject of buttons, lets add a close button to our frame so that the user can completely remove the frame from the screen. Admitedly, there is an ulterior motive for doing this as you'll see in the next section, but for now lets pretend we want to allow the player to remove the frame from the screen.

We've seen that RoM provides many templates for creating interface panels and one of these virtual objects is a close button. The advantage for the user is that by using this template, the close button will look like every other close button the player has seen in the game and will instantly know what it is and how it is supposed to work. For add-on developers the advantage is that it is pretty much complete and all we really need to do is to tell the game where to anchor the button on our frame.

As this is a close button, we need to add it to the <code>Frames</code> section of our frame definition. Add the following:

<code><pre>
			<Button name="$parentCloseButton" inherits="UIPanelCloseButtonTemplate">
				<Anchors>
					<Anchor point="TOPRIGHT" relativePoint="TOPRIGHT">
						<Offset>							
							<AbsDimension x="-5" y="6"/>
						</Offset>
					</Anchor>
				</Anchors>
			</Button>
</pre></code>

That's all we need to do to get a working close button. All relevant scripts and code snippets are already defined by <code>UIPanelCloseButtonTemplate</code> so no other modifications to our code is needed to make it work.

To get the window back after closing it, type the command <code>/run MemViewerFrame:Show()</code> in the chat edit box.


=== Opening shop again ===
So adding a close button was simple enough but to make it convenient to get it back we should really add a slash command. We won't discuss slash commands themselves as this is a tutorial on frames and they are also covered in the add-on tutorial on the RoM Wiki.

We'll need to add this in our Lua file so open <code>MemViewer.lua</code> and add the following after we create the main variable:

<code><pre>
--[[ Slash command handler ]]--

SLASH_MemViewer1 = "/mview";
SlashCmdList["MemViewer"] = function(ebox, msg)
    if(MemViewerFrame:IsVisible()) then
        MemViewerFrame:Hide();
    else
        MemViewerFrame:Show();
    end
end
</pre></code>

This will toggle our frame on and off each time we type <code>/mview</code> in the chat edit box. What we need to note here is how the code is verifying if the frame is visible, and how it shows or hides the frame.