Class Fox::FXChoiceBox
In: rdoc-sources/FXChoiceBox.rb
Parent: FXDialogBox

The Choice Box provides a dialog panel to select one item out of a list of choices. The choices are provided as a list of text strings. When the dialog closes, the index of the selected choice is returned, while a -1 is returned if the dialog was canceled,

Methods

ask   new  

Public Class methods

ask(owner, opts, caption, text, icon, choices)

Show a modal choice dialog. Prompt the user using a dialog with given caption, icon, message text, and choices from array of strings. Returns -1 if the dialog box is cancelled, otherwise returns the index of the selected choice

Parameters:

owner:Owner for this dialog box [FXWindow or FXApp]
opts:Dialog box options [Integer]
caption:Caption for this dialog box [String]
text:Message text for this dialog box [String]
icon:Icon for this dialog box [FXIcon]
choices:Array of strings containing choices [Array]
new(owner, caption, text, icon, choices, opts=0, x=0, y=0, width=0, height=0) {|theChoiceBox| ...}

Construct choice box with given caption, icon, message text, and with choices from array of strings. If owner is another FXWindow, the dialog box is created as a child of that window. If owner is an FXApp instance, it‘s created as a free-floating dialog box.

Parameters:

owner:Owner for this dialog box [FXWindow or FXApp]
caption:Caption for this dialog box [String]
text:Message text for this dialog box [String]
icon:Icon for this dialog box [FXIcon]
choices:Array of strings containing choices [Array]
opts:Dialog box options [Integer]
x:x-coordinate
y:y-coordinate
width:width
height:height

[Validate]