COLORCHOOSERDIALOG: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
(Change signed longs to unsigned longs for 32bpp colors)
m (Update optional args behavior)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:_COLORCHOOSERDIALOG}}
{{DISPLAYTITLE:_COLORCHOOSERDIALOG}}
The '''_COLORCHOOSERDIALOG''' function displays a standard color picker dialog box. It returns a 32-bit RGBA color with the alpha channel set to &HFF (255). A zero is returned if the user cancelled.
The '''_COLORCHOOSERDIALOG''' function displays a standard color picker dialog box. It returns a 32-bit RGBA color with the alpha channel set to &HFF (255). A zero is returned if the user cancelled.


{{PageSyntax}}
{{PageSyntax}}
:{{Parameter|color32bpp~&}} = [[_COLORCHOOSERDIALOG]]({{Parameter|title$}}[, {{Parameter|defaultRGB~&}}])
:{{Parameter|color32bpp~&}} = [[_COLORCHOOSERDIALOG]]([{{Parameter|title$}}][, {{Parameter|defaultRGB~&}}])




Line 18: Line 19:


{{PageAvailability}}
{{PageAvailability}}
* '''QB64-PE v3.4 and up'''
* '''QB64-PE v3.4.0 and up'''




{{PageExamples}}
{{PageExamples}}
; Example : Folder selection
; Example : Color selection
{{CodeStart}}
{{CodeStart}}
mycolor~& = {{Cl|_COLORCHOOSERDIALOG}}("Select a color", {{Cl|_RGB32}}(0, 255, 255))
mycolor~& = {{Cl|_COLORCHOOSERDIALOG}}({{Text|<nowiki>"Select a color"</nowiki>|#FFB100}}, {{Cl|_RGB32}}({{Text|0|#F580B1}}, {{Text|255|#F580B1}}, {{Text|255|#F580B1}}))
{{Cl|IF}} mycolor~& <> 0 {{Cl|THEN}} {{Cl|_MESSAGEBOX}} "Information", "You selected " + {{Cl|HEX$}}(mycolor~&)
{{Cl|IF}} mycolor~& <> {{Text|0|#F580B1}} {{Cl|THEN}} {{Cl|_MESSAGEBOX}} {{Text|<nowiki>"Information"</nowiki>|#FFB100}}, {{Text|<nowiki>"You selected "</nowiki>|#FFB100}} + {{Cl|HEX$}}(mycolor~&)
{{CodeEnd}}
{{CodeEnd}}



Latest revision as of 01:48, 3 June 2023

The _COLORCHOOSERDIALOG function displays a standard color picker dialog box. It returns a 32-bit RGBA color with the alpha channel set to &HFF (255). A zero is returned if the user cancelled.


Syntax

color32bpp~& = _COLORCHOOSERDIALOG([title$][, defaultRGB~&])


Parameters

  • title$ is the dialog box title
  • defaultRGB~& is the default 32-bit RGB color that is pre-selected


Description

  • title$ accepts an empty string ("") in which case system defaults are used
  • The dialog box automatically becomes a modal window if the application window is visible
  • defaultRGB~& may be ignored on some platforms


Availability

  • QB64-PE v3.4.0 and up


Examples

Example
Color selection
mycolor~& = _COLORCHOOSERDIALOG("Select a color", _RGB32(0, 255, 255))
IF mycolor~& <> 0 THEN _MESSAGEBOX "Information", "You selected " + HEX$(mycolor~&)


See also



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link