| Package | qnx.dialog |
| Class | public final class PasswordChangeDialog |
| Inheritance | PasswordChangeDialog  BaseDialog flash.events.EventDispatcher |
PasswordChangeDialog class encapsulates the properties of a
password set/change dialog. The password change dialog is used to provide
password modification functionality for the device. The user name field
is optional and is included to support use cases where the user name is implicit or
there is no user name (for example, device password).
See also
| Property | Defined By | ||
|---|---|---|---|
 | align : String [write-only]
Sets the position of the dialog. | BaseDialog | |
| confirmation : String [read-only]
Returns the new password confirmation entered by the user. | PasswordChangeDialog | ||
| confirmationLabel : String [write-only]
Sets the confirmation label for the dialog. | PasswordChangeDialog | ||
| confirmationPrompt : String [write-only]
Sets the confirmation placeholder text for the user. | PasswordChangeDialog | ||
| defaultButtonIndex : int
Gets or sets the default button index value. | BaseDialog | |
| dialogSize : String
Gets or sets the size of the dialog. | BaseDialog | |
| hideOnButtonClick : Boolean
Gets or sets the a value that determines if the dialog will close
when the user clicks a button. | BaseDialog | |
| hideOnOutsideClick : Boolean
Gets or sets the a value that determines if the dialog will close
when the user clicks outside the dialog ( perhaps on the modal ). | BaseDialog | |
| id : String
The ID of the dialog, where each ID is unique to the client owner. | BaseDialog | |
| message : String [write-only]
Sets the value of the message field. | PasswordChangeDialog | ||
| messageHtml : String [write-only]
Sets the message TextField's html value. | PasswordChangeDialog | ||
| modalAlpha : Number [write-only]
Sets the background alpha value. | BaseDialog | |
| newPassword : String [read-only]
Gets and sets the new password entered by the user. | PasswordChangeDialog | ||
| newPasswordLabel : String [write-only]
Sets the new password label for the dialog. | PasswordChangeDialog | ||
| newPasswordPrompt : String [write-only]
Sets the new password placeholder text for the user. | PasswordChangeDialog | ||
| password : String
Gets or sets the password entered by the user. | PasswordChangeDialog | ||
| passwordLabel : String [write-only]
Sets the password label for the dialog. | PasswordChangeDialog | ||
| passwordPrompt : String [write-only]
Sets the password placeholder text for the user. | PasswordChangeDialog | ||
| rememberMe : Boolean
Gets or sets a value that determines the user's preference for remembering login credentials. | PasswordChangeDialog | ||
| rememberMeLabel : String [write-only]
Sets the remember me label for the dialog check box. | PasswordChangeDialog | ||
| selectedIndex : int [read-only]
Returns the selected index of the button (that was clicked). | BaseDialog | |
| title : String [write-only]
Sets the text for the dialog's title. | BaseDialog | |
| titleHtml : String [write-only]
Sets the html text for the dialog's title. | BaseDialog | |
| username : String
Gets or sets the username entered by the user. | PasswordChangeDialog | ||
| usernameLabel : String [write-only]
Sets the user name label for the dialog. | PasswordChangeDialog | ||
| usernamePrompt : String [write-only]
Sets the user name placeholder text for the dialog. | PasswordChangeDialog | ||
| Method | Defined By | ||
|---|---|---|---|
Constructor for the PasswordChangeDialog class. | PasswordChangeDialog | ||
| addButton(label:String):int
Adds a button to the dialog. | BaseDialog | |
| cancel():void
Cancels or hides the dialog. | BaseDialog | |
| getButtonCount():int
Return the button count from the button array. | BaseDialog | |
| getButtonPropertyAt(prop:String, index:int):Object
Gets the value of a property, given the property name and property object index. | BaseDialog | |
| getItemAt(index:int):Object
Returns the button at the given index. | BaseDialog | |
| removeButtonAt(index:int):void
Removes a button from the dialog, given an index. | BaseDialog | |
| sendDescription():Object
Gathers up and returns the description object for the dialog (client side). | BaseDialog | |
| setButtonPropertyAt(prop:String, value:Object, index:int):void
Sets a button property given a property name, a property value, and the index of a button property object. | BaseDialog | |
| show(groupId:String = null):void
Shows the dialog on the screen as a system or application dialog. | BaseDialog | |
| update():void
Updates the dialog to reflect its current attributes. | BaseDialog | |
| confirmation | property |
Hide Inherited Public Properties
Show Inherited Public Propertiesconfirmation:String [read-only] Returns the new password confirmation entered by the user.
public function get confirmation():String| confirmationLabel | property |
confirmationLabel:String [write-only] Sets the confirmation label for the dialog.
If null, a default label is used since the confirmation field is not optional.
public function set confirmationLabel(value:String):void| confirmationPrompt | property |
confirmationPrompt:String [write-only] Sets the confirmation placeholder text for the user.
public function set confirmationPrompt(value:String):void| message | property |
message:String [write-only] Sets the value of the message field.
public function set message(value:String):voidSee also
| messageHtml | property |
messageHtml:String [write-only]
Sets the message TextField's html value.
In addition to providing HTML formatting to message text, the messageHtml method can be used to place
images from the web within the message body of a dialog. In the following listing, an external image is placed in the
body of a dialog and scaled using the width and height attributes.
var dialog:PasswordChangeDialog = new PasswordChangeDialog();
dialog.messageHtml = "<img src='http://www.somewebsite.com/somegraphic.jpg'" +
"width='500' height='350'/>";
public function set messageHtml(value:String):void| newPassword | property |
newPassword:String [read-only] Gets and sets the new password entered by the user.
public function get newPassword():String| newPasswordLabel | property |
newPasswordLabel:String [write-only] Sets the new password label for the dialog.
If null, a default label is used since the new password field is not optional.
public function set newPasswordLabel(value:String):void| newPasswordPrompt | property |
newPasswordPrompt:String [write-only] Sets the new password placeholder text for the user.
public function set newPasswordPrompt(value:String):void| password | property |
password:StringGets or sets the password entered by the user.
public function get password():String public function set password(value:String):void| passwordLabel | property |
passwordLabel:String [write-only] Sets the password label for the dialog. If null, the password field is not shown.
public function set passwordLabel(value:String):void| passwordPrompt | property |
passwordPrompt:String [write-only] Sets the password placeholder text for the user.
public function set passwordPrompt(value:String):void| rememberMe | property |
rememberMe:BooleanGets or sets a value that determines the user's preference for remembering login credentials.
public function get rememberMe():Boolean public function set rememberMe(value:Boolean):void| rememberMeLabel | property |
rememberMeLabel:String [write-only] Sets the remember me label for the dialog check box. If null, the remember me check box is not shown.
public function set rememberMeLabel(value:String):void| username | property |
username:StringGets or sets the username entered by the user.
public function get username():String public function set username(value:String):void| usernameLabel | property |
usernameLabel:String [write-only] Sets the user name label for the dialog. If null, the user name field is not shown.
public function set usernameLabel(value:String):void| usernamePrompt | property |
usernamePrompt:String [write-only] Sets the user name placeholder text for the dialog.
public function set usernamePrompt(value:String):void| PasswordChangeDialog | () | Constructor |
public function PasswordChangeDialog()
Constructor for the PasswordChangeDialog class.
The following code listing sets up a password change dialog with two buttons, a title, and a message:
private function showPwDialog():void
{
pw = new PasswordChangeDialog();
pw.title = "Password change";
pw.message = "Please enter your new password:";
pw.addButton("OK");
pw.addButton("Cancel");
pw.dialogSize= DialogSize.SIZE_MEDIUM;
pw.addEventListener(Event.SELECT, dButtonClicked);
pw.show(IowWindow.getAirWindow().group);
}
The code snippet above produces the following dialog:
Note: In the last line of the code snippet above, the window group ID is passed
into the show method:
.show(IowWindow.getAirWindow().group);