X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/b37ceabb82336ee82757cd32efe353cfab8ec267..f5240829880f87e0cf581c6a296e436fdef0ef80:/docs/output/Ext.form.ComboBox.html diff --git a/docs/output/Ext.form.ComboBox.html b/docs/output/Ext.form.ComboBox.html index 54c5dd9d..074c1a0d 100644 --- a/docs/output/Ext.form.ComboBox.html +++ b/docs/output/Ext.form.ComboBox.html @@ -1,4 +1,4 @@ -
Properties Methods Events Config Options Direct Link 
Observable
  Component
    BoxComponent
      Field
        TextField
          TriggerField
            ComboBox

Class Ext.form.ComboBox

Package:Ext.form
Defined In:Combo.js
Class:ComboBox
Subclasses:TimeField
Extends:TriggerField

A combobox control with support for autocomplete, remote-loading, paging and many other features.

+
Properties Methods Events Config Options Direct Link 
Observable
  Component
    BoxComponent
      Field
        TextField
          TriggerField
            ComboBox

Class Ext.form.ComboBox

Package:Ext.form
Defined In:Combo.js
Class:ComboBox
Subclasses:TimeField
Extends:TriggerField

A combobox control with support for autocomplete, remote-loading, paging and many other features.

A ComboBox works in a similar manner to a traditional HTML <select> field. The difference is that to submit the valueField, you must specify a hiddenName to create a hidden input field to hold the value of the valueField. The displayField is shown in the text field @@ -188,17 +188,12 @@ false to allow the user to set arbitrary text i...

tr Note to express this dimension as a percentage or offset s...
The height of this component in pixels (defaults to auto). Note to express this dimension as a percentage or offset see Ext.Component.anchor.
BoxComponent hidden : Boolean
Render this component hidden (default is false). If true, the hide method will be called internally.
Component hiddenId : String
If hiddenName is specified, hiddenId can also be provided -to give the hidden field a unique id (defaults to the hidde...
If hiddenName is specified, hiddenId can also be provided -to give the hidden field a unique id (defaults to the hiddenName). The hiddenId -and combo id should be different, since no two DOM -nodes should share the same id.
ComboBox hiddenName : String
If specified, a hidden form field with this name is dynamically generated to store the +to give the hidden field a unique id. The hiddenId and com...
If hiddenName is specified, hiddenId can also be provided +to give the hidden field a unique id. The hiddenId and combo id should be +different, since no two DOM nodes should share the same id.
ComboBox hiddenName : String
If specified, a hidden form field with this name is dynamically generated to store the field's data value (defaults t...
If specified, a hidden form field with this name is dynamically generated to store the field's data value (defaults to the underlying DOM element's name). Required for the combo's value to automatically -post during a form submission. See also valueField. -

Note: the hidden field's id will also default to this name if hiddenId is not specified. -The ComboBox id and the hiddenId should be different, since -no two DOM nodes should share the same id. So, if the ComboBox name and -hiddenName are the same, you should specify a unique hiddenId.

ComboBox hiddenValue : String
Sets the initial value of the hidden field if hiddenName is +post during a form submission. See also valueField.
ComboBox hiddenValue : String
Sets the initial value of the hidden field if hiddenName is specified to contain the selected valueField, from the St...
Sets the initial value of the hidden field if hiddenName is specified to contain the selected valueField, from the Store. Defaults to the configured value.
ComboBox hideLabel : Boolean
true to completely hide the label element @@ -906,7 +901,12 @@ Or a shorthand syntax:
scope: this });
Returns:
  • void
Observable applyToMarkup( String/HTMLElement el ) : - void
Apply this component to existing markup that is valid. With this function, no call to render() is required.
Apply this component to existing markup that is valid. With this function, no call to render() is required.
Parameters:
  • el : String/HTMLElement
Returns:
  • void
Component clearInvalid() + void
Apply this component to existing markup that is valid. With this function, no call to render() is required.
Apply this component to existing markup that is valid. With this function, no call to render() is required.
Parameters:
  • el : String/HTMLElement
