ARM Club 1

home *** CD-ROM | disk | FTP | other *** search

/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / program / d / eventshell / Docs / Icons < prev next >

Wrap

Text File | 1993-11-14 | 13.3 KB | 527 lines

FNshell_IconGetCommand() Params => int pointer to validation string str validation command <= str command string See also FNshell_IconGetValidation. -------------------------------------------------------- PROCshell_IconSelectAll() Params => int window handle Selects all of the icons contained in the specified window. -------------------------------------------------------- PROCshell_IconDeselectAll() Params => int window handle Deselects all of the icons contained in the specified window. -------------------------------------------------------- PROCshell_IconDelete() Params => int window handle int icon handle This call frees any memory used for indirected data and validation strings. The window area covered by the icon (including any 3D borders) is not redrawn. Use PROCshell_IconDelete2 to delete the icon and redraw the window area. -------------------------------------------------------- PROCshell_IconDelete2() Params => int window handle int icon handle This call frees any memory used for indirected data and validation strings. The window area covered by the icon (including any 3D borders) is redrawn. When a large number of icons are to be deleted it is better to use PROCshell_IconDelete and then redraw the window afterwards as this will be quicker. -------------------------------------------------------- FNshell_IconMove2() Params => int window handle int icon handle int x displacement int y displacement <= int icon handle Allows an icon to be moved around the window. As the icon has to be deleted and then recreated it returns the new icon handle (which should be the same as the old handle). The icon is redrawn after moving, taking account of any 3D borders. See also FNshell_IconMove -------------------------------------------------------- FNshell_IconMove() Params => int window handle int icon handle int min x coord int min y coord int max x coord int may y coord <= int icon handle Allows the redefinition of an icon's bounding box. As the icon has to be deleted and then recreated it returns the new icon handle (which should be the same as the old handle). The icon is redrawn after resizing, taking account of any 3D borders. -------------------------------------------------------- FNshell_IconGetData() Params => int window handle int icon handle <= str icon text See also <PROCshell_IconPutData>. -------------------------------------------------------- PROCshell_IconbarSetText() Params => int window handle int icon handle str text under icon A problem can occur with this call if RISC OS 2 is in use. As it does not seem possible to discover the scroll offsets of the iconbar the correct area of the iconbar may not be redrawn after changing the text. Any suggestions would be gratefully received... -------------------------------------------------------- PROCshell_IconPutData() Params => int window handle int icon handle str text to insert into icon int redraw flag An error is generated if the text is too long to fit in the icon. If the text to insert is the same as the existing text then no action is taken, avoiding any flickering of the icon. If the redraw flag is TRUE wimp poll is called immediately to update the icon contents. Note that if the window is not open (for example if you are calling this routine in a pre-open function) then the redraw flag should be FALSE as the whole window will be redrawn when it is opened. -------------------------------------------------------- PROCshell_IconPutDataNow() Params => int window handle int icon handle str text to insert into icon An error is generated if the text is too long to fit in the icon. This call is similar to PROCshell_IconPutData, the difference being that PROCshell_Ensure is called to make sure that the icon is updated immediately. This is important if your program is performing some non multi tasking operation and you want an icon to show a status message. -------------------------------------------------------- PROCshell_IconRedraw() Params => int window handle int icon handle Force a redraw of the screen area covered by the given icon (including any 3D borders). -------------------------------------------------------- PROCshell_IconPutValidation() Params => int window handle int icon handle str new validation string See also FNshell_IconGetValidation. -------------------------------------------------------- PROCshell_IconSelect() Params => int window handle int icon handle Make the specified icon selected. -------------------------------------------------------- PROCshell_IconDeselect() Params => int window handle int icon handle -------------------------------------------------------- PROCshell_IconUnselectable() Params => int window handle int icon handle -------------------------------------------------------- PROCshell_IconSetBGColour() Params => int window handle int icon handle int background colour An error is generated if the colour number is outside the range 0-15. See also PROCshell_IconSetFGColour. -------------------------------------------------------- PROCshell_IconSetFGColour() Params => int window handle int icon handle int foreground colour An error is generated if the colour number is outside the range 0-15. See also PROCshell_IconSetBGColour. -------------------------------------------------------- PROCshell_IconSetButtonType() Params => int window handle int icon handle int button type An error is generated if the button type is outside the range 0-11,14-15. -------------------------------------------------------- PROCshell_IconSetESG() Params => int window handle int icon handle int Exclusive Selection Group number An error is generated if the esg number is outside the range 0-31. -------------------------------------------------------- PROCshell_IconSetText() Params => int window handle int icon handle bool state (0 to clear text bit, non-0 to set it) -------------------------------------------------------- PROCshell_IconSetSprite() Params => int window handle int icon handle bool state (0 to clear sprite bit, non-0 to set it) -------------------------------------------------------- PROCshell_IconSetBorder() Params => int window handle int icon handle bool state (0 to clear border bit, non-0 to set it) -------------------------------------------------------- PROCshell_IconSetHCentred() Params => int window handle int icon handle bool state (0 to clear horizontally centred bit, non-0 to set it) -------------------------------------------------------- PROCshell_IconSetVCentred() Params => int window handle int icon handle bool state (0 to clear vertically centred bit, non-0 to set it) -------------------------------------------------------- PROCshell_IconSetRightJust() Params => int window handle int icon handle bool state (0 to clear right justified bit, non-0 to set it) -------------------------------------------------------- PROCshell_IconSetLeftJust() Params => int window handle int icon handle -------------------------------------------------------- PROCshell_IconSetFilled() Params => int window handle int icon handle bool state (0 to clear filled bit, non-0 to set it) -------------------------------------------------------- PROCshell_CaretSetPosition() Params => int window handle int icon handle int x offset in icon (usually -1) int y offset in icon (usually -1) int height (usually -1) int index Allows the caret to be positioned within an icon. the index parameter is the number of characters before the caret. See also PROCshell_CaretSetRight. -------------------------------------------------------- PROCshell_CaretSetRight() Params => int window handle int icon handle Positions the caret at the right hand end of any text in the specified icon. See also PROCshell_CaretSetPosition. -------------------------------------------------------- FNshell_Iconbar() Params => int -1 for right side of bar, -2 for left side str sprite name str text under icon int width of icon/text (whichever is larger) str menu name bool shift flag (not implemented) bool ctrl flag (not implemented) bool alt flag (not implemented) str function name The shift, ctrl and alt flags are for future enhancements to the library and should be set to 0 on this release. FNshell_IconGetValidation() Params => int window handle int icon handle <= str validation string See also PROCshell_IconPutValidation. -------------------------------------------------------- FNshell_IconNewSprite() Params => int window handle int icon handle str new sprite name int redraw flag <= int new icon handle -------------------------------------------------------- FNshell_IsIconSelected() Params => int window handle int icon handle <= bool TRUE if selected, FALSE otherwise -------------------------------------------------------- FNshell_IconIsDraggable() Params => int window handle int icon handle <= bool TRUE if draggable, FALSE otherwise -------------------------------------------------------- FNshell_IconIsSprite() Params => int window handle int icon handle <= bool TRUE if sprite, FALSE otherwise -------------------------------------------------------- FNshell_IconCreate() Params => int window handle int min x coord of icon int min y coord of icon int width of icon int height of icon int foreground colour int background colour int icon flags str text to insert into icon int address of indirected data (ignored when not indirected) int length of indirected buffer (ignored when not indirected) str validation string <= int handle of new icon This routine is only used when the application needs to create icons itself rather than loading them as part of a window definition in a template. It does not redraw the area of the window occupied by the new icon. If the window is open it may be necessary to call PROCshell_IconRedraw to update the window area covered by the icon. User FN (PROCshell_IconBar) Params => str text of menu selection This function is called when the user chooses an item on the menu. -------------------------------------------------------- PROCshell_IconSet() Params => int window handle int icon handle bool state (0 for deselected, non 0 for selected) This call is used to select or deselect icons depending on the value of the state flag -------------------------------------------------------- PROCshell_IconSetSelected() Params => int window handle int icon handle bool state (0 for deselected, non 0 for selected) This call is used to select or deselect icons depending on the value of the state flag -------------------------------------------------------- PROCshell_IconSetUnselectable() Params => int window handle int icon handle bool state (0 to make icon selectable, non 0 to make it unselectable) This call is used to make icons unselectable (i.e. greyed out) depending on the value of the state flag. If the icon contains the caret when it is made unselectable, the caret is lost. -------------------------------------------------------- FNshell_IconResize() Params => int window handle int icon handle int min x coord int min y coord int max x coord int max y coord <= int icon handle Allows the redefinition of an icon's bounding box. As the icon has to be deleted and then recreated it returns the new icon handle (which should be the same as the old handle). The icon is redrawn after resizing, taking account of any 3D borders. --------------------------------------------------------