RISC OS Open
Safeguarding the past, present and future of RISC OS for everyone
ROOL
Home | News | Downloads | Bugs | Bounties | Forum | Documents | Photos | Contact us
Account

Wimp_Poll

WindowManager
» SWI Calls
» Wimp_Poll

Wimp_Poll

(SWI &400C7)
Entry
R0 Poll Mask
R1 Pointer to 256 byte block
R3 Pointer to pollword in RMA (if R0 bit22 is set)
Exit
R0 Reason Code
R1 Pointer to block of data
R2 Senders task handle

Use

The purpose of this call is poll the Wimp to check for any system wide events that the application may need to respond to. i.e. windows, menus, mouse, keyboard handling.

Notes

Every application must have poll loop whereby it calls Wimp_Poll.

The call returns specific event codes, and the application must then decide whether it wishes to respond to it.

If upon calling Wimp_Poll an escape condition is detected, the Wimp will cancel the condition and disable future escape conditions.

Any errors that occur inside Wimp_Poll are reported by the Wimp itself and not passed back to the applications. The only exception to this rule is when an error was caused due to bad parameter usage.

See also

  • Poll Mask
  • Reason Codes
  • Wimp_PollIdle
Revised on July 31, 2018 23:26:35 by Jeffrey Lee (213) (86.179.185.113)
Edit | Back in time (4 revisions) | See changes | History | Views: Print | Source | Linked from: Wimp_AddMessages, WindowManager SWI Calls, WindowManager Polling, WindowManager General Principles, WindowManager Layout Of Windows, WindowManager Redrawing Windows, WindowManager Updating Windows, WindowManager Keyboard Input And Text Handling, WindowManager Colour, WindowManager Dragging, WindowManager Applications And Documents, WindowManager Memory Management, Wimp_ClaimFreeMemory, Wimp_CreateWindow, Wimp_CreateMenu, User_Message, User_Message_Acknowledge, User_Message_Recorded, Wimp_DragBox, Wimp_StartTask, Wimp_Initialise, User_Drag_Box, Scroll_Request, Wimp_GetMenuState, Button State, Poll Mask, Null_Reason, Open_Window_Request, Close_Window_Request, Pointer_Entering_Window, Mouse_Click, Character Codes, Menu_Selection, Scroll Directions, Lose_Caret, Wimp_ProcessKey, Wimp_RemoveMessages, Wimp_SetCaretPosition, Message Codes, Message_SaveDesktop, WindowManager Messages Overview, Message_AlarmGoneOff, Message_WindowClosed, Message_PreQuit, Message_PaletteChange, Message_DeviceClaim, Message_DeviceInUse, Filing System Numbers, Message_AppControl, AppControl Flags, Message_FilerOpenDir, Message_FilerCloseDir, Message_FilerOpenDirAt, Message_FilerSelectionDirectory, Message_FilerAddSelection, FilerAction Operations, Message_FilerControlAction, Message_FilerSelection, Message_FilerSelection ViewMode, Message_AlarmSet, Message_SetAlarm 1, Message_SetAlarm 2, Message_HelpRequest, Message_HelpReply, Escape Codes, Message_Notify, Message_MenuWarning, Message_ModeChange, Currently Active Object Pointer, Message_TaskCloseDown, Message_SlotSize, Message_SetSlot, Message_TaskNameIs, Message_TaskStarted, Message_MenusDeleted, Message_ClaimEntity, Message_WindowInfo, Message_IconizeAt, Message_Quit, Message_ClaimEntity Flags, Message_Dragging Flags, Message_DragClaim, Message_DragClaim Flags, Message_ReleaseEntity Flags, Message_DataSave, Message_DataSaveAck, Message_DataLoadAck, Message_DataOpen, Message_RAMFetch, Message_DataSaved, Message_ColourPickerColourChoice, ColourPicker Choice Flags, ColourTrans Palette Entry, Descriptor Extension Types, ColourTrans Fixed Point, Message_ColourPickerColourChanged, Message_IconizeAt Flags, Message_ColourPickerOpenParentRequest, Post Filter Code, Filter_RegisterPreFilter, Pre Filter Code, *Filters, FilterManager, TaskWindow, TaskWindow_NewTask, TaskWindow_Ego, TaskWindow_Morite, TaskWindow_Input, TaskWindow_Morio, TaskWindow_Resume, TaskWindow_Output, TaskWindow_Suspend, Font_DecodeMenu, OS_SWINumberFromString, OS_UpCall 6, OS_ReadArgs, Message_FilerAction, Reason Codes, Message_Dragging, VFPSupport, Filter_RegisterPostFilter, Wimp_SendMessage, Wimp_GetPointerInfo, DragASprite, Redraw_Window_Request, Pointer_Leaving_Window, Validation String Y, Wimp Managed Key Presses, Gain_Caret, Wimp_RedrawWindow, Key_Pressed, Wimp_PollIdle, PollWord_NonZero, Message_SetAlarm 0, AppControl Operations, Message_FilerOpenDirAt ViewMode, FilerAction Options, Message_Shutdown, Message_HelpEnable, Message_TaskInitialise, Message_TaskNameRq, Message_FontChanged, Message_DataRequest, Message_ReleaseEntity, Message_DataLoad, Message_RAMTransmit, ColourPicker Changed Flags, ColourPicker Colour Descriptor, Message_Iconize, Message_ColourPickerResetColourRequest, Message_ColourPickerCloseDialogueRequest, ColourPicker_HelpReply, The Acorn Terminal Interface Protocol, OS_GetEnv, Cerilica_StyledText, Addressing the end-of-life of AArch32

Search the Wiki

Social

Follow us on and

ROOL Store

Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.

Donate! Why?

Help ROOL make things happen – please consider donating!

RISC OS IPR

RISC OS is an Open Source operating system owned by RISC OS Developments Ltd and licensed primarily under the Apache 2.0 license.

Navigation

  • Home Page
  • All Pages
  • Recently Revised
  • Authors
  • Feeds
Site design © RISC OS Open Limited 2018 except where indicated
The RISC OS Open Instiki theme is based on Insitki's default layout

Valid XHTML 1.0  |  Valid CSS

Instiki 0.19.1(MML+)
This site runs on Rails

Hosted by Arachsys