Returns:
  • void
Component bubble( Function fn, [Object scope], [Array args] ) + : + Ext.Component
Bubbles up the component/container heirarchy, calling the specified function with each component. The scope (this) of...
Bubbles up the component/container heirarchy, calling the specified function with each component. The scope (this) of +function call will be the scope provided or the current component. The arguments to the function +will be the args provided or the current component. If the function returns false at any point, +the bubble is stopped.
Parameters:
  • fn : Function
    The function to call
  • scope : Object
    (optional) The scope of the function (defaults to current node)
  • args : Array
    (optional) The args to call the function with (default to passing the current component)
Returns:
  • Ext.Component
    this
Component clearInvalid() : void
Clear any invalid styles/messages for this field
Clear any invalid styles/messages for this field
Parameters:
  • None.
Returns:
  • void
Field clearValue() : @@ -971,9 +971,11 @@ access the required target more quickly.

: Ext.Container
Find a container above this component at any level by a custom function. If the passed function returns true, the con...
Find a container above this component at any level by a custom function. If the passed function returns -true, the container will be returned.
Parameters:
  • fn : Function
    The custom function to call with the arguments (container, this component).
Returns:
  • Ext.Container
    The first Container for which the custom function returns true
Component findParentByType( String/Class xtype ) +true, the container will be returned.
Parameters:Returns:
Component findParentByType( String/Ext.Component/Class xtype, [Boolean shallow] ) : - Ext.Container
Find a container above this component at any level by xtype or class
Find a container above this component at any level by xtype or class
Parameters:
  • xtype : String/Class
    The xtype string for a component, or the class of the component directly
Returns:
  • Ext.Container
    The first Container which matches the given xtype or class
Component fireEvent( String eventName, Object... args ) + Ext.Container
Find a container above this component at any level by xtype or class
Find a container above this component at any level by xtype or class
Parameters:
  • xtype : String/Ext.Component/Class
    The xtype to check for this Component. Note that the the component can either be an instance +or a component class:
  • shallow : Boolean
    (optional) False to check whether this Component is descended from the xtype (this is +the default), or true to check whether this Component is directly of the specified xtype.
Returns:
  • Ext.Container
    The first Container which matches the given xtype or class
Component fireEvent( String eventName, Object... args ) : Boolean
Fires the specified event with the passed parameters (minus the event name). An event may be set to bubble up an Obse...

Fires the specified event with the passed parameters (minus the event name).

@@ -1178,7 +1180,7 @@ of the field. Note: disab...
Returns whether or not the f validating the processed value of the field. Note: disabled fields are ignored.
Parameters:
  • preventMark : Boolean
    True to disable marking the field invalid
Returns:
  • Boolean
    True if the value is valid, else false
Field isVisible() : - Boolean
Returns true if this component is visible.
Returns true if this component is visible.
Parameters:
  • None.
Returns:
  • Boolean
    True if this component is visible, false otherwise.
Component isXType( String xtype, [Boolean shallow] ) + Boolean
Returns true if this component is visible.
Returns true if this component is visible.
Parameters:
  • None.
Returns:
  • Boolean
    True if this component is visible, false otherwise.
Component isXType( String/Ext.Component/Class xtype, [Boolean shallow] ) : Boolean
Tests whether or not this Component is of a specific xtype. This can test whether this Component is descended from th...

Tests whether or not this Component is of a specific xtype. This can test whether this Component is descended @@ -1190,7 +1192,11 @@ to participate in determination of inherited xtypes.

var t = new Ext.form.TextField();
 var isText = t.isXType('textfield');        // true
 var isBoxSubclass = t.isXType('box');       // true, descended from BoxComponent
