getTextBox();
The getTextBox method returns text box of the input editor.
Returned value is an object of the PP.Ui.TextBox class.
To execute the example, the <head> tag of the HTML page must contain links to PP.js script files and to PP.css styles files, in the <body> tag of the HTML page of the <div> item with the combo identifier and the example must be placed in the <script> tag. In the onload event of the <body> tag it is necessary to specify the call of the createCombo() function. Add input editor with a drop-down panel to the page and implement the ValueChanged event handler:
var combo; function createCombo() { // Create input editor with a drop-down panel combo = new PP.Ui.Combo({ // Set paren item ParentNode: document.getElementById("combo"), // Set width Width: 100, // Set attribute of editors creation NoCreateEditors: false, /* Set the attribute that the tooltip is visible on hovering the mouse over the button of the drop-down panel opening */ IsHint: true, /* Set an attribute of the drop-down panel opening on clicking the header */ OpenOnContentClick: true, /* Set an attribute of the drop-down panel opening on clicking the component icon */ OpenOnIconClick: true, /* Set an attribute of the drop-down panel closing on the component contents clicking */ CloseOnContentClick: true, // Set icon to the left of the component IconPosition: PP.LTRB.Left, /* Set the attribute that the drop-down width ignores input editor width */ IsDropHasCombosWidth: false, // Set an icon of the input editor IconUrl: "../build/img/app/icons16x16.png", // Handle the event of icon clicking in the input editor IconClick: function(sender, args) { console.log("Icon is clicked in the input editor"); }, // Handle the event of value change in the input editor ValueChanged: function(sender, args) { console.log("Value is changed in the input editor"); }, }); // Put the text in the drop-down panel var panel = combo.getDropPanel(); panel.setContent("Text"); // Set width of the drop-down panel panel.setWidth(200); }
Click the input editor with a left mouse button. The OpenOnContentClick property is set to True, then drop-down panel opens. The drop-down panel is wider than input editor because the IsDropHasCombosWidth property is set to False:
Get sizes of the icon put in the input editor:
// Get sizes of the icon put in the input editor console.log("Icon height: " + combo.getIconHeight()); console.log("Icon width: " + combo.getIconWidth());
As a result the following is displayed in the console:
Icon height: 16
Icon width: 16
Set value in the text box of the input editor and determine whether it is possible edit the contents of the input editor:
// Set text in the input editor combo.getTextBox().setContent("Value"); //Determine whether it is possible to edit the text box of the input editor combo.setEnableEdit(true);
Click with the mouse button on the input editor icon. The OpenOnIconClick and CloseOnContentClick properties are set to True, that is why the drop-down panel closes:
The following message is displayed in the console:
Icon in the input editor is clicked
Double click with mouse button on the input editor and change the Value 1 contents. As a result, the following message is displayed in the console:
Value is changed in the input editor
Set characters available to input in the text box of the input editor and highlighting of invalid input:
// Clear the input editor combo.setContent(""); // Set characters available to input in the text box of the input editor var textBox = combo.getTextBox(); textBox.setAllowedSymbols(['1', '2', '3', '4']); // Set highlighting of invalid input combo.applyNotValidCSS();
Print the 12345 text in the input editor. As a result, in the text box of the input editor there is highlighting of invalid input and there is the following text: 1234:
Set highlighting of the valid input:
// Clear the input editor combo.setContent(""); // Set highlighting of valid input combo.applyValidCSS();
Print the 12345 text in the input editor. As a result, in the text box of the input editor there is a highlighting of valid input and there is the following text: 1234:
Hover the mouse cursor over the drop-down panel. As a result a tooltip is shown because the IsHint property is set to True:
Change icon of the input editor:
// Change icon of the input editor var iconImageList = new PP.ImageList({ //sprite source Source: "../build/img/app/help.png", //size of images in the sprite IconHeight: 16, IconWidth: 16, }); combo.setIconImageList(iconImageList);
As a result the icon of the input editor is changed:
See also: