www.riscos.com Technical Support:
Toolbox Manual
Acorn Toolbox Manual
Referenced Index of Contents
Toolbox: Chapter 1: Introduction to the Toolbox
Toolbox: Chapter 2: Building an application
Toolbox: Chapter 3: Colour Dialogue box class
Toolbox: Chapter 4: Colour Menu class
Toolbox: Chapter 5: Discard/Cancel/Save Dialogue box class
Toolbox: Chapter 6: File Info Dialogue box class
Toolbox: Chapter 7: Font Dialogue box class
Toolbox: Chapter 8: Font Menu class
Toolbox: Chapter 9: Iconbar icon class
Toolbox: Chapter 10: Menu class
Toolbox: Chapter 11: Print Dialogue box class
Toolbox: Chapter 12: Prog Info Dialogue box class
Toolbox: Chapter 13: Quit Dialogue box class
Toolbox: Chapter 14: SaveAs Dialogue box class
Toolbox: Chapter 15: Scale Dialogue box class
Toolbox: Chapter 16: Window class
Toolbox: Chapter 17: ResEd
Toolbox: Chapter 18: ResTest
Toolbox: Chapter 19: DrawFile
Toolbox: Appendix A: Resource File Formats
Toolbox: Appendix B: Support for RISC OS 3.10
Toolbox: Chapter 1: Introduction to the Toolbox
Introduction to the Toolbox
Introduction
Installing C/C++
Terminology
General notes
Toolbox Application Model
Traditional desktop application
Toolbox application
Wimp events
Toolbox objects
Object classes
Object components
Object Methods
Creating an object
Deleting an object
Showing an object
Hiding an object
Object-specific methods
Shared objects
Client handles
Parent and ancestor objects
Parent objects
Ancestor objects
Auto-create and Auto-show objects
Attached objects
Event handling
Toolbox event Codes
Format of a Toolbox event
The id block
Raising a Toolbox event
Resource files
Loading resource files
Resource file format
Task initialisation and run-time information
Message texts and nationalisation
An Example object
Toolbox SWIs
Toolbox_CreateObject (SWI 0x44EC0)
On entry
On exit
Use
C veneer
Toolbox_DeleteObject (SWI 0x44EC1)
On entry
On exit
Use
C veneer
Toolbox_ShowObject (SWI 0x44EC3)
On entry
On exit
Use
C veneer
Toolbox_HideObject (SWI 0x44EC4)
On entry
On exit
Use
C veneer
Toolbox_GetObjectState (SWI 0x44EC5)
On entry
On exit
Use
C veneer
Toolbox_ObjectMiscOp (SWI 0x44EC6)
On entry
On exit
Use
Toolbox_SetClientHandle (SWI 0x44EC7)
On entry
On exit
Use
C veneer
Toolbox_GetClientHandle (SWI 0x44EC8)
On entry
On exit
Use
C veneer
Toolbox_GetObjectClass (SWI 0x44EC9)
On entry
On exit
Use
C veneer
Toolbox_GetParent (SWI 0x44ECA)
On entry
On exit
Use
C veneer
Toolbox_GetAncestor (SWI 0x44ECB)
On entry
On exit
Use
C veneer
Toolbox_GetTemplateName (SWI 0x44ECC)
On entry
On exit
Use
C veneer
Toolbox_RaiseToolboxEvent (SWI 0x44ECD)
On entry
On exit
Use
C veneer
Toolbox_GetSysInfo (SWI 0x44ECE)
On entry
On exit
Use
C veneer
Toolbox_Initialise (SWI 0x44ECF)
On entry
On exit
Use
C veneer
Toolbox_LoadResources (SWI 0x44ED0)
On entry
On exit
Use
C veneer
Toolbox_TemplateLookUp (SWI 0x44EFB)
On entry
On exit
Use
C veneer
Toolbox events
Toolbox_Error (Event 0x44EC0)
Block
Use
C data type
Toolbox_ObjectAutoCreated (Event 0x44EC1)
Block
Use
C data type
Toolbox_ObjectDeleted (Event 0x44EC2)
Block
Use
C data type
Toolbox: Chapter 2: Building an application
Building an application
Guide To Hyper
Application icon menu
Keyboard Short-cuts
How !Hyper was designed
Requirements
Design decisions
Shared objects and client handles
Event driven interface
AboutToBeShown events
Standard objects
Keyboard short-cuts
How !Hyper was implemented
Creating and testing a simple resource file for !Hyper
Creating a basic resource file
Using ResTest to check the resource file
Coding
File loading
Handling views
Redraw handler
Scaling
Implementing hotspots
Linking the data structures
Showing and hiding views
Adding keyboard short-cuts
Adding a status bar
Adding a find capability
Modifying the interface
Adding an export DrawFile facility
Other possible modifications
Client Events
Summary
HyperCard Control Language
HCL commands
Toolbox: Chapter 3: Colour Dialogue box class
Colour Dialogue box class
User interface
Application Program Interface
Attributes
Manipulating a Colour Dialogue object
Creating and deleting a Colour Dialogue object
Showing a Colour Dialogue object
Before the dialogue box is shown
Setting and reading the colour used in a Colour Dialogue box
Setting and reading the colour model used in a Colour Dialogue
Reacting to colour selections
Completion of a Colour Dialogue
Colour Dialogue methods
ColourDbox_GetWimpHandle 0
On entry
On exit
Use
C veneer
ColourDbox_GetDialogueHandle 1
On entry
On exit
Usage
C veneer
ColourDbox_SetColour 2
On entry
On exit
Use
C veneer
ColourDbox_GetColour 3
On entry
On exit
Use
C veneer
ColourDbox_SetColourModel 4
On entry
On exit
Use
C veneer
ColourDbox_GetColourModel 5
On entry
On exit
Use
C veneer
ColourDbox_SetNoneAvailable 6
On entry
On exit
Use
C veneer
ColourDbox_GetNoneAvailable 7
On entry
On exit
Use
C veneer
Colour Dialogue events
ColourDbox_AboutToBeShown (Event 0x829C0)
Block
Use
C data type
ColourDbox_DialogueCompleted (Event 0x829C1)
Block
Use
C data type
ColourDbox_ColourSelected (Event 0x829C2)
Block
Use
C data type
Colour Dialogue templates
Toolbox: Chapter 4: Colour Menu class
Colour Menu class
User interface
Application Program Interface
Attributes
Manipulating a Colour Menu object
Creating and deleting a Colour Menu
Showing a Colour Menu
Before the menu is shown
Setting and getting the selected colour
Processing a colour selection
Getting the underlying menu object id
Colour Menu methods
ColourMenu_SetColour 0
On entry
On exit
Use
C veneer
ColourMenu_GetColour 1
On entry
On exit
Use
C veneer
ColourMenu_SetNoneAvailable 2
On entry
On exit
Use
C veneer
ColourMenu_GetNoneAvailable 3
On entry
On exit
Use
C veneer
ColourMenu_SetTitle 4
On entry
On exit
Use
C veneer
ColourMenu_GetTitle 5
On entry
On exit
Use
C veneer
Colour Menu events
ColourMenu_AboutToBeShown (0x82980)
Block
Use
C data type
ColourMenu_HasBeenHidden (0x82981)
Block
Use
C data type
ColourMenu_Selection (0x82982)
Block
Use
C data type
Colour Menu templates
Colour Menu Wimp event handling
Toolbox: Chapter 5: Discard/Cancel/Save Dialogue box class
Discard/Cancel/Save Dialogue box class
User interface
Application Program Interface
Attributes
Manipulating a DCS object
Creating and deleting a DCS object
Showing a DCS object
Changing the DCS dialogue's message
Getting the id of the underlying window for a DCS object
DCS methods
DCS_GetWindowID 0
On entry
On exit
Use
C veneer
DCS_SetMessage 1
On entry
On exit
Use
C veneer
DCS_GetMessage 2
On entry
On exit
Use
C veneer
DCS_SetTitle 3
On entry
On exit
Use
C veneer
DCS_GetTitle 4
On entry
On exit
Use
C veneer
DCS events
DCS_AboutToBeShown (0x82a80)
Block
Use
C data type
DCS_Discard (0x82a81)
Block
Use
C data type
DCS_Save (0x82a82)
Block
Use
C data type
DCS_DialogueCompleted (0x82a83)
Block
Use
C data type
DCS_Cancel (0x82a84)
Block
Use
C data type
DCS templates
Underlying window template
Gadgets
DCS Wimp event handling
Toolbox: Chapter 6: File Info Dialogue box class
File Info Dialogue box class
User interface
Application Program Interface
Attributes
Manipulating a File Info object
Creating and deleting a File Info object
Showing a File Info object
Before the File Info dialogue box is shown
Setting and reading the fields of the File Info dialogue
File Info methods
FileInfo_GetWindowID 0
On entry
On exit
Use
C veneer
FileInfo_SetModified 1
On entry
On exit
Use
C veneer
FileInfo_GetModified 2
On entry
On exit
Use
C veneer
FileInfo_SetFileType 3
On entry
On exit
Use
C veneer
FileInfo_GetFileType 4
On entry
On exit
Use
C veneer
FileInfo_SetFileName 5
On entry
On exit
Use
C veneer
FileInfo_GetFileName 6
On entry
On exit
Use
C veneer
FileInfo_SetFileSize 7
On entry
On exit
Use
C veneer
FileInfo_GetFileSize 8
On entry
On exit
Use
C veneer
FileInfo_SetDate 9
On entry
On exit
Use
C veneer
FileInfo_GetDate 10
On entry
On exit
Use
C veneer
FileInfo_SetTitle 11
On entry
On exit
Use
C veneer
FileInfo_GetTitle 12
On entry
On exit
Use
C veneer
File Info events
FileInfo_AboutToBeShown (0x82ac0)
Block
Use
C data type
FileInfo_DialogueCompleted (0x82ac1)
Block
Use
C data type
File Info templates
Underlying window template
Gadgets
File Info Wimp event handling
Toolbox: Chapter 7: Font Dialogue box class
Font Dialogue box class
User interface
Application Program Interface
Attributes
Manipulating a Font Dialogue object
Creating and deleting a Font Dialogue object
Showing a Font Dialogue object
Before the Font Dialogue box is shown
Setting and getting the current selection
Receiving a font selection
Completing a Font Dialogue
Font Dialogue methods
FontDbox_GetWindowID 0
On entry
On exit
Use
C veneer
FontDbox_SetFont 1
On entry
On exit
Use
C veneer
FontDbox_GetFont 2
On entry
On exit
Use
C veneer
FontDbox_SetSize 3
On entry
On exit
Use
C veneer
FontDbox_GetSize 4
On entry
On exit
Use
C veneer
FontDbox_SetTryString 5
On entry
On exit
Use
C veneer
FontDbox_GetTryString 6
On entry
On exit
Use
C veneer
FontDbox_SetTitle 7
On entry
On exit
Use
C veneer
FontDbox_GetTitle 8
On entry
On exit
Use
C veneer
Font Dialogue events
FontDbox_AboutToBeShown (0x82a00)
Block
Use
C data type
FontDbox_DialogueCompleted (0x82a01)
Block
Use
C data type
FontDbox_ApplyFont (0x82a02)
Block
Use
C data type
Font Dialogue Templates
Underlying Window template
Gadgets
Font Dialogue Wimp event handling
Toolbox: Chapter 8: Font Menu class
Font Menu class
User interface
Application Program Interface
Attributes
Manipulating a Font Menu object
Creating and deleting a Font Menu object
Showing a Font Menu object
Before the Font Menu is shown
Selecting a font
Receiving a font selection
Font Menu methods
FontMenu_SetFont 0
On entry
On exit
Use
C veneer
FontMenu_GetFont 1
On entry
On exit
Use
C veneer
Font Menu events
FontMenu_AboutToBeShown (0x82a40)
Block
Use
C data type
FontMenu_HasBeenHidden (0x82a41)
Block
Use
C data type
FontMenu_FontSelection (0x82a42)
Block
Use
C data type
Font Menu templates
Font Menu Wimp event handling
Toolbox: Chapter 9: Iconbar icon class
Iconbar icon class
User interface
Application Program Interface
Attributes
Manipulating an Iconbar icon object
Creating and deleting an Iconbar icon object
Showing an Iconbar icon object
The Iconbar icon's position and priority
The Iconbar icon's menu
Select and Adjust click events
Help messages
Iconbar icon methods
Iconbar_GetIconHandle 0
On entry
On exit
Use
C veneer
Iconbar_SetMenu 1
On entry
On exit
Use
C veneer
Iconbar_GetMenu 2
On entry
On exit
Use
C veneer
Iconbar_SetEvent 3
On entry
On exit
Use
C veneer
Iconbar_GetEvent 4
On entry
On exit
Use
C veneer
Iconbar_SetShow 5
On entry
On exit
Use
C veneer
Iconbar_GetShow 6
On entry
On exit
Use
C veneer
Iconbar_SetHelpMessage 7
On entry
On exit
Use
C veneer
Iconbar_GetHelpMessage 8
On entry
On exit
Use
C veneer
Iconbar_SetText 9
On entry
On exit
Use
C veneer
Iconbar_GetText 10
On entry
On exit
Use
C veneer
Iconbar_SetSprite 11
On entry
On exit
Use
C veneer
Iconbar_GetSprite 12
On entry
On exit
Use
C veneer
Iconbar icon events
Iconbar_Clicked (0x82900)
Block
Use
C data type
Iconbar_SelectAboutToBeShown (0x82901)
Block
Use
C data type
Iconbar_AdjustAboutToBeShown (0x82902)
Block
Use
C data type
Iconbar icon templates
Iconbar icon Wimp event handling
Toolbox: Chapter 10: Menu class
Menu class
User interface
Application Program Interface
Attributes
Menu attributes
Menu entry attributes
Manipulating a Menu object
Creating and deleting a menu
Showing a menu
Adding and removing menu entries
Changing a Menu entry
Ticking or fading a Menu entry
Attaching a submenu dynamically
Dealing with Menu hits
Dealing with Adjust clicks on a Menu
Dealing with traversal of a submenu arrow
Interactive help on Menus
Writable menu entries
Menu methods
Menu_SetTick 0
On entry
On exit
Use
C veneer
Menu_GetTick 1
On entry
On exit
Use
C veneer
Menu_SetFade 2
On entry
On exit
Use
C veneer
Menu_GetFade 3
On entry
On exit
Use
C veneer
Menu_SetEntryText 4
On entry
On exit
Use
C veneer
Menu_GetEntryText 5
On entry
On exit
Use
C veneer
Menu_SetEntrySprite 6
On entry
On exit
Use
C veneer
Menu_GetEntrySprite 7
On entry
On exit
Use
C veneer
Menu_SetSubMenuShow 8
On entry
On exit
Use
C veneer
Menu_GetSubMenuShow 9
On entry
On exit
Use
C veneer
Menu_SetSubMenuEvent 10
On entry
On exit
Use
C veneer
Menu_GetSubMenuEvent 11
On entry
On exit
Use
C veneer
Menu_SetClickShow 12
On entry
On exit
Use
C veneer
Menu_GetClickShow 13
On entry
On exit
Use
C veneer
Menu_SetClickEvent 14
On entry
On exit
Use
C veneer
Menu_GetClickEvent 15
On entry
On exit
Use
C veneer
Menu_SetHelpMessage 16
On entry
On exit
Use
C veneer
Menu_GetHelpMessage 17
On entry
On exit
Use
C veneer
Menu_SetEntryHelpMessage 18
On entry
On exit
Use
C veneer
Menu_GetEntryHelpMessage 19
On entry
On exit
Use
C veneer
Menu_AddEntry 20
On entry
On exit
Use
C veneer
Menu_RemoveEntry 21
On entry
On exit
Use
C veneer
Menu_GetHeight 22
On entry
On exit
Use
C veneer
Menu_GetWidth 23
On entry
On exit
Use
C veneer
Menu_SetTitle 24
On entry
On exit
Use
C veneer
Menu_GetTitle 25
On entry
On exit
Use
C veneer
Menu events
Menu_AboutToBeShown (0x828c0)
Block
Use
C data type
Menu_HasBeenHidden (0x828c1)
Block
Use
C data type
Menu_SubMenu (0x828c2)
Block
Use
C data type
Menu_Selection (0x828c3)
Block:
Use
C data type
Menu Templates
Menu Wimp event handling
Toolbox: Chapter 11: Print Dialogue box class
Print Dialogue box class
User interface
Application Program Interface
Attributes
Manipulating a Print Dialogue object
Creating and deleting a Print Dialogue object
Showing a Print Dialogue object
Before the Print Dialogue box is shown
Getting and setting printing options
Responding to action button clicks
Getting the Print Dialogue's title
Getting the id of the underlying Window object
The SetUp Window
Print Dialogue Methods
PrintDbox_GetWindowID 0
On entry
On exit
Use
C veneer
PrintDbox_SetPageRange 1
On entry
On exit
Use
C veneer
PrintDbox_GetPageRange 2
On entry
On exit
Use
C veneer
PrintDbox_SetCopies 3
On entry
On exit
Use
C veneer
PrintDbox_GetCopies 4
On entry
On exit
Use
C veneer
PrintDbox_SetScale 5
On entry
On exit
Use
C veneer
PrintDbox_GetScale 6
On entry
On exit
Use
C veneer
PrintDbox_SetOrientation 7
On entry
On exit
Use
C veneer
PrintDbox_GetOrientation 8
On entry
On exit
Use
C veneer
PrintDbox_GetTitle 9
On entry
On exit
Use
C veneer
PrintDbox_SetDraft 10
On entry
On exit
Use
C veneer
PrintDbox_GetDraft 11
On entry
On exit
Use
C veneer
Print Dialogue events
PrintDbox_AboutToBeShown (0x82b00)
Block
Use
C data type
PrintDbox_DialogueCompleted (0x82b01)
Block
Use
C data type
PrintDbox_SetUpAboutToBeShown (0x82b02)
Block
Use
C data type
PrintDbox_Save (0x82b03)
Block
Use
C data type
PrintDbox_SetUp (0x82b04)
Block
Use
C data type
PrintDbox_Print (0x82b05)
Block
Use
C data type
Print Dialogue templates
Underlying window template
Gadgets
Print Dialogue Wimp event handling
Toolbox: Chapter 12: Prog Info Dialogue box class
Prog Info Dialogue box class
User interface
Application Program Interface
Attributes
Manipulating a Prog Info object
Creating and deleting a Prog Info object
Showing a Prog Info object
Changing the version string
Setting the licence type
Prog Info methods
ProgInfo_GetWindowID 0
On entry
On exit
Use
C veneer
ProgInfo_SetVersion 1
On entry
On exit
Use
C veneer
ProgInfo_GetVersion 2
On entry
On exit
Use
C veneer
ProgInfo_SetLicenceType 3
On entry
On exit
Use
C veneer
ProgInfo_GetLicenceType 4
On entry
On exit
Use
C veneer
ProgInfo_SetTitle 5
On entry
On exit
Use
C veneer
ProgInfo_GetTitle 6
On entry
On exit
Use
C veneer
Prog Info events
ProgInfo_AboutToBeShown (0x82b40)
Block
Use
C data type
ProgInfo_DialogueCompleted (0x82b41)
Block
Use
C data type
Prog Info templates
Underlying window template
Gadgets
Prog Info Wimp event handling
Toolbox: Chapter 13: Quit Dialogue box class
Quit Dialogue box class
User interface
Application Program Interface
Attributes
Manipulating a Quit object
Creating and deleting a Quit object
Showing a Quit object
Changing the Quit Dialogue's message
Getting the id of the underlying window for a Quit Dialogue
Quit methods
Quit_GetWindowID 0
On entry
On exit
Use
C veneer
Quit_SetMessage 1
On entry
On exit
Use
C veneer
Quit_GetMessage 2
On entry
On exit
Use
C veneer
Quit_SetTitle 3
On entry
On exit
Use
C veneer
Quit_GetTitle 4
On entry
On exit
Use
C veneer
Quit events
Quit_AboutToBeShown (0x82a90)
Block
Use
C data type
Quit_Quit (0x82a91)
Block
Use
C data type
Quit_DialogueCompleted (0x82a92)
Block
Use
C data type
Quit_Cancel (0x82a93)
Block
Use
C data type
Quit templates
Underlying window template
Gadgets
Quit Wimp event handling
Toolbox: Chapter 14: SaveAs Dialogue box class
SaveAs Dialogue box class
User interface
Application Program Interface
Attributes
Manipulating a SaveAs object
Creating and deleting a SaveAs object
Showing a SaveAs object
Setting the SaveAs Dialogue box's filename and filetype
Summary of how to save data from a Toolbox client
Type 1
Type 2
Type 3
Setting the File Size for the SaveAs Dialogue
Enabling/disabling the Selection option button
Before the SaveAs Dialogue box is shown
Cancelling the dialogue
Saving handled entirely by the SaveAs module
Saving to a file
Saving via RAM transfer
Successful completion of a Save operation
Completion of the SaveAs dialogue
Error handling
Save As methods
SaveAs_GetWindowID 0
On entry
On exit
Use
C veneer
SaveAs_SetTitle 1
On entry
On exit
Use
C veneer
SaveAs_GetTitle 2
On entry
On exit
Use
C veneer
SaveAs_SetFileName 3
On entry
On exit
Use
C veneer
SaveAs_GetFileName 4
On entry
On exit
Use
C veneer
SaveAs_SetFileType 5
On entry
On exit
Use
C veneer
SaveAs_GetFileType 6
On entry
On exit
Use
C veneer
SaveAs_SetFileSize 7
On entry
On exit
Use
C veneer
SaveAs_GetFileSize 8
On entry
On exit
Use
C veneer
SaveAs_SelectionAvailable 9
On entry
On exit
Use
C veneer
SaveAs_SetDataAddress 10
On entry
On exit
Use
C veneer
SaveAs_BufferFilled 11
On entry
On exit
Use
C veneer
SaveAs_FileSaveCompleted 12
On entry
On exit
Use
C veneer
Save As events
SaveAs_AboutToBeShown (0x82bc0)
Block
Use
C data type
SaveAs_DialogueCompleted (0x82bc1)
Block
Use
C data type
SaveAs_SaveToFile (0x82bc2)
Block
Use
C data type
SaveAs_FillBuffer (0x82bc3)
Block
Use
C data type
SaveAs_SaveCompleted (0x82bc4)
Block
Use
C data type
Save As templates
Underlying Window template
Gadgets
Save As Wimp event handling
Toolbox: Chapter 15: Scale Dialogue box class
Scale Dialogue box class
User interface
Application Program Interface
Attributes
Manipulating a Scale object
Creating and deleting a Scale object
Showing a Scale object
Before the Scale Dialogue box is shown
Applying a Scale factor
Cancelling a Scale dialogue
Completion of a Scale dialogue
Reading and setting the writable field
Reading and setting the bounds of the writable field and step size
Scale methods
Scale_GetWindowID 0
On entry
On exit
Use
C veneer
Scale_SetValue 1
On entry
On exit
Use
C veneer
Scale_GetValue 2
On entry
On exit
Use
C veneer
Scale_SetBounds 3
On entry
On exit
Use
C veneer
Scale_GetBounds 4
On entry
On exit
Use
C veneer
Scale_SetTitle 5
On entry
On exit
Use
C veneer
Scale_GetTitle 6
On entry
On exit
Use
C veneer
Scale events
Scale_AboutToBeShown (0x82c00)
Block
Use
C data type
Scale_DialogueCompleted (0x82c01)
Block
Use
C data type
Scale_ApplyFactor (0x82c02)
Block
Use
C data type
Scale templates
Underlying window template
Gadgets
Scale Wimp event handling
Toolbox: Chapter 16: Window class
Window class
User interface
Application Program Interface
Attributes
Keyboard short-cut
Gadget
Manipulating a Window object
Creating and deleting a Window object
Showing a Window
The Window's menu
Gadgets in a window
Keyboard short-cuts
Pointer shapes
Help messages
Changing a window's title
Getting and setting a Window's client handle
Window methods
Window_GetWimpHandle 0
On entry
On exit
Use
C veneer
Window_AddGadget 1
On entry
On exit
Use
C veneer
Window_RemoveGadget 2
On entry
On exit
Use
C veneer
Window_SetMenu 3
On entry
On exit
Use
C veneer
Window_GetMenu 4
On entry
On exit
Use
C veneer
Window_SetPointer 5
On entry
On exit
Use
C veneer
Window_GetPointer 6
On entry
On exit
Use
C veneer
Window_SetHelpMessage 7
On entry
On exit
Use
C veneer
Window_GetHelpMessage 8
On entry
On exit
Use
C veneer
Window_AddKeyboardShortcuts 9
On entry
On exit
Use
C veneer
Window_RemoveKeyboardShortcuts 10
On entry
On exit
Use
C veneer
Window_SetTitle 11
On entry
On exit
Use
C veneer
Window_GetTitle 12
On entry
On exit
Use
C veneer
Window_SetDefaultFocus 13
On entry
On exit
Use
C veneer
Window_GetDefaultFocus 14
On entry
On exit
Use
C veneer
Window_SetExtent 15
On entry
On exit
Use
C veneer
Window_GetExtent 16
On entry
On exit
Use
C veneer
Window_ForceRedraw 17
On entry
On exit
Use
C veneer
Window_SetToolBars 18
On entry
Use
C veneer
Window_GetToolBars 19
On entry
On exit
Use
C veneer
Other SWIs
SWI Window_GetPointerInfo (0x82883)
On entry
On exit
Use
C veneer
SWI Window_WimpToToolbox (0x82884)
On entry
On exit
Use
C veneer
SWI Window_ExtractGadgetInfo (0x828be)
On entry
On exit
Use
C veneer
Window events
Window_AboutToBeShown (0x82880)
Block
Use
C data type
Window_HasBeenHidden (0x82890)
Block
Use
C data type
Window templates
Keyboard short-cut
Gadget
Window Wimp event handling
Toolbars
User interface
Use of toolbars
Application tool box
Status lines
Application program interface
Attributes
Manipulating a toolbar
Creating and deleting a toolbar object
Showing and Hiding
Toolbar methods
Gadgets
Application Program Interface
Attributes
Manipulating a Gadget
Generic gadget methods
Gadget_GetFlags 64
On entry
On exit
Use
C veneer
Gadget_SetFlags 65
On entry
On exit
Use
C veneer
Gadget_SetHelpMessage 66
On entry
On exit
Use
C veneer
Gadget_GetHelpMessage 67
On entry
On exit
Use
C veneer
Gadget_GetIconList 68
On entry
On exit
Use
C veneer
Gadget_SetFocus 69
On entry
On exit
Use
C veneer
Gadget_GetType 70
On entry
On exit
Use
C veneer
Gadget_MoveGadget 71
On entry
On exit
Use
C veneer
Gadget_GetBBox 72
On entry
On exit
Use
C veneer
Gadget Wimp event handling
Action buttons
Action button methods
ActionButton_SetText 128
On entry
On exit
Use
C veneer
ActionButton_GetText 129
On entry
On exit
Use
C veneer
ActionButton_SetEvent 130
On entry
On exit
Use
C veneer
ActionButton_GetEvent 131
On entry
On exit
Use
C veneer
ActionButton_SetClickShow 132
On entry
On exit
Use
C veneer
ActionButton_GetClickShow 133
On entry
On exit
Use
C veneer
Action button Toolbox events
ActionButton_Selected (0x82881)
Block
Use
C data type
Action button templates
Adjuster arrows
Adjuster arrows Toolbox events
Adjuster_Clicked (0x8288c)
Block
Use
C data type
Adjuster arrow templates
Button gadget
Button methods
Button_GetFlags 960
On entry
On exit
Use
C veneer
Button_SetFlags 961
On entry
On exit
Use
C veneer
Button_SetValue 962
On entry
On exit
Use
C veneer
Button_GetValue 963
On entry
On exit
Use
C veneer
Button_SetValidation 964
On entry
On exit
Use
C veneer
Button_GetValidation 965
On entry
On exit
Use
C veneer
Button_SetFont 966
On entry
On exit
Use
C veneer
Button toolbox events
Button templates
Display fields
Display field methods
DisplayField_SetValue 448
On entry
On exit
Use
C veneer
DisplayField_GetValue 449
On entry
On exit
Use
C veneer
DisplayField_SetFont 450
On entry
On exit
Use
C veneer
Display field templates
Draggable gadgets
Draggable methods
Draggable_SetSprite 640
On entry
On exit
Use
C veneer
Draggable_GetSprite 641
On entry
On exit
Use
C veneer
Draggable_SetText 642
On entry
On exit
Use
C veneer
Draggable_GetText 643
On entry
On exit
Use
C veneer
Draggable_SetState 644
On entry
On exit
Use
C veneer
Draggable_GetState 645
On entry
On exit
Use
C veneer
Draggable Toolbox events
Draggable_DragStarted (0x82887)
Block
Use
C data type
Draggable_DragEnded (0x82888)
Block
Use
C data type
Draggable templates
Labels
Label templates
Labelled boxes
Labelled box templates
Number ranges
Number range methods
NumberRange_SetValue 832
On entry
On exit
Use
C veneer
NumberRange_GetValue 833
On entry
On exit
Use
C veneer
NumberRange_SetBounds 834
On entry
On exit
Use
C veneer
NumberRange_GetBounds 835
On entry
On exit
Use
C veneer
NumberRange_GetComponents 836
On entry
On exit
Use
C veneer
Number range Toolbox events
NumberRange_ValueChanged (0x8288d)
Block
Use
C data type
Number range templates
Option buttons
Option button methods
OptionButton_SetLabel 192
On entry
On exit
Use
C veneer
OptionButton_GetLabel 193
On entry
On exit
Use
C veneer
OptionButton_SetEvent 194
On entry
On exit
Use
C veneer
OptionButton_GetEvent 195
On entry
On exit
Use
C veneer
OptionButton_SetState 196
On entry
On exit
Use
C veneer
OptionButton_GetState 197
On entry
On exit
Use
C veneer
Option button Toolbox events
OptionButton_StateChanged (0x82882)
Block
Use
C data type
Option button templates
Pop-up menus
Pop-up menu methods
PopUp_SetMenu 704
On entry
On exit
Use
C veneer
PopUp_GetMenu 705
On entry
On exit
Use
C veneer
Pop-up menu Toolbox events
PopUp_AboutToBeShown (0x8288b)
Block
Use
C data type
Pop-up menu templates
Radio buttons
Radio button methods
RadioButton_SetLabel 384
On entry
On exit
Use
C veneer
RadioButton_GetLabel 385
On entry
On exit
Use
C veneer
RadioButton_SetEvent 386
On entry
On exit
Use
C veneer
RadioButton_GetEvent 387
On entry
On exit
Use
C veneer
RadioButton_SetState 388
On entry
On exit
Use
C veneer
RadioButton_GetState 389
On entry
On exit
Use
C veneer
Radio button Toolbox events
RadioButton_StateChanged (0x82883)
Block
Use
C data type
Radio button templates
Sliders
Slider methods
Slider_SetValue 576
On entry
On exit
Use
C veneer
Slider_GetValue 577
On entry
On exit
Use
C veneer
Slider_SetBound 58
On entry
On exit
Use
C veneer
Slider_GetBound 579
On entry
On exit
Use
C veneer
Slider_SetColour 580
On entry
On exit
Use
C veneer
Slider_GetColour 581
On entry
On exit
Use
C veneer
Slider Toolbox events
Slider_ValueChanged (0x82886)
Block
Use
C data type
Slider templates
String sets
String set methods
StringSet_SetAvailable 896
On entry
On exit
Use
C veneer
StringSet_SetSelected 898
On entry
On exit
Use
C veneer
StringSet_GetSelected 899
On entry
On exit
Use
C veneer
StringSet_SetAllowable 900
On entry
On exit
Use
C veneer
StringSet_GetComponents 902
On entry
On exit
Use
C veneer
String set Toolbox events
StringSet_ValueChanged (0x8288e)
Block
Use
C data type
StringSet_AboutToBeShown (0x8288f)
Block
Use
C data type
String set templates
Writable fields
Writable field methods
WritableField_SetValue 512
On entry
On exit
Use
C veneer
WritableField_GetValue 513
On entry
On exit
Use
C veneer
WritableField_SetAllowable 514
On entry
On exit
Use
C veneer
WritableField_SetFont 516
On entry
On exit
Use
C veneer
Writable field Toolbox events
WritableField_ValueChanged (0x82885)
Block
Use
C data type
Writable field templates
Toolbox: Chapter 17: ResEd
ResEd
Overview
Creating and editing a Toolbox resource file
Starting ResEd
The iconbar icon
The iconbar menu
The object prototypes window
The resource file display
Editing an object template
Copying object templates
Moving object templates
The resource file display menu
The File menu
The Edit menu
Prototypes...
The Object flags dialogue box
Editing object templates in general
Length fields
Help messages
Other length fields
The selection model
Selection highlighting
Box selection
Cancel and OK
Cancel
OK
Editing the Menu class
The Menu editor
Editing a Menu entry
The Menu entry properties dialogue box
Editing the Menu
The Menu properties dialogue box
Inserting a new Menu entry
Manipulating menu entries
Copying menu entries
Moving menu entries between different editing windows
Re-ordering menu entries
Example menu
Creating a submenu
Displaying a dialogue box
Creating a keyboard short-cut
Defining the keyboard short-cut
Filling in the Menu entry properties box
Interactive help for menu entries
Editing a Window object template and gadgets
The Window menu
The Main properties dialogue box
The Other properties dialogue box
Manipulating the window
Re-sizing the window
Moving the window
Closing the window
Window Colours
Window Extent
Keyboard short-cuts
Using a keyboard short-cut entry to 'fill in' a menu entry
The Grid
Gadgets
The gadgets window
Positioning and moving gadgets
Repositioning and copying
Accurate positioning
Auto-scrolling
Moving gadgets between windows
Moving a gadget in one direction only
Changing the size of a gadget
Stacking
Moving the caret between writable gadgets
The Edit submenu
Snap to grid
Manipulating radio groups
Dragging a group of radio buttons between window templates
The Coordinates dialogue
The Align menu
Aligning gadgets from top to bottom
Aligning gadgets from left to right
Toolbar object template
Positioning the toolbar within a window
Interactive help for gadgets
Common features in gadget properties boxes
Opening a gadget properties box
Action button properties
Adjuster arrow properties
Button properties
Display field properties
Draggable properties
Label properties
Labelled box properties
Number range properties
Altering the size of the numerical field
Option button properties
Pop-up menu properties
Radio button properties
Slider properties
String set properties
Writable field properties
Editing other classes
Common features in standard dialogue boxes and menus
Colour Dialogue class
Colour Menu class
DCS class
File Info class
Font Dialogue class
Font Menu class
Iconbar icon class
Print Dialogue class
Prog Info class
Quit Dialogue class
Save As class
Scale Dialogue class
Exporting and importing messages
Keystroke equivalents
In the resource file display
In the Window editor
In the Menu editor
When editing in general
Mouse behaviour
In the Window editor
In the Menu editor window
In the resource file display
Box selection
Toolbox: Chapter 18: ResTest
ResTest
Starting ResTest
The iconbar menu
The event log window
Toolbox event code
Toolbox id block
Event block
WIMP events
The ResTest menu
Toolbox: Chapter 19: DrawFile
DrawFile
Differences between DrawFile output and !Draw output
Text
Transformed text
Text areas
Sprite colours
SWI DrawFile_Render
On entry
On exit
Use
C veneer
SWI DrawFile_BBox
On entry
On exit
Use
C veneer
SWI DrawFile_DeclareFonts
On entry
On exit
Use
C veneer
Toolbox: Appendix A: Resource File Formats
Resource File Formats
Terminology
Resource file format
Diagrammatic representation
Resource File Format Description
Relocations at Load Time
Table Formats
Strings table
Messages Table
Relocations Table
Toolbox: Appendix B: Support for RISC OS 3.10
Support for RISC OS 3.10
© 3QD Developments Ltd 2013
