text: /*
  Copyright (c) 2003-2013, CKSource - Frederico Knabben. All rights reserved.
  For licensing, see LICENSE.html or http://ckeditor.com/license
  */
  
  /**
   * @fileOverview Defines the "virtual" dialog, dialog content and dialog button
   * definition classes.
   */
  
  /**
   * The definition of a dialog window.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create dialogs.
   * </div>
   * @name CKEDITOR.dialog.definition
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * CKEDITOR.dialog.add( 'testOnly', function( editor )
   *       {
   *           return {
   *               title : 'Test Dialog',
   *               resizable : CKEDITOR.DIALOG_RESIZE_BOTH,
   *               minWidth : 500,
   *               minHeight : 400,
   *               contents : [
   *                   {
   *                       id : 'tab1',
   *                       label : 'First Tab',
   *                       title : 'First Tab Title',
   *                       accessKey : 'Q',
   *                       elements : [
   *                           {
   *                               type : 'text',
   *                               label : 'Test Text 1',
   *                               id : 'testText1',
   *                               'default' : 'hello world!'
   *                           }
   *                       ]
   *                    }
   *               ]
   *           };
   *       });
   */
  
  /**
   * The dialog title, displayed in the dialog's header. Required.
   * @name CKEDITOR.dialog.definition.prototype.title
   * @field
   * @type String
   * @example
   */
  
  /**
   * How the dialog can be resized, must be one of the four contents defined below.
   * <br /><br />
   * <strong>CKEDITOR.DIALOG_RESIZE_NONE</strong><br />
   * <strong>CKEDITOR.DIALOG_RESIZE_WIDTH</strong><br />
   * <strong>CKEDITOR.DIALOG_RESIZE_HEIGHT</strong><br />
   * <strong>CKEDITOR.DIALOG_RESIZE_BOTH</strong><br />
   * @name CKEDITOR.dialog.definition.prototype.resizable
   * @field
   * @type Number
   * @default CKEDITOR.DIALOG_RESIZE_NONE
   * @example
   */
  
  /**
   * The minimum width of the dialog, in pixels.
   * @name CKEDITOR.dialog.definition.prototype.minWidth
   * @field
   * @type Number
   * @default 600
   * @example
   */
  
  /**
   * The minimum height of the dialog, in pixels.
   * @name CKEDITOR.dialog.definition.prototype.minHeight
   * @field
   * @type Number
   * @default 400
   * @example
   */
  
  
  /**
   * The initial width of the dialog, in pixels.
   * @name CKEDITOR.dialog.definition.prototype.width
   * @field
   * @type Number
   * @default @CKEDITOR.dialog.definition.prototype.minWidth
   * @since 3.5.3
   * @example
   */
  
  /**
   * The initial height of the dialog, in pixels.
   * @name CKEDITOR.dialog.definition.prototype.height
   * @field
   * @type Number
   * @default @CKEDITOR.dialog.definition.prototype.minHeight
   * @since 3.5.3
   * @example
   */
  
  /**
   * The buttons in the dialog, defined as an array of
   * {@link CKEDITOR.dialog.definition.button} objects.
   * @name CKEDITOR.dialog.definition.prototype.buttons
   * @field
   * @type Array
   * @default [ CKEDITOR.dialog.okButton, CKEDITOR.dialog.cancelButton ]
   * @example
   */
  
  /**
   * The contents in the dialog, defined as an array of
   * {@link CKEDITOR.dialog.definition.content} objects. Required.
   * @name CKEDITOR.dialog.definition.prototype.contents
   * @field
   * @type Array
   * @example
   */
  
  /**
   * The function to execute when OK is pressed.
   * @name CKEDITOR.dialog.definition.prototype.onOk
   * @field
   * @type Function
   * @example
   */
  
  /**
   * The function to execute when Cancel is pressed.
   * @name CKEDITOR.dialog.definition.prototype.onCancel
   * @field
   * @type Function
   * @example
   */
  
  /**
   * The function to execute when the dialog is displayed for the first time.
   * @name CKEDITOR.dialog.definition.prototype.onLoad
   * @field
   * @type Function
   * @example
   */
  
  /**
   * The function to execute when the dialog is loaded (executed every time the dialog is opened).
   * @name CKEDITOR.dialog.definition.prototype.onShow
   * @field
   * @type Function
   * @example
   */
  
  /**
   * <div class="notapi">This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create dialog content pages.</div>
   * @name CKEDITOR.dialog.definition.content
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   */
  
  /**
   * The id of the content page.
   * @name CKEDITOR.dialog.definition.content.prototype.id
   * @field
   * @type String
   * @example
   */
  
  /**
   * The tab label of the content page.
   * @name CKEDITOR.dialog.definition.content.prototype.label
   * @field
   * @type String
   * @example
   */
  
  /**
   * The popup message of the tab label.
   * @name CKEDITOR.dialog.definition.content.prototype.title
   * @field
   * @type String
   * @example
   */
  
  /**
   * The CTRL hotkey for switching to the tab.
   * @name CKEDITOR.dialog.definition.content.prototype.accessKey
   * @field
   * @type String
   * @example
   * contentDefinition.accessKey = 'Q';	// Switch to this page when CTRL-Q is pressed.
   */
  
  /**
   * The UI elements contained in this content page, defined as an array of
   * {@link CKEDITOR.dialog.definition.uiElement} objects.
   * @name CKEDITOR.dialog.definition.content.prototype.elements
   * @field
   * @type Array
   * @example
   */
  
  /**
   * The definition of user interface element (textarea, radio etc).
   * <div class="notapi">This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create dialog UI elements.</div>
   * @name CKEDITOR.dialog.definition.uiElement
   * @constructor
   * @see CKEDITOR.ui.dialog.uiElement
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   */
  
  /**
   * The id of the UI element.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.id
   * @field
   * @type String
   * @example
   */
  
  /**
   * The type of the UI element. Required.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.type
   * @field
   * @type String
   * @example
   */
  
  /**
   * The popup label of the UI element.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.title
   * @field
   * @type String
   * @example
   */
  
  /**
   * CSS class names to append to the UI element.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.className
   * @field
   * @type String
   * @example
   */
  
  /**
   * Inline CSS classes to append to the UI element.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.style
   * @field
   * @type String
   * @example
   */
  
  /**
   * Horizontal alignment (in container) of the UI element.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.align
   * @field
   * @type String
   * @example
   */
  
  /**
   * Function to execute the first time the UI element is displayed.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.onLoad
   * @field
   * @type Function
   * @example
   */
  
  /**
   * Function to execute whenever the UI element's parent dialog is displayed.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.onShow
   * @field
   * @type Function
   * @example
   */
  
  /**
   * Function to execute whenever the UI element's parent dialog is closed.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.onHide
   * @field
   * @type Function
   * @example
   */
  
  /**
   * Function to execute whenever the UI element's parent dialog's {@link CKEDITOR.dialog.definition.setupContent} method is executed.
   * It usually takes care of the respective UI element as a standalone element.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.setup
   * @field
   * @type Function
   * @example
   */
  
  /**
   * Function to execute whenever the UI element's parent dialog's {@link CKEDITOR.dialog.definition.commitContent} method is executed.
   * It usually takes care of the respective UI element as a standalone element.
   * @name CKEDITOR.dialog.definition.uiElement.prototype.commit
   * @field
   * @type Function
   * @example
   */
  
  // ----- hbox -----
  
  /**
   * Horizontal layout box for dialog UI elements, auto-expends to available width of container.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create horizontal layouts.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.hbox} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * @name CKEDITOR.dialog.definition.hbox
   * @extends CKEDITOR.dialog.definition.uiElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example:
   * {
   * 	<b>type : 'hbox',</b>
   * 	widths : [ '25%', '25%', '50%' ],
   * 	children :
   * 	[
   * 		{
   * 			type : 'text',
   * 			id : 'id1',
   * 			width : '40px',
   * 		},
   * 		{
   * 			type : 'text',
   * 			id : 'id2',
   * 			width : '40px',
   * 		},
   * 		{
   * 			type : 'text',
   * 			id : 'id3'
   * 		}
   * 	]
   * }
   */
  
  /**
   * Array of {@link CKEDITOR.ui.dialog.uiElement} objects inside this container.
   * @name CKEDITOR.dialog.definition.hbox.prototype.children
   * @field
   * @type Array
   * @example
   */
  
  /**
   * (Optional) The widths of child cells.
   * @name CKEDITOR.dialog.definition.hbox.prototype.widths
   * @field
   * @type Array
   * @example
   */
  
  /**
   * (Optional) The height of the layout.
   * @name CKEDITOR.dialog.definition.hbox.prototype.height
   * @field
   * @type Number
   * @example
   */
  
  /**
   * The CSS styles to apply to this element.
   * @name CKEDITOR.dialog.definition.hbox.prototype.styles
   * @field
   * @type String
   * @example
   */
  
  /**
   * (Optional) The padding width inside child cells. Example: 0, 1.
   * @name CKEDITOR.dialog.definition.hbox.prototype.padding
   * @field
   * @type Number
   * @example
   */
  
  /**
   * (Optional) The alignment of the whole layout. Example: center, top.
   * @name CKEDITOR.dialog.definition.hbox.prototype.align
   * @field
   * @type String
   * @example
   */
  
  // ----- vbox -----
  
  /**
   * Vertical layout box for dialog UI elements.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create vertical layouts.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.vbox} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * <style type="text/css">.details .detailList {display:none;} </style>
   * @name CKEDITOR.dialog.definition.vbox
   * @extends CKEDITOR.dialog.definition.uiElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example:
   * {
   * 	<b>type : 'vbox',</b>
   * 	align : 'right',
   * 	width : '200px',
   * 	children :
   * 	[
   * 		{
   * 			type : 'text',
   * 			id : 'age',
   * 			label : 'Age'
   * 		},
   * 		{
   * 			type : 'text',
   * 			id : 'sex',
   * 			label : 'Sex'
   * 		},
   * 		{
   * 			type : 'text',
   * 			id : 'nationality',
   * 			label : 'Nationality'
   * 		}
   * 	]
   * }
   */
  
  /**
   * Array of {@link CKEDITOR.ui.dialog.uiElement} objects inside this container.
   * @name CKEDITOR.dialog.definition.vbox.prototype.children
   * @field
   * @type Array
   * @example
   */
  
  /**
   * (Optional) The width of the layout.
   * @name CKEDITOR.dialog.definition.vbox.prototype.width
   * @field
   * @type Array
   * @example
   */
  
  /**
   * (Optional) The heights of individual cells.
   * @name CKEDITOR.dialog.definition.vbox.prototype.heights
   * @field
   * @type Number
   * @example
   */
  
  /**
   * The CSS styles to apply to this element.
   * @name CKEDITOR.dialog.definition.vbox.prototype.styles
   * @field
   * @type String
   * @example
   */
  
  /**
   * (Optional) The padding width inside child cells. Example: 0, 1.
   * @name CKEDITOR.dialog.definition.vbox.prototype.padding
   * @field
   * @type Number
   * @example
   */
  
  /**
   * (Optional) The alignment of the whole layout. Example: center, top.
   * @name CKEDITOR.dialog.definition.vbox.prototype.align
   * @field
   * @type String
   * @example
   */
  
  /**
   * (Optional) Whether the layout should expand vertically to fill its container.
   * @name CKEDITOR.dialog.definition.vbox.prototype.expand
   * @field
   * @type Boolean
   * @example
   */
  
  // ----- labeled element ------
  
  /**
   * The definition of labeled user interface element (textarea, textInput etc).
   * <div class="notapi">This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create dialog UI elements.</div>
   * @name CKEDITOR.dialog.definition.labeledElement
   * @extends CKEDITOR.dialog.definition.uiElement
   * @constructor
   * @see CKEDITOR.ui.dialog.labeledElement
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   */
  
  /**
   * The label of the UI element.
   * @name CKEDITOR.dialog.definition.labeledElement.prototype.label
   * @type String
   * @field
   * @example
   * {
   * 		type : 'text',
   * 		label : 'My Label '
   * }
   */
  
  /**
   * (Optional) Specify the layout of the label. Set to 'horizontal' for horizontal layout.
   * The default layout is vertical.
   * @name CKEDITOR.dialog.definition.labeledElement.prototype.labelLayout
   * @type String
   * @field
   * @example
   * {
   * 		type : 'text',
   * 		label : 'My Label ',
   * 	<strong>	labelLayout : 'horizontal',</strong>
   * }
   */
  
  /**
   * (Optional) Applies only to horizontal layouts: a two elements array of lengths to specify the widths of the
  * 	label and the content element. See also {@link CKEDITOR.dialog.definition.labeledElement#labelLayout}.
   * @name CKEDITOR.dialog.definition.labeledElement.prototype.widths
   * @type Array
   * @field
   * @example
   * {
   * 		type : 'text',
   * 		label : 'My Label ',
   * 		labelLayout : 'horizontal',
   * 	<strong>	widths : [100, 200],</strong>
   * }
   */
  
  /**
   *  Specify the inline style of the uiElement label.
   * @name CKEDITOR.dialog.definition.labeledElement.prototype.labelStyle
   * @type String
   * @field
   * @example
   * {
   * 		type : 'text',
   * 		label : 'My Label ',
   * 	<strong>	labelStyle : 'color: red',</strong>
   * }
   */
  
  
  /**
   *  Specify the inline style of the input element.
   * @name CKEDITOR.dialog.definition.labeledElement.prototype.inputStyle
   * @type String
   * @since 3.6.1
   * @field
   * @example
   * {
   * 		type : 'text',
   * 		label : 'My Label ',
   * 	<strong>	inputStyle : 'text-align:center',</strong>
   * }
   */
  
  /**
   *  Specify the inline style of the input element container .
   * @name CKEDITOR.dialog.definition.labeledElement.prototype.controlStyle
   * @type String
   * @since 3.6.1
   * @field
   * @example
   * {
   * 		type : 'text',
   * 		label : 'My Label ',
   * 	<strong>	controlStyle : 'width:3em',</strong>
   * }
   */
  
  
  // ----- button ------
  
  /**
   * The definition of a button.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create buttons.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.button} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
   * @name CKEDITOR.dialog.definition.button
   * @extends CKEDITOR.dialog.definition.uiElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example:
   * {
   * 	<b>type : 'button',</b>
   * 	id : 'buttonId',
   * 	label : 'Click me',
   * 	title : 'My title',
   * 	onClick : function() {
   * 		// this = CKEDITOR.ui.dialog.button
   * 		alert( 'Clicked: ' + this.id );
   * 	}
   * }
   */
  
  /**
   * Whether the button is disabled.
   * @name CKEDITOR.dialog.definition.button.prototype.disabled
   * @type Boolean
   * @field
   * @example
   */
  
  /**
   * The label of the UI element.
   * @name CKEDITOR.dialog.definition.button.prototype.label
   * @type String
   * @field
   * @example
   */
  
  // ----- checkbox ------
  
  /**
   * The definition of a checkbox element.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create groups of checkbox buttons.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.checkbox} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
   * @name CKEDITOR.dialog.definition.checkbox
   * @extends CKEDITOR.dialog.definition.uiElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example:
   * {
   * 	<b>type : 'checkbox',</b>
   * 	id : 'agree',
   * 	label : 'I agree',
   * 	'default' : 'checked',
   * 	onClick : function() {
   * 		// this = CKEDITOR.ui.dialog.checkbox
   * 		alert( 'Checked: ' + this.getValue() );
   * 	}
   * }
   */
  
  /**
   * (Optional) The validation function.
   * @name CKEDITOR.dialog.definition.checkbox.prototype.validate
   * @field
   * @type Function
   * @example
   */
  
  /**
   * The label of the UI element.
   * @name CKEDITOR.dialog.definition.checkbox.prototype.label
   * @type String
   * @field
   * @example
   */
  
  /**
   * The default state.
   * @name CKEDITOR.dialog.definition.checkbox.prototype.default
   * @type String
   * @field
   * @default
   * '' (unchecked)
   * @example
   */
  
  // ----- file -----
  
  /**
   * The definition of a file upload input.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create file upload elements.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.file} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
   * @name CKEDITOR.dialog.definition.file
   * @extends CKEDITOR.dialog.definition.labeledElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example:
   * {
   * 	<b>type : 'file'</b>,
   * 	id : 'upload',
   * 	label : 'Select file from your computer',
   * 	size : 38
   * },
   * {
   * 	type : 'fileButton',
   * 	id : 'fileId',
   * 	label : 'Upload file',
   * 	'for' : [ 'tab1', 'upload' ]
   * 	filebrowser : {
   * 		onSelect : function( fileUrl, data ) {
   * 			alert( 'Successfully uploaded: ' + fileUrl );
   * 		}
   * 	}
   * }
   */
  
  /**
   * (Optional) The validation function.
   * @name CKEDITOR.dialog.definition.file.prototype.validate
   * @field
   * @type Function
   * @example
   */
  
  /**
   * (Optional) The action attribute of the form element associated with this file upload input.
   * If empty, CKEditor will use path to server connector for currently opened folder.
   * @name CKEDITOR.dialog.definition.file.prototype.action
   * @type String
   * @field
   * @example
   */
  
  /**
   * The size of the UI element.
   * @name CKEDITOR.dialog.definition.file.prototype.size
   * @type Number
   * @field
   * @example
   */
  
  // ----- fileButton -----
  
  /**
   * The definition of a button for submitting the file in a file upload input.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create a button for submitting the file in a file upload input.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.fileButton} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
   * @name CKEDITOR.dialog.definition.fileButton
   * @extends CKEDITOR.dialog.definition.uiElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example:
   * {
   * 	type : 'file',
   * 	id : 'upload',
   * 	label : 'Select file from your computer',
   * 	size : 38
   * },
   * {
   * 	<b>type : 'fileButton'</b>,
   * 	id : 'fileId',
   * 	label : 'Upload file',
   * 	'for' : [ 'tab1', 'upload' ]
   * 	filebrowser : {
   * 		onSelect : function( fileUrl, data ) {
   * 			alert( 'Successfully uploaded: ' + fileUrl );
   * 		}
   * 	}
   * }
   */
  
  /**
   * (Optional) The validation function.
   * @name CKEDITOR.dialog.definition.fileButton.prototype.validate
   * @field
   * @type Function
   * @example
   */
  
  /**
   * The label of the UI element.
   * @name CKEDITOR.dialog.definition.fileButton.prototype.label
   * @type String
   * @field
   * @example
   */
  
  /**
   * The instruction for CKEditor how to deal with file upload.
   * By default, the file and fileButton elements will not work "as expected" if this attribute is not set.
   * @name CKEDITOR.dialog.definition.fileButton.prototype.filebrowser
   * @type String|Object
   * @field
   * @example
   * // Update field with id 'txtUrl' in the 'tab1' tab when file is uploaded.
   * filebrowser : 'tab1:txtUrl'
   *
   * // Call custom onSelect function when file is successfully uploaded.
   * filebrowser : {
   * 	onSelect : function( fileUrl, data ) {
   * 		alert( 'Successfully uploaded: ' + fileUrl );
   * 	}
   * }
   */
  
  /**
   * An array that contains pageId and elementId of the file upload input element for which this button is created.
   * @name CKEDITOR.dialog.definition.fileButton.prototype.for
   * @type String
   * @field
   * @example
   * [ pageId, elementId ]
   */
  
  // ----- html -----
  
  /**
   * The definition of a raw HTML element.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create elements made from raw HTML code.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.html} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.<br />
   * To access HTML elements use {@link CKEDITOR.dom.document#getById}
   * @name CKEDITOR.dialog.definition.html
   * @extends CKEDITOR.dialog.definition.uiElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example 1:
   * {
   * 	<b>type : 'html',</b>
   * 	html : '&lt;h3>This is some sample HTML content.&lt;/h3>'
   * }
   * @example
   * // Example 2:
   * // Complete sample with document.getById() call when the "Ok" button is clicked.
   * var dialogDefinition =
   * {
   * 	title : 'Sample dialog',
   * 	minWidth : 300,
   * 	minHeight : 200,
   * 	onOk : function() {
   * 		// "this" is now a CKEDITOR.dialog object.
   * 		var document = this.getElement().getDocument();
   * 		// document = CKEDITOR.dom.document
   * 		var element = <b>document.getById( 'myDiv' );</b>
   * 		if ( element )
   * 			alert( element.getHtml() );
   * 	},
   * 	contents : [
   * 		{
   * 			id : 'tab1',
   * 			label : '',
   * 			title : '',
   * 			elements :
   * 			[
   * 				{
   * 					<b>type : 'html',</b>
   * 					html : '<b>&lt;div id="myDiv">Sample &lt;b>text&lt;/b>.&lt;/div></b>&lt;div id="otherId">Another div.&lt;/div>'
   * 				},
   * 			]
   * 		}
   * 	],
   * 	buttons : [ CKEDITOR.dialog.cancelButton, CKEDITOR.dialog.okButton ]
   * };
   */
  
  /**
   * (Required) HTML code of this element.
   * @name CKEDITOR.dialog.definition.html.prototype.html
   * @type String
   * @field
   * @example
   */
  
  // ----- radio ------
  
  /**
   * The definition of a radio group.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create groups of radio buttons.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.radio} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
   * @name CKEDITOR.dialog.definition.radio
   * @extends CKEDITOR.dialog.definition.labeledElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example:
   * {
   * 	<b>type : 'radio',</b>
   * 	id : 'country',
   * 	label : 'Which country is bigger',
   * 	items : [ [ 'France', 'FR' ], [ 'Germany', 'DE' ] ] ,
   * 	style : 'color:green',
   * 	'default' : 'DE',
   * 	onClick : function() {
   * 		// this = CKEDITOR.ui.dialog.radio
   * 		alert( 'Current value: ' + this.getValue() );
   * 	}
   * }
   */
  
  /**
   * The default value.
   * @name CKEDITOR.dialog.definition.radio.prototype.default
   * @type String
   * @field
   * @example
   */
  
  /**
   * (Optional) The validation function.
   * @name CKEDITOR.dialog.definition.radio.prototype.validate
   * @field
   * @type Function
   * @example
   */
  
  /**
   *  An array of options. Each option is a 1- or 2-item array of format [ 'Description', 'Value' ]. If 'Value' is missing, then the value would be assumed to be the same as the description.
   * @name CKEDITOR.dialog.definition.radio.prototype.items
   * @field
   * @type Array
   * @example
   */
  
  // ----- selectElement ------
  
  /**
   * The definition of a select element.
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create select elements.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.select} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
   * @name CKEDITOR.dialog.definition.select
   * @extends CKEDITOR.dialog.definition.labeledElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example:
   * {
   * 	<b>type : 'select',</b>
   * 	id : 'sport',
   * 	label : 'Select your favourite sport',
   * 	items : [ [ 'Basketball' ], [ 'Baseball' ], [ 'Hockey' ], [ 'Football' ] ],
   * 	'default' : 'Football',
   * 	onChange : function( api ) {
   * 		// this = CKEDITOR.ui.dialog.select
   * 		alert( 'Current value: ' + this.getValue() );
   * 	}
   * }
   */
  
  /**
   * The default value.
   * @name CKEDITOR.dialog.definition.select.prototype.default
   * @type String
   * @field
   * @example
   */
  
  /**
   * (Optional) The validation function.
   * @name CKEDITOR.dialog.definition.select.prototype.validate
   * @field
   * @type Function
   * @example
   */
  
  /**
   *  An array of options. Each option is a 1- or 2-item array of format [ 'Description', 'Value' ]. If 'Value' is missing, then the value would be assumed to be the same as the description.
   * @name CKEDITOR.dialog.definition.select.prototype.items
   * @field
   * @type Array
   * @example
   */
  
  /**
   * (Optional) Set this to true if you'd like to have a multiple-choice select box.
   * @name CKEDITOR.dialog.definition.select.prototype.multiple
   * @type Boolean
   * @field
   * @example
   * @default false
   */
  
  /**
   * (Optional) The number of items to display in the select box.
   * @name CKEDITOR.dialog.definition.select.prototype.size
   * @type Number
   * @field
   * @example
   */
  
  // ----- textInput -----
  
  /**
   * The definition of a text field (single line).
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create text fields.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.textInput} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
   * @name CKEDITOR.dialog.definition.textInput
   * @extends CKEDITOR.dialog.definition.labeledElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * {
   * 	<b>type : 'text',</b>
   * 	id : 'name',
   * 	label : 'Your name',
   * 	'default' : '',
   * 	validate : function() {
   * 		if ( !this.getValue() )
   * 		{
   * 			api.openMsgDialog( '', 'Name cannot be empty.' );
   * 			return false;
   * 		}
   * 	}
   * }
   */
  
  /**
   * The default value.
   * @name CKEDITOR.dialog.definition.textInput.prototype.default
   * @type String
   * @field
   * @example
   */
  
  /**
   * (Optional) The maximum length.
   * @name CKEDITOR.dialog.definition.textInput.prototype.maxLength
   * @type Number
   * @field
   * @example
   */
  
  /**
   * (Optional) The size of the input field.
   * @name CKEDITOR.dialog.definition.textInput.prototype.size
   * @type Number
   * @field
   * @example
   */
  
  /**
   * (Optional) The validation function.
   * @name CKEDITOR.dialog.definition.textInput.prototype.validate
   * @field
   * @type Function
   * @example
   */
  
  // ----- textarea ------
  
  /**
   * The definition of a text field (multiple lines).
   * <div class="notapi">
   * This class is not really part of the API. It just illustrates the properties
   * that developers can use to define and create textarea.
   * <br /><br />Once the dialog is opened, the created element becomes a {@link CKEDITOR.ui.dialog.textarea} object and can be accessed with {@link CKEDITOR.dialog#getContentElement}.
   * </div>
   * For a complete example of dialog definition, please check {@link CKEDITOR.dialog.add}.
   * @name CKEDITOR.dialog.definition.textarea
   * @extends CKEDITOR.dialog.definition.labeledElement
   * @constructor
   * @example
   * // There is no constructor for this class, the user just has to define an
   * // object with the appropriate properties.
   *
   * // Example:
   * {
   * 	<b>type : 'textarea',</b>
   * 	id : 'message',
   * 	label : 'Your comment',
   * 	'default' : '',
   * 	validate : function() {
   * 		if ( this.getValue().length < 5 )
   * 		{
   * 			api.openMsgDialog( 'The comment is too short.' );
   * 			return false;
   * 		}
   * 	}
   * }
   */
  
  /**
   * The number of rows.
   * @name CKEDITOR.dialog.definition.textarea.prototype.rows
   * @type Number
   * @field
   * @example
   */
  
  /**
   * The number of columns.
   * @name CKEDITOR.dialog.definition.textarea.prototype.cols
   * @type Number
   * @field
   * @example
   */
  
  /**
   * (Optional) The validation function.
   * @name CKEDITOR.dialog.definition.textarea.prototype.validate
   * @field
   * @type Function
   * @example
   */
  
  /**
   * The default value.
   * @name CKEDITOR.dialog.definition.textarea.prototype.default
   * @type String
   * @field
   * @example
   */
  