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

NAME

	ScreenPosition -- Move screens with greater control. (V39)

SYNOPSIS

	ScreenPosition( Screen, flags, x1, y1, x2, y2 )
A0 D0 D1 D2 D3 D4
VOID ScreenPosition( struct Screen *, ULONG, LONG, LONG, LONG, LONG );

FUNCTION

	Moves the screen to the specified position or by the specified
increment, in screen pixel resolution coordinates.
If the x1 and y1 variables you specify would move the screen in
a way that violates any restrictions, the screen will be moved
as far as possible. You may examine the LeftEdge and TopEdge
fields of the Screen structure after this function returns to
see where the screen really ended up.
Note that negative values for screen LeftEdge and TopEdge are
valid for screens bigger than their display clip.

INPUTS

	Screen = pointer to a Screen structure
flags = Set to one of SPOS_RELATIVE, SPOS_ABSOLUTE, or
SPOS_MAKEVISIBLE. You may additionally set SPOS_FORCEDRAG
if you need. Use SPOS_RELATIVE (zero) for normal use
(move screen a relative amount expressed by x1,y1). Set
the SPOS_ABSOLUTE flag if you wish x1 and y1 to be absolute
coordinates to move the screen to. Set SPOS_MAKEVISIBLE to
position an oversized scrolling screen so that the rectangle
described by (x1,y1)-(x2,y2) is on the visible part of
the display. (A word-processor may wish to support
autoscrolling as the user types. In that case, it could
call ScreenPosition() with the SPOS_MAKEVISIBLE flag and
a rectangle that encompasses the cursor with some space
around it.
In addition to any one of the above choices, you can
additionally set SPOS_FORCEDRAG if you wish to reposition
a screen that was opened with the {SA_Draggable,FALSE}
attribute.
x1,y1 = Absolute position or change in position you wish to apply
to the screen, when using SPOS_ABSOLUTE or SPOS_RELATIVE.
When using SPOS_MAKEVISIBLE, these variables describe
the upper-left corner of the rectangle you would like to
ensure is on the visible part of a scrolling screen.
x2,y2 = Ignored when using SPOS_ABSOLUTE or SPOS_RELATIVE.
When using SPOS_MAKEVISIBLE, these variables describe
the lower-right corner of the rectangle you would like to
ensure is on the visible part of a scrolling screen.
Note that these coordinates are in the same resolution
as the screen (such as HIRES or INTERLACE)

RESULT

	None

NOTES

	ONLY the owner of the screen should use SPOS_FORCEDRAG.
It is incorrect style (and against the intentions of the
screen opener) for programs such as commodities or
mouse-helpers to move non-draggable screens.

BUGS

SEE ALSO

MoveScreen(), RethinkDisplay()

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:

Abyss

AYS
FC
RZR
HZ

Comments:

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