WA_Left, WA_Top, WA_Width and WA_Height
Describe where the window will first appear on the screen and how
large it will be initially. These dimensions are relative to the top
left corner of the screen, which has the coordinates (0,0).
WA_Left is the initial x position, or offset, from the left edge of
the screen. The leftmost pixel is pixel 0, and values increase to
the right. Equivalent to newwindow.leftedge.
WA_Top is the initial y position, or offset, from the top edge of the
screen. The topmost pixel is pixel 0, and values increase to the
bottom. Equivalent to newwindow.topedge.
WA_Width is the initial window width in pixels. Equivalent to
newwindow.width.
WA_Height is the initial window height in lines. Equivalent to
newwindow.height.
WA_DetailPen and WA_BlockPen
WA_DetailPen specifies the pen number for the rendering of window
details like gadgets or text in the title bar. WA_BlockPen specifies
the pen number for window block fills, like the title bar. These
pens are also used for rendering menus. Equivalent to
newwindow.detailpen and newwindow.blockpen.
The specific color associated with each pen number depends on the
screen. Specifying -1 for these values sets the window's detail and
block pen the same as the screen's detail and block pen.
Detail pen and block pen have largely been replaced starting with V36
by the pen array in the drawinfo structure. see the section on
"drawinfo and the 3d look" in the "intuition screens" chapter for
more information.
WA_IDCMP
IDCMP flags tell Intuition what user input events the application
wants to be notified about. The IDCMP flags are listed and described
in the openwindowtaglist() description in the amiga rom kernel
Reference Manual: Includes and Autodocs and in the chapter
"intuition input and output methods" in this book. equivalent to
newwindow.idcmpflags.
If any of these flags are set, Intuition creates a pair of message
ports for the window (one internal to Intuition and one used by the
application). These ports are for handling messages about user input
events. If WA_IDCMP is NULL or unspecified, no IDCMP is created for
this window.
The modifyidcmp() function can be used to change the window's idcmp
flags after it is open.
WA_Gadgets
A pointer to the first in the linked list of gadget structures that
are to be included in this window. These gadgets are application
gadgets, not system gadgets. See the "intuition gadgets" chapter for
more information. Equivalent to newwindow.firstgadget.
WA_Checkmark
A pointer to an image structure, which is to be used as the checkmark
image in this window's menus. To use the default checkmark, do not
specify this tag or set this field to NULL. Equivalent to
newwindow.checkmark.
WA_Title
A pointer to a NULL terminated text string, which is used as the
window title and is displayed in the window's title bar.
Intuition draws the text using the colors defined in the drawinfo pen
array (DrawInfo.dri_Pens) and displays as much as possible of the
window title, depending upon the current width of the title bar.
Equivalent to newwindow.title. see the section on
"drawinfo and the 3d look" in the "intuition screens" chapter for
more information on the pen array.
The title is rendered in the screen's default font.
A title bar is added to the window if any of the properties
wa_dragbar (wflg_dragbar), wa_depthgadget (wflg_depthgadget),
wa_closegadget (wflg_closegadget) or wa_zoom are specified, or if
text is specified for a window title. If no text is provided for the
title, but one or more of these system gadgets are specified, the
title bar will be blank. Equivalent to newwindow.title.
WA_ScreenTitle
A pointer to a NULL terminated text string, which is used as the
screen title and is displayed, when the window is active, in the
screen's title bar. After the screen has been opened the screen's
title may be changed by calling setwindowtitles() (which is the only
method of setting the window's screen title prior to V36).
WA_CustomScreen
A pointer to the screen structure of a screen created by this
application. The window will be opened on this screen. The custom
screen must already be opened when the openwindowtaglist() call is
made. Equivalent to newwindow.screen, also implies newwindow.type of
CUSTOMSCREEN.
WA_MinWidth, WA_MinHeight, WA_MaxWidth and WA_MaxHeight
These tags set the minimum and maximum values to which the user may
size the window. If the flag wflg_sizegadget is not set, then
these variables are ignored. Values are measured in pixels. Use
(~0) for the WA_MaxWidth (WA_MaxHeight) to allow for a window as wide
(tall) as the screen. This is the complete screen, not the visible
part or display clip.
Setting any of these variables to 0, will take the setting for that
dimension from its initial value. For example, setting MinWidth to
0, will make the minimum width of this window equal to the initial
width of the window.
Equivalent to newwindow.minwidth, newwindow.minheight,
NewWindow.MaxWidth and NewWindow.MaxHeight. Use the windowlimits()
function to change window size limits after the window is opened.
WA_InnerWidth and WA_InnerHeight
Specify the dimensions of the interior region of the window, i.e.,
inside the border, independent of the border widths. When using
WA_InnerWidth and WA_InnerHeight an application will probably want to
set wa_autoadjust.
WA_PubScreen
Open the window as a visitor window on the public screen whose
address is in the ti_Data field of the WA_PubScreen tagitem. to
ensure that this screen remains open until openwindowtaglist() has
completed, the application must either be the screen's owner, have a
window open on the screen, or use lockpubscreen(). setting this tag
implies screen type of PUBLICSCREEN.
WA_PubScreenName
Declares that the window is to be opened as a visitor on the public
screen whose name is pointed to by the ti_Data field of the
WA_PubScreenName tagitem. the openwindowtaglist() call will fail if
it cannot obtain a lock on the named public screen and no fall back
name (WA_PubScreenFallBack) is specified. Setting this tag implies
screen type of PUBLICSCREEN.
WA_PubScreenFallBack
A Boolean, specifies whether a visitor window should "fall back" to
the default public screen (or Workbench) if the named public screen
isn't available This tag is only meaningful when used in conjunction
with WA_PubScreenName.
WA_Zoom
Pointer to an array of four WORDs, the initial leftedge, topedge,
width and height values for the alternate zoom position and size. it
also specifies that the application wants a zoom gadget for the
window, whether or not it has a sizing gadget.
A zoom gadget is always supplied to a window if it has both depth and
sizing gadgets. This tag allows the application to open a window
with a zoom gadget when the window does not have both the depth and
sizing gadgets.
WA_MouseQueue
An initial value for the mouse message backlog limit for this window.
The setmousequeue() function will change this limit after the window
is opened.
WA_RptQueue
An initial value of repeat key backlog limit for this window.