Class: CV

Methods

apyOpt(rgApplyOptions)

Parameters:

clear()

Since:

• 1.9

d2(visible)

Parameters:

GetAlign() → {string}

Returns:

Type

string

Example

"BR,TR" {string}, indicates that the bottom-right corner of the control coincides with the top-right corner of the drop-down panel (default)
  "BL,TL" {string}, indicates that the bottom-left corner of the control coincides with the top-left corner of the drop-down panel

GetAllowActions() → {string}

Returns:

Type

string

GetAllowDrop() → {boolean}

Returns:

Type

boolean

GetAllowResize() → {string}

Returns:

Type

string

Example

"" {string}, the drop-down portion offers no user-controllable method for resizing it (default)
  "both" {string}, the drop-down portion displays a mechanism for allowing the user to resize it, which may be resized both horizontally and vertically

GetCanvasRect() → {Array.<number>}

Returns:

Type

Array.<number>

GetClientRect() → {Array.<number>}

Returns:

Type

Array.<number>

GetCursors() → {string}

Returns:

Type

string

GetDropDown() → {boolean}

Returns:

Type

boolean

GetFormatText() → {exontrol.DrawTextFormatEnum}

Returns:

Type

exontrol.DrawTextFormatEnum

GetHost() → {string|object|HTMLElement}

Returns:

Type

string | object | HTMLElement

getHost() → {object}

Returns:

Type

object

GetLabel() → {string}

Returns:

Type

string

getLabel() → {string}

Returns:

Type

string

GetLocked() → {boolean}

Returns:

Type

boolean

GetOptions() → {object}

Returns:

Type

object

GetPad() → {number|Array.<number>|string}

Returns:

Type

number | Array.<number> | string

GetReadOnly() → {string}

Returns:

Type

string

GetShapes() → {string}

Returns:

Type

string

GetShowClearButton() → {number}

Since:

• 1.9

Returns:

Type

number

Example

0 {number}, the clear-button is hidden (default)
  -1 {number}, the clear-button is always visible
  3 {number}, the clear-button is visible only if required and the pointer hovers the control

GetTfi() → {string|object}

Returns:

Type

string | object

GetToolTipDelay() → {number}

Returns:

Type

number

GetToolTipPopDelay() → {number}

Returns:

Type

number

GetToolTipWidth() → {number}

Returns:

Type

number

GetVisibleRect() → {Array.<number>}

Returns:

Type

Array.<number>

GetWindowRect() → {Array.<number>}

Returns:

Type

Array.<number>

GetZoom() → {number}

Returns:

Type

number

GetZoomLevels() → {string}

Returns:

Type

string

grtD2(oHost, bExHostopt) → {array}

Parameters:

Returns:

Type

array

isD2V() → {boolean}

Returns:

Type

boolean

label(image, caption) → {string}

Parameters:

Returns:

Type

string

onD2R(width, height)

Parameters:

onDblClk(event) → {any}

Parameters:

Returns:

Type

any

SetAlign(value)

Parameters:

Example

"BR,TR" {string}, indicates that the bottom-right corner of the control coincides with the top-right corner of the drop-down panel (default)
  "BL,TL" {string}, indicates that the bottom-left corner of the control coincides with the top-left corner of the drop-down panel

SetAllowActions(value)

Parameters:

Example

null {null}, indicates the control's default allowActions value
 "" {string}, specifies that no operation is allowed once the user clicks or touches the control
 "scroll" {string}, specifies that only "scroll" operation is allowed, no matter of the item's button or modifier-keys is pressed.

SetAllowDrop(value)

Parameters:

Example

false {boolean}, no file can be drop into the control (default)
  true {boolean}, the user can drag and drop files into the control

SetAllowResize(value)

Parameters:

Example

"" {string}, the drop-down portion offers no user-controllable method for resizing it (default)
  "both" {string}, the drop-down portion displays a mechanism for allowing the user to resize it, which may be resized both horizontally and vertically

SetCursors(value)

Parameters:

SetDropDown(value)

Parameters:

Example

false {boolean}, the control's drop-down panel is hidden
  true {boolean}, shows programmatically the control's drop-down panel

SetFormatText(value)

Parameters:

Example

null {null}, centers the caption
  32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line caption
  0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line caption right/bottom-aligned

SetHost(value)

Parameters:

Example

