KLayout Manual: Main Index » Class Index » API reference - Class InputDialog

API reference - Class InputDialog

Notation used in Ruby API documentation

Description: Various methods to open a dialog requesting data entry

Public constructors

InputDialognewCreates a new object of this class

Public methods

[const]voidassign(const InputDialog other)Assign the contents of another object to self
voidcreateEnsures the C++ object is created
voiddestroyExplicitly destroy the object
[const]booldestroyed?Returns a value indicating whether the object was already destroyed
[const]InputDialogdupCreates a copy of self
[const]boolis_const_object?Returns a value indicating whether the reference is a const reference

Public static methods and constants

variantask_double(string title,
string label,
double value,
int digits)
Open an input dialog requesting a floating-point value
variantask_double_ex(string title,
string label,
double value,
double min,
double max,
int digits)
Open an input dialog requesting a floating-point value with enhanced capabilities
variantask_int(string title,
string label,
int value)
Open an input dialog requesting an integer value
variantask_int_ex(string title,
string label,
int value,
int min,
int max,
int step)
Open an input dialog requesting an integer value with enhanced capabilities
variantask_item(string title,
string label,
string[] items,
int value)
Open an input dialog requesting an item from a list
variantask_string(string title,
string label,
string value)
Open an input dialog requesting a string
variantask_string_password(string title,
string label,
string value)
Open an input dialog requesting a string without showing the actual characters entered
DoubleValueget_double(string title,
string label,
double value,
int digits)
Open an input dialog requesting a floating-point value
DoubleValueget_double_ex(string title,
string label,
double value,
double min,
double max,
int digits)
Open an input dialog requesting a floating-point value with enhanced capabilities
IntValueget_int(string title,
string label,
int value)
Open an input dialog requesting an integer value
IntValueget_int_ex(string title,
string label,
int value,
int min,
int max,
int step)
Open an input dialog requesting an integer value with enhanced capabilities
StringValueget_item(string title,
string label,
string[] items,
int value)
Open an input dialog requesting an item from a list
StringValueget_string(string title,
string label,
string value)
Open an input dialog requesting a string
StringValueget_string_password(string title,
string label,
string value)
Open an input dialog requesting a string without showing the actual characters entered

Detailed description

[static] variant ask_double(string title,string label,double value,int digits)

Description: Open an input dialog requesting a floating-point value

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
digits:The number of digits allowed
Returns:The value entered if "Ok" was pressed or nil if "Cancel" was pressed

This method has been introduced in 0.22 and is somewhat easier to use than the get_.. equivalent.

[static] variant ask_double_ex(string title,string label,double value,double min,double max,int digits)

Description: Open an input dialog requesting a floating-point value with enhanced capabilities

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
min:The minimum value allowed
max:The maximum value allowed
digits:The number of digits allowed
Returns:The value entered if "Ok" was pressed or nil if "Cancel" was pressed

This method has been introduced in 0.22 and is somewhat easier to use than the get_.. equivalent.

[static] variant ask_int(string title,string label,int value)

Description: Open an input dialog requesting an integer value

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
Returns:The value entered if "Ok" was pressed or nil if "Cancel" was pressed

This method has been introduced in 0.22 and is somewhat easier to use than the get_.. equivalent.

[static] variant ask_int_ex(string title,string label,int value,int min,int max,int step)

Description: Open an input dialog requesting an integer value with enhanced capabilities

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
min:The minimum value allowed
max:The maximum value allowed
step:The step size for the spin buttons
Returns:The value entered if "Ok" was pressed or nil if "Cancel" was pressed

This method has been introduced in 0.22 and is somewhat easier to use than the get_.. equivalent.

[static] variant ask_item(string title,string label,string[] items,int value)

Description: Open an input dialog requesting an item from a list

title:The title to display for the dialog
label:The label text to display for the dialog
items:The list of items to show in the selection element
selection:The initial selection (index of the element selected intially)
Returns:The string of the item selected if "Ok" was pressed or nil if "Cancel" was pressed

This method has been introduced in 0.22 and is somewhat easier to use than the get_.. equivalent.

[static] variant ask_string(string title,string label,string value)

Description: Open an input dialog requesting a string

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
Returns:The string entered if "Ok" was pressed or nil if "Cancel" was pressed

This method has been introduced in 0.22 and is somewhat easier to use than the get_.. equivalent.

[static] variant ask_string_password(string title,string label,string value)

Description: Open an input dialog requesting a string without showing the actual characters entered

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
Returns:The string entered if "Ok" was pressed or nil if "Cancel" was pressed

This method has been introduced in 0.22 and is somewhat easier to use than the get_.. equivalent.

[const] void assign(const InputDialog other)

Description: Assign the contents of another object to self

This method assigns the contents of another object to self. This is a deep copy that does not only copy the reference but the actual content.

void create

Description: Ensures the C++ object is created

Use this method to ensure the C++ object is created, for example to ensure that resources are allocated. Usually C++ objects are created on demand and not necessarily when the script object is created.

void destroy

Description: Explicitly destroy the object

Explicitly destroy the object on C++ side if it was owned by the Ruby interpreter. Subsequent access to this object will throw an exception. If the object is not owned by Ruby, this method will do nothing.

[const] bool destroyed?

Description: Returns a value indicating whether the object was already destroyed

This method returns true, if the object was destroyed, either explicitly or by the C++ side. The latter may happen, if the object is owned by a C++ object which got destroyed itself.

[const] InputDialog dup

Description: Creates a copy of self

[static] DoubleValue get_double(string title,string label,double value,int digits)

Description: Open an input dialog requesting a floating-point value

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
digits:The number of digits allowed
Returns:A DoubleValue object with has_value? set to true, if "Ok" was pressed and the value given in it's value attribute

Starting from 0.22, this method is deprecated and it is recommended to use the ask_... equivalent.

[static] DoubleValue get_double_ex(string title,string label,double value,double min,double max,int digits)

Description: Open an input dialog requesting a floating-point value with enhanced capabilities

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
min:The minimum value allowed
max:The maximum value allowed
digits:The number of digits allowed
Returns:A DoubleValue object with has_value? set to true, if "Ok" was pressed and the value given in it's value attribute

Starting from 0.22, this method is deprecated and it is recommended to use the ask_... equivalent.

[static] IntValue get_int(string title,string label,int value)

Description: Open an input dialog requesting an integer value

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
Returns:A IntValue object with has_value? set to true, if "Ok" was pressed and the value given in it's value attribute

Starting from 0.22, this method is deprecated and it is recommended to use the ask_... equivalent.

[static] IntValue get_int_ex(string title,string label,int value,int min,int max,int step)

Description: Open an input dialog requesting an integer value with enhanced capabilities

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
min:The minimum value allowed
max:The maximum value allowed
step:The step size for the spin buttons
Returns:A IntValue object with has_value? set to true, if "Ok" was pressed and the value given in it's value attribute

Starting from 0.22, this method is deprecated and it is recommended to use the ask_... equivalent.

[static] StringValue get_item(string title,string label,string[] items,int value)

Description: Open an input dialog requesting an item from a list

title:The title to display for the dialog
label:The label text to display for the dialog
items:The list of items to show in the selection element
selection:The initial selection (index of the element selected intially)
Returns:A StringValue object with has_value? set to true, if "Ok" was pressed and the value given in it's value attribute

Starting from 0.22, this method is deprecated and it is recommended to use the ask_... equivalent.

[static] StringValue get_string(string title,string label,string value)

Description: Open an input dialog requesting a string

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
Returns:A StringValue object with has_value? set to true, if "Ok" was pressed and the value given in it's value attribute

Starting from 0.22, this method is deprecated and it is recommended to use the ask_... equivalent.

[static] StringValue get_string_password(string title,string label,string value)

Description: Open an input dialog requesting a string without showing the actual characters entered

title:The title to display for the dialog
label:The label text to display for the dialog
value:The initial value for the input field
Returns:A StringValue object with has_value? set to true, if "Ok" was pressed and the value given in it's value attribute

Starting from 0.22, this method is deprecated and it is recommended to use the ask_... equivalent.

[const] bool is_const_object?

Description: Returns a value indicating whether the reference is a const reference

This method returns true, if self is a const reference. In that case, only const methods may be called on self.

[static] InputDialog new

Description: Creates a new object of this class