a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 intuition.library
  ActivateGadget
  ActivateWindow
  AddClass
  AddGList
  AddGadget
  AllocRemember
  AllocScreenBuffer
  AutoRequest
  BeginRefresh
  BuildEasyRequestArgs
  BuildSysRequest
  ChangeScreenBuffer
  ChangeWindowBox
  ClearDMRequest
  ClearMenuStrip
  ClearPointer
  CloseScreen
  CloseWindow
  CloseWorkBench
  CurrentTime
  DisplayAlert
  DisplayBeep
  DisposeObject
  DoGadgetMethodA
  DoubleClick
  DrawBorder
  DrawImage
  DrawImageState
  EasyRequestArgs
  EndRefresh
  EndRequest
  EraseImage
  FreeClass
  FreeRemember
  FreeScreenBuffer
  FreeScreenDrawInfo
  FreeSysRequest
  GadgetMouse
  GetAttr
  GetDefPrefs
  GetDefaultPubScreen
  GetPrefs
  GetScreenData
  GetScreenDrawInfo
  HelpControl
  InitRequester
  IntuiTextLength
  ItemAddress
  LendMenus
  LockIBase
  LockPubScreen
  LockPubScreenList
  MakeClass
  MakeScreen
  ModifyIDCMP
  ModifyProp
  MoveScreen
  MoveWindow
  MoveWindowInFrontOf
  NewModifyProp
  NewObject
  NextObject
  NextPubScreen
  ObtainGIRPort
  OffGadget
  OffMenu
  OnGadget
  OnMenu
  OpenScreen
  OpenScreenTagList
  OpenWindow
  OpenWindowTagList
  OpenWorkBench
  PointInImage
  PrintIText
  PubScreenStatus
  QueryOverscan
  RefreshGList
  RefreshGadgets
  RefreshWindowFrame
  ReleaseGIRPort
  RemakeDisplay
  RemoveClass
  RemoveGList
  RemoveGadget
  ReportMouse
  Request
  ResetMenuStrip
  RethinkDisplay
  ScreenDepth
  ScreenPosition
  ScreenToBack
  ScreenToFront
  ScrollWindowRaster
  SetAttrsA
  SetDMRequest
  SetDefaultPubScreen
  SetEditHook
  SetGadgetAttrsA
  SetMenuStrip
  SetMouseQueue
  SetPointer
  SetPrefs
  SetPubScreenModes
  SetWindowPointerA
  SetWindowTitles
  ShowTitle
  SizeWindow
  SysReqHandler
  TimedDisplayAlert
  UnlockIBase
  UnlockPubScreen
  UnlockPubScreenList
  ViewAddress
  ViewPortAddress
  WBenchToBack
  WBenchToFront
  WindowLimits
  WindowToBack
  WindowToFront
  ZipWindow
Include
GuruMeditation
Docs » Autodocs » intuition.library » RefreshGadgets

NAME

	RefreshGadgets -- Refresh (redraw) the gadget display.

SYNOPSIS

	RefreshGadgets( Gadgets, Window, Requester )
A0 A1 A2
VOID RefreshGadgets( struct Gadget *, struct Window *,
struct Requester * );

FUNCTION

	Refreshes (redraws) all of the gadgets in the gadget list starting
from the specified gadget.
The window parameter must point to the window which contains the
gadget, or which contains the requester that contains the gadget
The requester parameter must only be valid if the gadget has the
GTYP_REQGADGET flag set, a requirement for all requester gadgets.
The Pointer argument points to a Window structure.
The two main reasons why you might want to use this routine are:
first, that you've modified the imagery of the gadgets in your
display and you want the new imagery to be displayed; secondly,
if you think that some graphic operation you just performed
trashed the gadgetry of your display, this routine will refresh
the imagery for you.
Note that to modify the imagery of a gadget, you must first remove
that gadget from the window's gadget list, using RemoveGadget() (or
RemoveGList()). After changing the image, border, text (including
text for a string gadget), the gadget is replaced in the gadget list
(using AddGadget() or AddGList()). Adding gadgets does not cause
them to be displayed (refreshed), so this function, or RefreshGList()
is typically called.
A common technique is to set or reset the GFLG_SELECTED flag of a
Boolean gadget and then call RefreshGadgets() to see it displayed
highlighted if and only if GFLG_SELECTED is set. If you wish to do
this and be completely proper, you must RemoveGadget(), change the
GFLG_SELECTED flag, AddGadget(), and RefreshGadgets(), or the
equivalent.
The gadgets argument can be a copy of the FirstGadget variable in
the Window structure that you want refreshed:
the effect of this will be that all gadgets will be redrawn.
However, you can selectively refresh just some of the gadgets
by starting the refresh part-way into the list: for instance,
redrawing your window non-GTYP_GZZGADGET gadgets only, which you've
conveniently grouped at the end of your gadget list.
Even more control is available using the RefreshGList() routine which
enables you to refresh a single gadget, or number of your choice.
NOTE: It's never safe to tinker with the gadget list yourself. Don't
supply some gadget list that Intuition hasn't already processed in
the usual way.

INPUTS

	Gadgets = pointer to the first in the list of gadgets wanting
refreshment
Window = pointer to the window containing the gadget or its requester
Requester = pointer to a requester (ignored if gadget is not attached
to a requester).

RESULT

	None

BUGS

SEE ALSO

RefreshGList(), RemoveGadget(), RemoveGList(), AddGadget(), AddGList()

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:

Crystal

AYS
CSL
SCX
KEF

Comments:

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