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 » MakeWorkbenchObjectVisibleA

NAME

	MakeWorkbenchObjectVisibleA -- Change a Workbench window in such a
way as to make a particular icon visible. (V44)

SYNOPSIS

	success = MakeWorkbenchObjectVisibleA(name,tags)
D0 A0 A1
BOOL MakeWorkbenchObjectVisibleA(STRPTR name,struct TagItem *tags);
success = MakeWorkbenchObjectVisible(name,...);
BOOL MakeWorkbenchObjectVisible(STRPTR name,...);

FUNCTION

	Due to how the scrollers of a Workbench window affect the positions
of the icons inside that window, some icons may not be drawn inside
the bounds of the window. By using MakeWorkbenchObjectVisibleA()
the window scrollers can be made to scroll such a "hidden" icon
into view.

INPUTS

	name -- Name of the icon to make visible. Note that the window
the icon resides in must already be open.
tags -- Additional options.

TAGS

	No tags are defined yet (V44).

RESULT

	result -- FALSE if the icon in question could not be found,
TRUE otherwise. If FALSE is returned, you can query the error
code using dos.library/IoErr().

EXAMPLE

	/* Make the icon for the drawer "SYS:" visible. */
MakeWorkbenchObjectVisible("SYS:",TAG_END);

NOTES

	The name of the icon to make visible is interpreted relative
to the current directory of the program to call
MakeWorkbenchObjectVisibleA().
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.
While the user is dragging icons, no on-screen rendering may
take place. In this state Workbench may refuse to execute the
MakeWorkbenchObjectVisible() call and return an error code instead
(ERROR_OBJECT_IN_USE).

SEE ALSO

dos.library/IoErr()

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:

The Silents

TBL
AFL
TSL
RZR

Comments:

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