h6. [[ColourPicker]] h6(. » [[ColourPicker SWI Calls|SWI Calls]] h6((. » ColourPicker_UpdateDialogue h2. ColourPicker_UpdateDialogue h5. (SWI &47704) |_<^{width:4em}. Entry | | |<^. R0 |<^. "Dialogue Update flags":#flags | |<^. R1 |<^. Pointer to [[ColourPicker Block|colour picker block]] | |_<^{width:4em}. Exit | | |<^. R0 |<^. Picker handle | |<^. R1 |<^. Window handle | h4(#flags). Dialogue Update Flags |_<^{width:4em}. 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 | h4. Use The purpose of this call is to update some or all of the contents of a colour picker dialogue. h4. 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 [[ColourPicker Block|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. h4. See also * [[ColourPicker_CloseDialogue]] * [[ColourPicker_OpenDialogue]] * [[Message_ColourPickerColourChanged]] * [[Message_HelpRequest]]