-var isBoxInstance = t.isXType('box', true); // false, not a direct BoxComponent instance
Parameters:
  • xtype : String
    The xtype to check for this Component
  • shallow : Boolean
    (optional) False to check whether this Component is descended from the xtype (this is +var isBoxInstance = t.isXType('box', true); // false, not a direct BoxComponent instance
    Parameters:
    • xtype : String/Ext.Component/Class
      The xtype to check for this Component. Note that the the component can either be an instance +or a component class: +
      var c = new Ext.Component();
+console.log(c.isXType(c));
+console.log(c.isXType(Ext.Component));
    • shallow : Boolean
      (optional) False to check whether this Component is descended from the xtype (this is the default), or true to check whether this Component is directly of the specified xtype.
    Returns:
    • Boolean
      True if this component descends from the specified xtype, false otherwise.
Component markInvalid( [String msg] ) : void
Display an error message associated with this field, using msgTarget to determine how to @@ -1296,17 +1302,19 @@ use markInvalid instead, which calls this method internally
Convenience function for setting disabled/enabled by boolean.
Convenience function for setting disabled/enabled by boolean.
Parameters:
  • disabled : Boolean
Returns:
  • Ext.Component
    this
Component setEditable( Boolean value ) : - void
Parameters:
  • value : Boolean
    True to allow the user to directly edit the field text -Allow or prevent the user from directly editing the field text. If false is passed, + void
    Allow or prevent the user from directly editing the field text. If false is passed, +the user will only be able to mo...
    Allow or prevent the user from directly editing the field text. If false is passed, the user will only be able to modify the field using the trigger. Will also add a click event to the text field which will call the trigger. This method -is the runtime equivalent of setting the 'editable' config option at config time.
Returns:
  • void
TriggerField setHeight( Mixed height ) +is the runtime equivalent of setting the editable config option at config time.
Parameters:
  • value : Boolean
    True to allow the user to directly edit the field text.
Returns:
  • void
TriggerField setHeight( Mixed height ) : Ext.BoxComponent
Sets the height of the component. This method fires the resize event.
Sets the height of the component. This method fires the resize event.
Parameters:
  • height : Mixed
    The new height to set. This may be one of:
    • A Number specifying the new height in the Element's defaultUnits (by default, pixels).
    • A String used to set the CSS height style.
    • undefined to leave the height unchanged.
      • -
Returns:
  • Ext.BoxComponent
    this
BoxComponent setPagePosition( Number x, Number y ) +
Returns:BoxComponent setHideTrigger( Boolean hideTrigger ) + : + void
Changes the hidden status of the trigger.
Changes the hidden status of the trigger.
Parameters:
  • hideTrigger : Boolean
    True to hide the trigger, false to show it.
Returns:
  • void
TriggerField setPagePosition( Number x, Number y ) : Ext.BoxComponent
Sets the page XY position of the component. To set the left and top instead, use setPosition. This method fires the ...
Sets the page XY position of the component. To set the left and top instead, use setPosition. @@ -1318,11 +1326,11 @@ This method fires the
Sets the underlying DOM field's value directly, bypassing validation. To set the value with validation see setValue.
Sets the underlying DOM field's value directly, bypassing validation. To set the value with validation see setValue.
Parameters:
  • value : Mixed
    The value to set
Returns:
  • Mixed
    value The field value that is set
Field setReadOnly( Boolean value ) : - void
Parameters:
  • value : Boolean
    True to prevent the user changing the field and explicitly -hide the trigger. -Setting this to true will superceed settings editable and hideTrigger. -Setting this to false will defer back to editable and hideTrigger. This method -is the runtime equivalent of setting the 'readOnly' config option at config time.
Returns:
  • void
TriggerField setSize( Mixed width, Mixed height ) + void
Setting this to true will supersede settings editable and hideTrigger. +Setting this to false will defer back to edita...
Setting this to true will supersede settings editable and hideTrigger. +Setting this to false will defer back to editable and hideTrigger. This method +is the runtime equivalent of setting the readOnly config option at config time.
Parameters:
  • value : Boolean
    True to prevent the user changing the field and explicitly +hide the trigger.
Returns:
  • void
TriggerField setSize( Mixed width, Mixed height ) : Ext.BoxComponent
Sets the width and height of this BoxComponent. This method fires the resize event. This method can accept either wid...
Sets the width and height of this BoxComponent. This method fires the resize event. This method can accept