"id" {string} or id {HTMLElement}, refers to any HTML element of the current document, as an identifier (string) or as an HTMLElement type, to display within the control's drop-down panel
 exobj {object}, where exobj can be any of exontrol canvas-types as listed:

   {exontrol.Bezier}, The ExBezier/JS component displays Bézier curves. The Bézier curves are also used in the time domain, particularly in animation, user interface design and smoothing cursor trajectory in eye gaze controlled interfaces (requires "exontrol.bezier.js" library)
   {exontrol.Calendar}, The ExCalendar/JS components provides calendar capabilities for your application. A calendar is a system of organizing days for social, religious, commercial or administrative purposes. This is done by giving names to periods of time, typically days, weeks, months and years. A date is the designation of a single, specific day within such a system (requires "exontrol.calendar.js" library)
   {exontrol.Gantt}, The ExGantt/JS component is our approach to create timeline charts (also known as Gantt charts). Gantt chart is a time-phased graphic display of activity durations. Activities are listed with other tabular information on the left side with time intervals over the bars. Activity durations are shown in the form of horizontal bars (requires "exontrol.menu.js", "exontrol.tree.js", "exontrol.gantt.js" libraries)
   {exontrol.Gauge}, The ExGauge/JS library provides graphics capabilities to visually display and edit the amount, level, or contents of something. The view can show one or more layers, where each layer can display one or more transparent pictures, HTML captions which can be clipped, moved, rotated or combination of them, by dragging the mouse, rolling the mouse wheel, or using the keyboard (requires "exontrol.gauge.js" library)
   {exontrol.Menu}, The ExMenu/JS component provides menu-functionaly which includes top-level menus, context, popup, drop down or shortcut menus. A menu presents a list of items, commands, attributes, or states from which a user can choose. An item within a menu is known as a menu item, and may be configured to initiate an action, toggle a state on or off, or display a submenu of additional menu items when it is selected. A context menu is a menu in a graphical user interface (GUI) that appears upon user interaction, such as a right-click mouse operation (requires "exontrol.menu.js" library)
   {exontrol.OrgChart}, The ExOrgChart/JS component permits the totally automatic generation of organigrams. An organigram generally provides a clear picture of the hierarchical position of the various actors. The control shows a hierarchical display of nodes, each one having an HTML caption, pictures and icons aligned to any side of the node. Each node can have child-nodes, assistant-nodes or group-nodes (requires "exontrol.orgchart.js" library)
   {exontrol.Pivot}, The ExPivot/JS is our approach to provide data summarization, as a pivot table. A pivot-table can automatically sort, count, total or give the average of the data stored in one table or spreadsheet (requires "exontrol.menu.js", "exontrol.tree.js", "exontrol.pivot.js" libraries)
   {exontrol.RadialMenu}, The ExRadialMenu/JS (radial or pie menu) component is similar to the Microsoft's OneNote radial menu with ability to customize the appearance and functionality. The component is designed using tree structure so an item can hold none or more children, and so any item can be browsed, and show its children around it (requires "exontrol.radialmenu.js" library)
   {exontrol.Schedule}, The ExSchedule/JS library is our approach to provide scheduling of appointments into your web application. The ExSchedule/JS is a visual HTML5 component that shows a timeline view for multiple activities (event calendar). The time is displayed on the vertical (Y) axis and the activities are automatically arranged over a single or multiple dates (requires "exontrol.menu.js", "exontrol.calendar.js", "exontrol.icalendar.js", "exontrol.schedule.js" libraries)
   {exontrol.ScrollBar}, The ExScollBar/JS components provides scroll-bar/slider/track functionality for your application. A vertical or horizontal bar commonly located on the far right or bottom of a window that allows you to move the window viewing area up, down, left, or right. A slider or track bar is a graphical control element with which a user may set a value by moving an indicator
   {exontrol.Surface}, The ExSurface/JS lets you organize your objects to a surface. You can use the tool to generate organigrams, diagrams, graphs, flowcharts and so on (requires "exontrol.surface.js" library)
   {exontrol.SwimLane}, The ExSwimlane/JS lets you draw swim lane diagrams. A swim lane (or swimlane diagram) is a visual element used in process flow diagrams, or flowcharts, that visually distinguishes job sharing and responsibilities for sub-processes of a business process. Swim lanes may be arranged either horizontally or vertically (requires "exontrol.surface.js", "exontrol.swimlane.js" libraries)
   {exontrol.Tree}, The ExTree/JS component allows you to display and edit hierarchical-data. Features include: Multiple-Columns, Multiple-Views, Drag and Drop, Group-By, Filter-Prompt, Conditional-Format, Total Fields, and much more (requires "exontrol.menu.js", "exontrol.tree.js" libraries)

SetLabel(value)

Parameters:

Example

null {null} or "" {string}, displays nothing
  "<b>item" {string}, displays "item" word in bold

SetLocked(value)

Parameters:

Example

