Ceci est une ancienne révision du document !
Table des matières
InputDialog [En cours de Traduction Wismerheal][WSL]
Cet object représente une fenêtre demandant à l'utilisateur d'entrer des données.
Fonctions
InputDialog
Fonction de construction.
Syntaxe
var myObject = new InputDialog();
var myObject = new InputDialog(parameters);
Arguments
- parameters - (object) paramètres de fenêtre
- title - (string) le titre de la fenêtre
- position - (Point) la position de la fenêtre
- opacity - (float) l'opacité de la fenêtre
- enabled - (boolean) le statut d'activation de la fenêtre
- visible - (boolean) le statut de la fenêtre visible
- labelText - (string) le label de texte
- okButtonText - (string) le texte du bouton OK
- cancelButtonText - (string) le texte du bouton ANNULER
- textEchoMode - (TextEchoMode) le texte du mode "echo"
- floatDecimals - (integer) le nombre de décimales
- integerStep - (integer) the integer step (l'étape définissant un entier)
- minimum - (mixed) la valeur minimum
- maximum - (mixed) la valeur maximum
- range - (object) la portée
- minimum - (mixed) la valeur minimum
- maximum - (mixed) la valeur maximum
- inputType - (InputType) le type d'entrée
- value - (mixed) la valeur par défaut
- items - (array) les éléments (utilisé quand on demande un élément d'une liste)
- itemsEditable - (boolean) sont des éléments en provenance d'une liste éditable
- onClosed - (OnClosed) évènement appelé quand la fenêtre est fermée
- onValueChanged - (OnValueChanged) évènement appelé quand la valeur est changée
Exceptions
- (ParameterTypeError) type de paramètre incorrect
- (ParameterCountError) paramètre de compteur incorrect
Example
var myObject = new InputDialog();
var myObject = new InputDialog({ title: "Enter text:", inputType: InputDialog.Text });
Méthodes
setTitle
Définit le titre de la fenêtre.
Syntaxe
myObject.setTitle(title);
Arguments
- title - (string) le titre de la fenêtre
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
setPosition
Définit la position de la fenêtre.
Syntaxe
myObject.setPosition(point);
Arguments
- point - (Point) la position de la fenêtre
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
setOpacity
Définit l'opacité de la fenêtre.
Syntaxe
myObject.setOpacity(opacity);
Arguments
- opacity - (float) l'opacité de la fenêtre
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
setEnabled
Définit le statut d'activité de la fenêtre.
Syntax
myObject.setEnabled(enabled);
Arguments
- enabled - (boolean) le statut d'activité de la fenêtre
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
setVisible
Définit le statut visible de la fenêtre.
Syntaxe
myObject.setVisible(visible);
Arguments
- visible - (boolean) le statut visible de la fenêtre
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
close
Ferme la fenêtre.
Syntaxe
myObject.close();
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
title
Renvoi le titre de la fenêtre.
Syntaxe
myObject.title();
Renvoi
- (string) le titre de la fenêtre
position
Renvoi la position de la fenêtre.
Syntaxe
myObject.position();
Renvoi
- (Point) la position de la fenêtre
opacity
Renvoi l'opacité de la fenêtre.
Syntaxe
myObject.opacity();
Renvoi
- (float) l'opacité de la fenêtre
enabled
Renvoi le statut d'activité de la fenêtre.
Syntaxe
myObject.enabled();
Renvoi
- (boolean) le statut d'activité de la fenêtre
visible
Renvoi le statut visible de la fenêtre.
Syntaxe
myObject.visible();
Renvoi
- (boolean) le statut visible de la fenêtre
setLabelText
Définit le label de texte.
Syntaxe
myObject.setLabelText(text);
Arguments
- text - (string) le label de texte
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
setOkButtonText
Définit le texte du bouton OK.
Syntaxe
myObject.setLabelText(text);
Arguments
- text - (string) le label du bouton OK
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
setCancelButtonText
Définit le texte du bouton ANNULER.
Syntaxe
myObject.setCancelButtonText(text);
Arguments
- text - (string) le label du bouton ANNULER
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
setTextEchoMode
Définit le texte du mode "echo".
Syntaxe
myObject.setTextEchoMode(textEchoMode);
Arguments
- textEchoMode - (TextEchoMode) le texte du mode "echo"
Renvoi
- (InputDialog) ce "InputDialog" (dialog d'entrée)
setFloatDecimals
Définit le nombre de décimales des valeurs à virgule (floating values).
Syntaxe
myObject.setFloatDecimals(decimals);
Arguments
- decimals - (integer) the number of decimals of floating values
Returns
- (InputDialog) this InputDialog
setIntegerStep
Sets the integer step value.
Syntax
myObject.setIntegerStep(step);
Arguments
- step - (integer) the integer step value
Returns
- (InputDialog) this InputDialog
setMaximum
Sets the maximum value.
Syntax
myObject.setMaximum(maximum);
Arguments
- maximum - (mixed) the maximum value
Returns
- (InputDialog) this InputDialog
setMinimum
Sets the minimum value.
Syntax
myObject.setMinimum(minimum);
Arguments
- minimum - (mixed) the minimum value
Returns
- (InputDialog) this InputDialog
setRange
Sets the minimum and maximum values.
Syntax
myObject.setRange(minimum, maximum);
Arguments
- minimum - (mixed) the minimum value
- maximum - (mixed) the maximum value
Returns
- (InputDialog) this InputDialog
setInputType
Sets the input type.
Syntax
myObject.setRange(inputType);
Arguments
- inputType - (InputType) the input type
Returns
- (InputDialog) this InputDialog
setValue
Sets the value.
Syntax
myObject.setValue(value);
Arguments
- value - (mixed) the value
Returns
- (InputDialog) this InputDialog
setItems
Sets the items that can be choosen from.
Syntax
myObject.setItems(items);
Arguments
- items - (array) the items that can be choosen from
Returns
- (InputDialog) this InputDialog
setItemsEditable
Sets the items as editable.
Syntax
myObject.setItemsEditable(itemsEditable);
Arguments
- itemsEditable - (boolean) should the item list be editable
Returns
- (InputDialog) this InputDialog
value
Returns the value.
Syntax
myObject.value();
Returns
- (mixed) the value
show
Show the window. (non-blocking) Use the OnClosed event to know when the window has been closed.
Syntax
myObject.show();
Returns
- (InputDialog) this InputDialog
showModal
Show the window. (blocking)
Syntax
myObject.showModal();
Returns
- (integer) the window result (0 means that it has been canceled)
Events
onClosed
Called when the window is closed.
Syntax
myObject.onClosed = function(result) {};
Arguments
- result - (integer) the window result (0 means that it has been canceled)
Example
myObject.onClosed = function(result) { if(result) { //Event action } };
onValueChanged
Called when the value changes.
Syntax
myObject.onValueChanged = function(value) {};
Arguments
- value - (mixed) the current value
Example
myObject.onValueChanged = function(value) { //Event action };
Attributes
title
The window's title. (string)
position
The window's position. (Point)
opacity
The window's opacity. (float)
enabled
The window's enabled status. (boolean)
visible
The window's visible status. (boolean)
value
The window's value. (mixed)
Enumerations
InputType
The input type.
Values
- Text: text
- Integer: an integer
- Float: a floating number (decimal)
- Items: a list of items
TextEchoMode
The text echo mode.
Values
- Normal: normal text display
- NoEcho: do not show the text
- Password: show password characters instead of the typed characters
- PasswordEchoOnEdit: show password characters instead of the typed characters only when editing