1.8.1. Typical Platform Regions

This document details a list of common regions required for a new Platform instance. In many cases, using these names for the described purpose will let the new class inherit the right functionality.

The regions should typically be stored with the following directory structure under the images/ directory and in the directory for the right image type (most often qemu/).

ConsoleUser Platform Regions

Region Name	Description
atBottom	Indicates the scroll bar is at the bottom.
atTop	Indicates the scroll bar is at the top.
cancelButton	The system default “Cancel” button.
cancelCtrlAltDel	After hitting Ctrl+Alt+Del we may want to cancel that, and this region shows how.
cornerBottomLeft	Identifies the bottom left corner of a window
cornerBottomRight	Identifies the bottom right corner of a window
cornerUpperRight	Identifies the upper right corner of the window
downArrow	The default down arrow in a scroll bar
fileNameField	The region that will find the area to enter the file name in my system dialogs.
leftArrow	The default left arrow in a scroll bar
lockButton	Button to lock the desktop/system
maximizeButton	The button that will maximize a window
minimizeButton	The button that will minimize a window
noFileDialog	Indicates an error dialog because a target file could not be found (e.g., to load into an app)
noPathDialog	Indicates an error dialog because the path could not be found (e.g., to save a file into)
okButton	The default OK button
onSplashScreen	Indicates that the startup splash screen is visible.
openDialogTitle	Indicates a dialog is showing to select a file to open.
otherUserIcon	The place on a login screen to select “other” usually allowing the username to be entered
passwordField	The region that will find the area to enter the login password
replaceButton	The button to choose to replace a file
replaceDialog	Indicates a dialog is open asking if we want to replace an existing file or not
restartButton	The button that will initiate a system restart
restoreButton	The button that will restore a maximized window
rightArrow	The default right arrow in a scroll bar
saveAsDialogTitle	Indicates a dialog is open asking for the new file name to save as
shutdownButton	The button to open the “shutdown” menu
shuttingDownLabel	A region indicating that a shutdown is in progress
signOutButton	The button to have the current user sign out
startMenu	The button that opens the main OS menu, on Windows it’s Start, others it’s Activities etc.
startMenuShining	An alternate view for the start menu when it is shining or highlighted
submitLoginButton	Button to submit a login attempt
upArrow	The default up arrow in a scroll bar
updatingLabel	A region indicating the OS is being updated
warningDialog	A general region showing there is a warning dialog of some sort.
XButtonFocused	The “X” button to close a window when that window has focus
XButtonUnfocused	The “X” button to close a window when that window does not have focus
yesButton	The default Yes button

Of course, most platforms will require some deviation for this list, either for additional common buttons or for alternate versions of some of these that do not have alternates on other systems.