a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 workbench.library
  AddAppIconA
  AddAppMenuItemA
  AddAppWindowA
  AddAppWindowDropZoneA
  ChangeWorkbenchSelectionA
  CloseWorkbenchObjectA
  MakeWorkbenchObjectVisibleA
  OpenWorkbenchObjectA
  RemoveAppIcon
  RemoveAppMenuItem
  RemoveAppWindow
  RemoveAppWindowDropZone
  UpdateWorkbench
  WBInfo
  WorkbenchControlA
Include
GuruMeditation
Docs » Autodocs » workbench.library » AddAppWindowA

NAME

	AddAppWindowA - add a window to Workbench's list of AppWindows.  (V36)

SYNOPSIS

	AppWindow = AddAppWindowA(id, userdata, window, msgport, taglist)
D0 D0 D1 A0 A1 A2
struct AppWindow *AddAppWindowA(ULONG, ULONG, struct Window *,
struct MsgPort *, struct TagItem *);
Alternate, varargs version:
struct AppWindow *AddAppWindow(ULONG, ULONG, struct Window *,
struct MsgPort *
tag1, data1,
tag2, data2,
...
TAG_END );

FUNCTION

	Attempt to add the window to Workbench's list of AppWindows.
Normally non-Workbench windows (those not opened by Workbench)
cannot have icons dropped in them. This call is provided to
allow applications to be notified when an icon or icons get
dropped inside a window that they have registered with Workbench.
The notification consists of an AppMessage (found in workbench.h/i)
of type 'MTYPE_APPWINDOW' arriving at the message port you specified.
What you do with the list of icons (pointed to by am_ArgList) is
up to you, but generally you would want to call GetDiskObjectNew on
them.

INPUTS

	id - this variable is strictly for your own use and is ignored by
Workbench. Typical uses in C are in switch and case statements,
and in assembly language table lookup.
userdata - this variable is strictly for your own use and is ignored
by Workbench.
window - pointer to window to add.
msgport - pointer to message port Workbench will use to send you an
AppMessage message of type 'MTYPE_APPWINDOW' when your
window gets an icon or icons dropped in it.
taglist - ptr to a list of tag items. Must be NULL for V2.0.

RESULT

	AppWindow - a pointer to an AppWindow structure which you pass to
RemoveAppWindow when you want to remove the window
from Workbench's list of AppWindows. NULL
if Workbench was unable to add your window; typically
happens when Workbench is not running or under low
memory conditions.

SEE ALSO

workbench.library/AddAppWindowDropZoneA(), workbench.library/RemoveAppWindow()

NOTES

	The V2.0 icon editor is an example of an AppWindow.  Note that app
window applications generally want to call GetDiskObjectNew
(as opposed to GetDiskObject) to get the disk object for the icon
dropped in the window.
For this function call to succeed, Workbench must be open. This
means that the LoadWB command was executed and the Workbench
screen has been opened.
When removing an AppWindow, all its drop zones will be automatically
removed.

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Razor 1911

DC
TRSI
RZR
TSL

Comments:

$VER: d0.se 1.14 Copyright © 2011-2024 Tobias Geijersson support at d0 dot se