false {boolean}, unlocks the control (the control's drop down is available)
  true {boolean}, locks the control (the control's drop down is not available)

SetOptions(nOptions, bIncludeAllopt) → {boolean}

Parameters:

Returns:

Type

boolean

Example

oComboBox.Options = {readOnly: true}, changes the alignment and the size for all images within the control.

The oComboBox.Options = value statement is equivalent with oComboBox.SetOptions(value) or oComboBox.oCV.SetOptions(value)

SetPad(value)

Parameters:

Example

null {null}, indicates that the default-padding field is used ([2,2])
  0 {number}, indicates no padding
  "8,4" {string}, increases the item's width with 2 * 8-pixels and item's height with 2 * 4-pixels
  [8,4] {array}, increases the item's width with 2 * 8-pixels and item's height with 2 * 4-pixels

SetReadOnly(value)

Parameters:

Example

false {boolean}, the control's drop down is available and the user can select new items
  true {boolean}, the control's drop down is available but the user can't select items

SetShapes(value)

Parameters:

Example

null {null}, specifies the default visual appearance
 "" {string}, no shape (no visual appearance is applied to any part of the control)
 "red(itemAlt)", "#FF0000(itemAlt)", "rgb(255,0,0)(itemAlt)", "rgba(255,0,0,1)(itemAlt)" {string}, shows alternate-items in red
 '{"hover":{"fillColor":"black","tfi":{"fgColor":"white"}}}(event)' {string}, shows the item in white on a black-background, while the cursor hovers it
 "xxx(d),yyy(d,m),zzz(y)"  {string}, specifies that the exontrol.Shapes.ComboBox.xxx combined with exontrol.Shapes.ComboBox.yyy object defines the visual appearance of "d" part of the control, exontrol.Shapes.ComboBox.yyy object defines the visual appearance of "m" part of the control and exontrol.Shapes.ComboBox.zzz object defines the visual appearance of "y" part of the control

SetShowClearButton(value)

Parameters:

Since:

• 1.9

Example

0 {number}, the clear-button is hidden (default)
 -1 {number}, the clear-button is always visible
 3 {number}, the clear-button is visible only if required and the pointer hovers the control

SetTfi(value)

Parameters:

Example

null {null}, the tfi field is ignored
  "bold monospace 16 <fg blue>" {string}, defines Monospace font of 16px height, bold and blue
  {bold: true, fontName: "monospace", fontSize: 16, fgColor: "blue"} {object}, defines Monospace font of 16px height, bold and blue

SetToolTipDelay(value)

Parameters:

Example

0 {number}, the tooltip is shown "immediately"
  128 {number}, the tooltip is displayed in 128 ms.

SetToolTipPopDelay(value)

Parameters:

Example

0 {number}, no tooltip is shown for any object (disabled)
  -1 {number}, the tooltip stays indefinitely (negative)
  1000 {number}, the tooltip is visible for 1 second

SetToolTipWidth(value)

Parameters:

Example

0 {number}, no tooltip is shown for any object (disabled)
  -1 {number}, the tooltip's content is displayed on a single line (without limit the width of it)
  300 {number}, the tooltip's max-width is 300 pixels

SetZoom(value)

Parameters:

Example

null {null}, Specifies normal-view (100%)
  150 {number}, Indicates that the control's label is magnfied to 150%

SetZoomLevels(value)

Parameters:

Example

null {null}, Specifies that the control's zoom factor is always 100%
  150 {number}, Specifies that the control's zoom factor is always 150%
  "50,100,200,350" {string}, Indicates that the zoom-factor can be any of selected values, and the levels of zoom-factor is 50% to 350%

srtD2(width, height, oHost)

Parameters:

uH()

Events

onanchorclick

Parameters:

Since:

• 2.2

Example

The following samples display information about the element being clicked:

oComboBox.Listeners.Add("onanchorclick", function (oEvent)
{
 console.log(oEvent);
})

or

oComboBox.oCV.onanchorclick = function (oEvent)
{
 console.log(oEvent);
}

where oComboBox is an object of ComboBox type, oCV is member of ComboBox type, of SV type.

onclear

Since:

• 1.9

Example

The following sample displays a message once the control's clear button is clicked:

oComboBox.Listeners.Add("onclear", function ()
{
 console.log("clear-button clicked");
})

or

oComboBox.oCV.onclear = function ()
{
 console.log("clear-button clicked");
}

where oComboBox is an object of ComboBox type. The oCV is member of ComboBox type, of CV type.

onclick

Parameters:

Example

The following samples display information about the object being clicked:

oComboBox.Listeners.Add("onclick", function (oEvent)
{
 console.log(oEvent);
})

or

oComboBox.oCV.onclick = function (oEvent)
{
 console.log(oEvent);
}

where oComboBox is an object of ComboBox type. The oCV is member of ComboBox type, of CV type.

ond2

Example

The following sample displays a message once the control's drop-down button is clicked:

oComboBox.Listeners.Add("ond2", function ()
{
 console.log("drop-down clicked");
})

or

oComboBox.oCV.ond2 = function ()
{
 console.log("drop-down clicked");
}

where oComboBox is an object of ComboBox type. The oCV is member of ComboBox type, of CV type.