ColourPicker_UpdateDialogue (changes)
Showing changes from revision #0 to #1:
Added | Removed | Changed
ColourPicker
» SWI Calls
» ColourPicker_UpdateDialogue
ColourPicker_UpdateDialogue
(SWI &47704)
| Entry | |
|---|---|
| R0 | Dialogue Update flags |
| R1 | Pointer to colour picker block |
| Exit | |
|---|---|
| R0 | Picker handle |
| R1 | Window handle |
Dialogue Update Flags
| Bit | Update part of dialogue when set |
|---|---|
| 0 | Whether the dialogue has a None button |
| 1 | Whether the None button is selected |
| 2 | Where Message_ColourPickerColourChanged is issued for |
| 3 | Visible area |
| 4 | Reserved (must be 0) |
| 5 | Window title |
| 6 | Colour setting |
| 7 | Colour model and setting (including optional data) |
| 8 | Whether the dialogue ignores Message_HelpRequest |
| 9 | Whether the dialogue passes on unhandled keypresses |
Use
The purpose of this call is to update some or all of the contents of a colour picker dialogue.
Notes
The new values are taken from the passed colour picker block; all other parts of the block are ignored. The block need only be large enough to hold the highest offset field required.
The None button may be added or removed, and its setting adjusted. The title, setting and colour model may also be adjusted independently of each other.
If you are changing the visible area (ie bit 3 is set), you must fill in offsets 8 – 20 inclusive of the colour picker block including the reserved words. This is for future compatibility.
If bit 7 is set then bit 6 is ignored; the colour model is updated, and the RGB triplet is calculated from the data in the colour model block. If bit 6 is set and bit 7 is clear, then the colour setting is updated from the colour descriptor’s initial RGB triplet and the colour model left unchanged, even if the current colour model isn’t that in the colour descriptor.
SWI is not re-entrant.
See also
Social
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.