dojox/grid/DataGrid (version 1.8)

dojox/grid/_Grid

Usage:

var foo = new DataGrid(params, srcNodeRef);
Defined by dijit/_Widget

Create the widget.

ParameterTypeDescription
paramsObject | null

Hash of initialization parameters for widget, including scalar values (like title, duration etc.) and functions, typically callbacks like onClick. The hash can contain any of the widget's properties, excluding read-only properties.

srcNodeRefDOMNode | String
Optional.

If a srcNodeRef (DOM node) is specified:

  • use srcNodeRef.innerHTML as my contents
  • if this is a behavioral widget then apply behavior to that srcNodeRef
  • otherwise, replace srcNodeRef with my generated DOM tree

Property Summary

  • _attachEvents List of connections associated with data-dojo-attach-event=... in the template
  • _attachPoints List of widget attribute names associated with data-dojo-attach-point=... in the template, ex: ["containerNode", "labelNode"]
  • _attrPairNames
  • _blankGif Path to a blank 1x1 image.
  • _bop
  • _by_idty
  • _by_idx
  • _cache
  • _click
  • _earlyTemplatedStartup A fallback to preserve the 1.0 - 1.3 behavior of children in templates having their startup called before the parent widget fires postCreate.
  • _eop
  • _focusManager
  • _isLoaded
  • _isLoading
  • _pages
  • _pending_requests
  • _placeholders
  • _requests
  • _setClassAttr
  • _setDirAttr
  • _setIdAttr
  • _setLangAttr
  • _setSummaryAttr
  • _skipNodeCache
  • _started startup() has completed.
  • _store_connects
  • attributeMap Deprecated.
  • autoHeight If autoHeight is true, grid height is automatically set to fit the data.
  • autoRender If autoRender is true, grid will render itself after initialization.
  • autoWidth If autoWidth is true, grid width is automatically set to fit the data.
  • baseClass Root CSS class of the widget (ex: dijitTextBox), used to construct CSS classes to indicate widget state.
  • cellOverClass css class to apply to grid cells over which the cursor is placed.
  • class
  • classTag CSS class applied to the grid's domNode
  • columnReordering If set to true, will add drag and drop reordering to views with one row of columns.
  • containerNode Designates where children of the source DOM node will be placed. "Children" in this case refers to both DOM nodes and widgets.
  • defaultHeight default height of the grid, measured in any valid css unit.
  • delayScroll
  • dir Bi-directional support, as defined by the HTML DIR attribute.
  • domNode This is our visible representation of the widget!
  • editable indicates if the grid contains editable cells, default is false set to true if editable cell encountered during rendering
  • elasticView Override defaults and make the indexed grid view elastic, thus filling available horizontal space.
  • errorMessage Message that shows when the grid encounters an error loading
  • escapeHTMLInData This will escape HTML brackets from the data to prevent HTML from user-inputted data being rendered with may contain JavaScript and result in XSS attacks.
  • fastScroll flag modifies vertical scrolling behavior.
  • fetchText
  • focused This widget or a widget it contains has focus, or is "active" because it was recently clicked.
  • formatterScope An object to execute format functions within.
  • headerMenu If set to a dijit.Menu, will use this as a context menu for the grid headers.
  • height explicit height of the grid, measured in any valid css unit.
  • id A unique, opaque ID string that can be assigned by users or by the system.
  • initialWidth A css string to use to set our initial width (only used if autoWidth is true).
  • invalidated
  • items
  • keepRows Number of rows to keep in the rendering cache.
  • keepSelection Whether keep selection after sort, filter etc.
  • lang Rarely used.
  • loadingMessage Message that shows while the grid is loading
  • noDataMessage Message that shows if the grid has no data - wrap it in a span with class 'dojoxGridNoData' if you want it to be styled similar to the loading and error messages
  • ownerDocument The document this widget belongs to.
  • placeholderLabel Label of placeholders to search for in the header menu to replace with column toggling menu items.
  • query
  • queryOptions
  • rowCount
  • rowHeight If rowHeight is set to a positive number, it will define the height of the rows in pixels.
  • rowSelector If set to true, will add a row selector view to this grid.
  • rowsPerPage Number of rows to render at a time.
  • scrollRedrawThreshold pixel distance a user must scroll vertically to trigger grid scrolling.
  • selectable Set to true if you want to be able to select the text within the grid.
  • selectionMode Set the selection mode of grid's Selection.
  • singleClickEdit Single-click starts editing.
  • sortFields
  • sortInfo
  • srcNodeRef pointer to original DOM node
  • store
  • structure View layout definition.
  • style HTML style attributes as cssText string or name/value hash
  • summary Customizable summary descriptions which will be added to grid.domNode
  • templatePath Path to template (HTML file) for this widget relative to dojo.baseUrl.
  • templateString
  • textDir Bi-directional support, the main variable which is responsible for the direction of the text.
  • title HTML title attribute.
  • tooltip When this widget's title attribute is used to for a tab label, accordion pane title, etc., this specifies the tooltip to appear when the mouse is hovered over that text.
  • updateDelay Time, in milliseconds, to delay updates automatically so that multiple calls to onSet/onNew/onDelete don't keep rerendering the grid.
  • updating

Method Summary

Event Summary

  • _onBlur() This is where widgets do processing for when they stop being active, such as changing CSS classes.
  • _onDelete(item)
  • _onFetchBegin(size, req)
  • _onFetchComplete(items, req)
  • _onFetchError(err, req)
  • _onFocus() This is where widgets do processing for when they are active, such as changing CSS classes.
  • _onMap(type) Maps on() type parameter (ex: "mousemove") to method name (ex: "onMouseMove").
  • _onNew(item, parentInfo)
  • _onRevert()
  • _onSet(item, attribute, oldValue, newValue)
  • _onShow() Internal method called when this widget is made visible.
  • onApplyCellEdit(inValue, inRowIndex, inFieldIndex) Event fired when editing is applied for a given grid cell
  • onApplyEdit(inRowIndex) Event fired when editing is applied for a given grid row
  • onBlur() Called when the widget stops being "active" because focus moved to something outside of it, or the user clicked somewhere outside of it, or the widget was hidden.
  • onCancelEdit(inRowIndex) Event fired when editing is cancelled for a given grid cell
  • onCanDeselect(inRowIndex) Event to determine if a grid row may be deselected
  • onCanSelect(inRowIndex) Event to determine if a grid row may be selected
  • onCellClick(e) Event fired when a cell is clicked.
  • onCellContextMenu(e) Event fired when a cell context menu is accessed via mouse right click.
  • onCellDblClick(e) Event fired when a cell is double-clicked.
  • onCellFocus(inCell, inRowIndex) Event fired when a cell receives focus.
  • onCellMouseDown(e) Event fired when mouse is down in a header cell.
  • onCellMouseOut(e) Event fired when mouse moves out of a cell.
  • onCellMouseOver(e) Event fired when mouse is over a cell.
  • onClick(event) Connect to this function to receive notifications of mouse click events.
  • onClose() Called when this widget is being displayed as a popup (ex: a Calendar popped up from a DateTextBox), and it is hidden.
  • onContentEvent(e) Top level handler for Content events
  • onDblClick(event) Connect to this function to receive notifications of mouse double click events.
  • onDeselected(inRowIndex) Event fired when a grid row is deselected
  • onFetchError(err, req)
  • onFocus() Called when the widget becomes "active" because it or a widget inside of it either has focus, or has recently been clicked.
  • onHeaderCellClick(e) Event fired when a header cell is clicked.
  • onHeaderCellContextMenu(e) Event fired when a header cell context menu is accessed via mouse right click.
  • onHeaderCellDblClick(e) Event fired when a header cell is double clicked.
  • onHeaderCellMouseDown(e) Event fired when mouse is down in a header cell.
  • onHeaderCellMouseOut(e) Event fired when mouse moves out of a header cell.
  • onHeaderCellMouseOver(e) Event fired when mouse moves over a header cell.
  • onHeaderClick(e) Event fired when the grid header is clicked.
  • onHeaderContextMenu(e) Event fired when the grid header context menu is accessed via mouse right click.
  • onHeaderDblClick(e) Event fired when the grid header is double clicked.
  • onHeaderEvent(e) Top level handler for header events
  • onHeaderMouseOut(e) Event fired when mouse moves out of the grid header.
  • onHeaderMouseOver(e) Event fired when mouse moves over the grid header.
  • onHide() Called when another widget becomes the selected pane in a dijit/layout/TabContainer, dijit/layout/StackContainer, dijit/layout/AccordionContainer, etc.
  • onKeyDown(event) Connect to this function to receive notifications of keys being pressed down.
  • onKeyEvent(e) top level handler for Key Events
  • onKeyPress(event) Connect to this function to receive notifications of printable keys being typed.
  • onKeyUp(event) Connect to this function to receive notifications of keys being released.
  • onMouseDown(event) Connect to this function to receive notifications of when the mouse button is pressed down.
  • onMouseDownRow(e) Event fired when mouse is down inside grid row
  • onMouseEnter(event) Connect to this function to receive notifications of when the mouse moves onto this widget.
  • onMouseLeave(event) Connect to this function to receive notifications of when the mouse moves off of this widget.
  • onMouseMove(event) Connect to this function to receive notifications of when the mouse moves over nodes contained within this widget.
  • onMouseOut(event) Connect to this function to receive notifications of when the mouse moves off of nodes contained within this widget.
  • onMouseOutRow(e) Event fired when mouse moves out of any row (data or header).
  • onMouseOver(event) Connect to this function to receive notifications of when the mouse moves onto nodes contained within this widget.
  • onMouseOverRow(e) Event fired when mouse is over any row (data or header).
  • onMouseUp(event) Connect to this function to receive notifications of when the mouse button is released.
  • onMoveColumn()
  • onResizeColumn(cellIdx)
  • onRowClick(e) Event fired when a row is clicked.
  • onRowContextMenu(e) Event fired when a row context menu is accessed via mouse right click.
  • onRowDblClick(e) Event fired when a row is double clicked.
  • onRowMouseDown(e) Event fired when mouse is down in a row.
  • onRowMouseOut(e) Event fired when mouse moves out of a data row.
  • onRowMouseOver(e) Event fired when mouse moves over a data row.
  • onSelected(inRowIndex) Event fired when a grid row is selected
  • onSelectionChanged()
  • onShow() Called when this widget becomes the selected pane in a dijit/layout/TabContainer, dijit/layout/StackContainer, dijit/layout/AccordionContainer, etc.
  • onStartEdit(inCell, inRowIndex) Event fired when editing is started for a given grid cell
  • onStyleRow(inRow)

Properties

_attachEvents

List of connections associated with data-dojo-attach-event=... in the template

_attachPoints

List of widget attribute names associated with data-dojo-attach-point=... in the template, ex: ["containerNode", "labelNode"]

_attrPairNames
_blankGif

Path to a blank 1x1 image. Used by <img> nodes in templates that really get their image via CSS background-image.

_bop
_by_idty
_by_idx
_cache
_click
Defined by dojox/grid/_Grid
_earlyTemplatedStartup

A fallback to preserve the 1.0 - 1.3 behavior of children in templates having their startup called before the parent widget fires postCreate. Defaults to 'false', causing child widgets to have their .startup() called immediately before a parent widget .startup(), but always after the parent .postCreate(). Set to 'true' to re-enable to previous, arguably broken, behavior.

_eop
_focusManager
_isLoaded
_isLoading
_pages
_pending_requests
_placeholders
Defined by dojox/grid/_Grid
_requests
_setClassAttr
_setDirAttr
_setIdAttr
_setLangAttr
_setSummaryAttr
Defined by dojox/grid/_Grid
_skipNodeCache
_started

startup() has completed.

_store_connects
attributeMap

Deprecated. Instead of attributeMap, widget should have a _setXXXAttr attribute for each XXX attribute to be mapped to the DOM.

attributeMap sets up a "binding" between attributes (aka properties) of the widget and the widget's DOM. Changes to widget attributes listed in attributeMap will be reflected into the DOM.

For example, calling set('title', 'hello') on a TitlePane will automatically cause the TitlePane's DOM to update with the new title.

attributeMap is a hash where the key is an attribute of the widget, and the value reflects a binding to a:

  • DOM node attribute

    focus: {node: "focusNode", type: "attribute"} Maps this.focus to this.focusNode.focus

  • DOM node innerHTML

    title: { node: "titleNode", type: "innerHTML" } Maps this.title to this.titleNode.innerHTML

  • DOM node innerText

    title: { node: "titleNode", type: "innerText" } Maps this.title to this.titleNode.innerText

  • DOM node CSS class

    myClass: { node: "domNode", type: "class" } Maps this.myClass to this.domNode.className

If the value is an array, then each element in the array matches one of the formats of the above list.

There are also some shorthands for backwards compatibility:

  • string --> { node: string, type: "attribute" }, for example:
"focusNode" ---> { node: "focusNode", type: "attribute" }
  • "" --> { node: "domNode", type: "attribute" }
autoHeight
Defined by dojox/grid/_Grid

If autoHeight is true, grid height is automatically set to fit the data. If it is an integer, the height will be automatically set to fit the data if there are fewer than that many rows - and the height will be set to show that many rows if there are more

autoRender
Defined by dojox/grid/_Grid

If autoRender is true, grid will render itself after initialization.

autoWidth
Defined by dojox/grid/_Grid

If autoWidth is true, grid width is automatically set to fit the data.

baseClass

Root CSS class of the widget (ex: dijitTextBox), used to construct CSS classes to indicate widget state.

cellOverClass

css class to apply to grid cells over which the cursor is placed.

class
classTag
Defined by dojox/grid/_Grid

CSS class applied to the grid's domNode

columnReordering
Defined by dojox/grid/_Grid

If set to true, will add drag and drop reordering to views with one row of columns.

containerNode

Designates where children of the source DOM node will be placed. "Children" in this case refers to both DOM nodes and widgets. For example, for myWidget:

<div data-dojo-type=myWidget>
    <b> here's a plain DOM node
    <span data-dojo-type=subWidget>and a widget</span>
    <i> and another plain DOM node </i>
</div>

containerNode would point to:

<b> here's a plain DOM node
<span data-dojo-type=subWidget>and a widget</span>
<i> and another plain DOM node </i>

In templated widgets, "containerNode" is set via a data-dojo-attach-point assignment.

containerNode must be defined for any widget that accepts innerHTML (like ContentPane or BorderContainer or even Button), and conversely is null for widgets that don't, like TextBox.

defaultHeight
Defined by dojox/grid/_Grid

default height of the grid, measured in any valid css unit.

delayScroll
Defined by dojox/grid/_Grid
dir

Bi-directional support, as defined by the HTML DIR attribute. Either left-to-right "ltr" or right-to-left "rtl". If undefined, widgets renders in page's default direction.

domNode

This is our visible representation of the widget! Other DOM Nodes may by assigned to other properties, usually through the template system's data-dojo-attach-point syntax, but the domNode property is the canonical "top level" node in widget UI.

editable
Defined by dojox/grid/_Grid

indicates if the grid contains editable cells, default is false set to true if editable cell encountered during rendering

elasticView
Defined by dojox/grid/_Grid

Override defaults and make the indexed grid view elastic, thus filling available horizontal space.

errorMessage
Defined by dojox/grid/_Grid

Message that shows when the grid encounters an error loading

escapeHTMLInData
Defined by dojox/grid/_Grid

This will escape HTML brackets from the data to prevent HTML from user-inputted data being rendered with may contain JavaScript and result in XSS attacks. This is true by default, and it is recommended that it remain true. Setting this to false will allow data to be displayed in the grid without filtering, and should be only used if it is known that the data won't contain malicious scripts. If HTML is needed in grid cells, it is recommended that you use the formatter function to generate the HTML (the output of formatter functions is not filtered, even with escapeHTMLInData set to true).

fastScroll
Defined by dojox/grid/_Grid

flag modifies vertical scrolling behavior. Defaults to true but set to false for slower scroll performance but more immediate scrolling feedback

fetchText
focused

This widget or a widget it contains has focus, or is "active" because it was recently clicked.

formatterScope
Defined by dojox/grid/_Grid

An object to execute format functions within. If not set, the format functions will execute within the scope of the cell that has a format function.

headerMenu
Defined by dojox/grid/_Grid

If set to a dijit.Menu, will use this as a context menu for the grid headers.

height
Defined by dojox/grid/_Grid

explicit height of the grid, measured in any valid css unit. This will be populated (and overridden) if the height: css attribute exists on the source node.

id

A unique, opaque ID string that can be assigned by users or by the system. If the developer passes an ID which is known not to be unique, the specified ID is ignored and the system-generated ID is used instead.

initialWidth
Defined by dojox/grid/_Grid

A css string to use to set our initial width (only used if autoWidth is true). The first rendering of the grid will be this width, any resizing of columns, etc will result in the grid switching to autoWidth mode. Note, this width will override any styling in a stylesheet or directly on the node.

invalidated
Defined by dojox/grid/_Grid
items
keepRows
Defined by dojox/grid/_Grid

Number of rows to keep in the rendering cache.

keepSelection

Whether keep selection after sort, filter etc.

lang

Rarely used. Overrides the default Dojo locale used to render this widget, as defined by the HTML LANG attribute. Value must be among the list of locales specified during by the Dojo bootstrap, formatted according to RFC 3066 (like en-us).

loadingMessage
Defined by dojox/grid/_Grid

Message that shows while the grid is loading

noDataMessage
Defined by dojox/grid/_Grid

Message that shows if the grid has no data - wrap it in a span with class 'dojoxGridNoData' if you want it to be styled similar to the loading and error messages

ownerDocument

The document this widget belongs to. If not specified to constructor, will default to srcNodeRef.ownerDocument, or if no sourceRef specified, then to dojo/_base/window::doc

placeholderLabel
Defined by dojox/grid/_Grid

Label of placeholders to search for in the header menu to replace with column toggling menu items.

query
queryOptions
rowCount
rowHeight
Defined by dojox/grid/_Grid

If rowHeight is set to a positive number, it will define the height of the rows in pixels. This can provide a significant performance advantage, since it eliminates the need to measure row sizes during rendering, which is one the primary bottlenecks in the DataGrid's performance.

rowSelector
Defined by dojox/grid/_Grid

If set to true, will add a row selector view to this grid. If set to a CSS width, will add a row selector of that width to this grid.

rowsPerPage
Defined by dojox/grid/_Grid

Number of rows to render at a time.

scrollRedrawThreshold
Defined by dojox/grid/_Grid

pixel distance a user must scroll vertically to trigger grid scrolling.

selectable
Defined by dojox/grid/_Grid

Set to true if you want to be able to select the text within the grid.

selectionMode
Defined by dojox/grid/_Grid

Set the selection mode of grid's Selection. Value must be 'single', 'multiple', or 'extended'. Default is 'extended'.

singleClickEdit
Defined by dojox/grid/_Grid

Single-click starts editing. Default is double-click

sortFields
sortInfo
Defined by dojox/grid/_Grid
srcNodeRef

pointer to original DOM node

store
structure

View layout definition.

style

HTML style attributes as cssText string or name/value hash

summary
Defined by dojox/grid/_Grid

Customizable summary descriptions which will be added to grid.domNode

templatePath

Path to template (HTML file) for this widget relative to dojo.baseUrl. Deprecated: use templateString with require([... "dojo/text!..."], ...) instead

templateString
Defined by dojox/grid/_Grid
textDir

Bi-directional support, the main variable which is responsible for the direction of the text. The text direction can be different than the GUI direction by using this parameter in creation of a widget.

Allowed values:

  1. "ltr"
  2. "rtl"
  3. "auto" - contextual the direction of a text defined by first strong letter.

By default is as the page direction.

title

HTML title attribute.

For form widgets this specifies a tooltip to display when hovering over the widget (just like the native HTML title attribute).

For TitlePane or for when this widget is a child of a TabContainer, AccordionContainer, etc., it's used to specify the tab label, accordion pane title, etc.

tooltip

When this widget's title attribute is used to for a tab label, accordion pane title, etc., this specifies the tooltip to appear when the mouse is hovered over that text.

updateDelay

Time, in milliseconds, to delay updates automatically so that multiple calls to onSet/onNew/onDelete don't keep rerendering the grid. Set to 0 to immediately cause updates. A higher value will result in better performance at the expense of responsiveness of the grid.

updating
Defined by dojox/grid/_Grid

Methods

_addItem(item, index, noUpdate)
ParameterTypeDescription
itemundefined
indexundefined
noUpdateundefined
_applyAttributes()

Step during widget creation to copy widget attributes to the DOM according to attributeMap and _setXXXAttr objects, and also to call custom _setXXXAttr() methods.

Skips over blank/false attribute values, unless they were explicitly specified as parameters to the widget, since those are the default anyway, and setting tabIndex="" is different than not setting tabIndex at all.

For backwards-compatibility reasons attributeMap overrides _setXXXAttr when _setXXXAttr is a hash/string/array, but _setXXXAttr as a functions override attributeMap.

_attachTemplateNodes(rootNode, getAttrFunc)

Iterate through the template and attach functions and nodes accordingly. Alternately, if rootNode is an array of widgets, then will process data-dojo-attach-point etc. for those widgets.

Map widget properties and functions to the handlers specified in the dom node and it's descendants. This function iterates over all nodes and looks for these properties:

  • dojoAttachPoint/data-dojo-attach-point
  • dojoAttachEvent/data-dojo-attach-event
ParameterTypeDescription
rootNodeDomNode | Widget[]

the node to search for properties. All children will be searched.

getAttrFuncFunction

a function which will be used to obtain property for a given DomNode/Widget

_attrToDom(attr, value, commands)

Reflect a widget attribute (title, tabIndex, duration etc.) to the widget DOM, as specified by commands parameter. If commands isn't specified then it's looked up from attributeMap. Note some attributes like "type" cannot be processed this way as they are not mutable.

ParameterTypeDescription
attrString

Name of member variable (ex: "focusNode" maps to this.focusNode) pointing to DOMNode inside the widget, or alternately pointing to a subwidget

valueString
commandsObject
Optional.
_beforeFillContent()
_changeAttrValue(name, value)
Defined by dojo/Stateful

Internal helper for directly changing an attribute value.

Directly change the value of an attribute on an object, bypassing any accessor setter. Also handles the calling of watch and emitting events. It is designed to be used by descendent class when there are two values of attributes that are linked, but calling .set() is not appropriate.

ParameterTypeDescription
nameString

The property to set.

valueMixed

The value to set in the property.

Returns: function

Internal helper for directly changing an attribute value.

_checkUpdateStatus()
_clearData()
_copyAttr(idx, attr)
ParameterTypeDescription
idxundefined
attrundefined
Returns: undefined
_createItem(item, index)
ParameterTypeDescription
itemundefined
indexundefined
Returns: object
_dispatch(m, e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
mundefined
eundefined
Returns: undefined | boolean
_fetch(start, isRender)
ParameterTypeDescription
startundefined
isRenderundefined
_fillContent(source)

Relocate source contents to templated container node. this.containerNode must be able to receive children, or exceptions will be thrown.

ParameterTypeDescription
sourceDomNode
_get(name, names)
Defined by dojo/Stateful

Private function that does a get based off a hash of names

ParameterTypeDescription
nameundefined
namesundefined

Hash of names of custom attributes

Returns: undefined
_getAttrNames(name)

Helper function for get() and set(). Caches attribute name values so we don't do the string ops every time.

ParameterTypeDescription
nameundefined
Returns: undefined | object
_getHeaderHeight()
Defined by dojox/grid/_Grid
Returns: undefined
_getItemAttr(idx, attr)
ParameterTypeDescription
idxundefined
attrundefined
Returns: undefined
_getItemIndex(item, isDeleted)
ParameterTypeDescription
itemundefined
isDeletedundefined
Returns: number
_getPadBorder()
Defined by dojox/grid/_Grid
Returns: undefined
_getRowCountAttr()
Defined by dojox/grid/_Grid
Returns: undefined
_layoutClass()
Defined by dojox/grid/_Grid

The class to use for our layout - can be overridden by grid subclasses

_mouseOut(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
_needPage(inPageIndex)
ParameterTypeDescription
inPageIndexundefined
_pageToRow(inPageIndex)
ParameterTypeDescription
inPageIndexundefined
Returns: undefined
_preparePage(inRowIndex)
ParameterTypeDescription
inRowIndexundefined
_refresh(isRender)
ParameterTypeDescription
isRenderundefined
_render()
_requestPage(inPageIndex)
ParameterTypeDescription
inPageIndexundefined
_requestsPending(inRowIndex)
ParameterTypeDescription
inRowIndexundefined
Returns: undefined
_resize(changeSize, resultSize)
Defined by dojox/grid/_Grid
ParameterTypeDescription
changeSizeundefined
resultSizeundefined
_rowToPage(inRowIndex)
ParameterTypeDescription
inRowIndexundefined
Returns: undefined
_set(name, value)

Helper function to set new value for specified attribute, and call handlers registered with watch() if the value has changed.

ParameterTypeDescription
nameString
valueanything
_setAutoHeightAttr(ah, skipRender)
Defined by dojox/grid/_Grid
ParameterTypeDescription
ahundefined
skipRenderundefined
_setFocusedAttr(val)
Defined by dijit/_Widget
ParameterTypeDescription
valundefined
_setHeaderMenuAttr(menu)
Defined by dojox/grid/_Grid
ParameterTypeDescription
menuundefined
_setOwnerDocumentAttr(val)
ParameterTypeDescription
valundefined
_setQuery(query, queryOptions)
ParameterTypeDescription
queryundefined
queryOptionsundefined
_setStore(store)
ParameterTypeDescription
storeundefined
_setStructureAttr(structure)
Defined by dojox/grid/_Grid
ParameterTypeDescription
structureundefined
_setStyleAttr(value)

Sets the style attribute of the widget according to value, which is either a hash like {height: "5px", width: "3px"} or a plain string

Determines which node to set the style on based on style setting in attributeMap.

ParameterTypeDescription
valueString | Object
_stringRepl(tmpl)

Does substitution of ${foo} type properties in template string

ParameterTypeDescription
tmplundefined
Returns: undefined
_structureChanged()
Defined by dojox/grid/_Grid
adaptHeight(inHeaderHeight)
Defined by dojox/grid/_Grid

measures and normalizes header height, then sets view heights, and then updates scroller content extent

ParameterTypeDescription
inHeaderHeightundefined
adaptWidth()
Defined by dojox/grid/_Grid

sets width and position for views and update grid width if necessary

addRow()
Defined by dojox/grid/_Grid

Add a row to the grid.

applyTextDir(element, text)

The function overridden in the _BidiSupport module, originally used for setting element.dir according to this.textDir. In this case does nothing.

ParameterTypeDescription
elementDOMNode
textString
attr(name, value)
Defined by dijit/_Widget

Set or get properties on a widget instance.

This method is deprecated, use get() or set() directly.

ParameterTypeDescription
nameString | Object

The property to get or set. If an object is passed here and not a string, its keys are used as names of attributes to be set and the value of the object as values to set in the widget.

valueObject
Optional.

Optional. If provided, attr() operates as a setter. If omitted, the current value of the named property is returned.

Returns: undefined
beginUpdate()
Defined by dojox/grid/_Grid

Use to make multiple changes to rows while queueing row updating.

buildRendering()
Defined by dojox/grid/_Grid
buildViews()
Defined by dojox/grid/_Grid
canEdit(inCell, inRowIndex)
ParameterTypeDescription
inCellundefined
inRowIndexundefined
Returns: undefined
canSort()
Returns: boolean
cell_markupFactory(cellFunc, node, cellDef)
ParameterTypeDescription
cellFuncundefined
nodeundefined
cellDefundefined
connect(obj, event, method)

Deprecated, will be removed in 2.0, use this.own(on(...)) or this.own(aspect.after(...)) instead.

Connects specified obj/event to specified method of this object and registers for disconnect() on widget destroy.

Provide widget-specific analog to dojo.connect, except with the implicit use of this widget as the target object. Events connected with this.connect are disconnected upon destruction.

ParameterTypeDescription
objObject | null
eventString | Function
methodString | Function
Returns: any | undefined

A handle that can be passed to disconnect in order to disconnect before the widget is destroyed.

Example
var btn = new Button();
// when foo.bar() is called, call the listener we're going to
// provide in the scope of btn
btn.connect(foo, "bar", function(){
    console.debug(this.toString());
});
create(params, srcNodeRef)

Kick off the life-cycle of a widget

Create calls a number of widget methods (postMixInProperties, buildRendering, postCreate, etc.), some of which of you'll want to override. See http://dojotoolkit.org/reference-guide/dijit/_WidgetBase.html for a discussion of the widget creation lifecycle.

Of course, adventurous developers could override create entirely, but this should only be done as a last resort.

ParameterTypeDescription
paramsObject | null

Hash of initialization parameters for widget, including scalar values (like title, duration etc.) and functions, typically callbacks like onClick. The hash can contain any of the widget's properties, excluding read-only properties.

srcNodeRefDOMNode | String
Optional.

If a srcNodeRef (DOM node) is specified:

  • use srcNodeRef.innerHTML as my contents
  • if this is a behavioral widget then apply behavior to that srcNodeRef
  • otherwise, replace srcNodeRef with my generated DOM tree
createLayout()
Defined by dojox/grid/_Grid

Creates a new Grid layout

createManagers()
Defined by dojox/grid/_Grid

create grid managers for various tasks including rows, focus, selection, editing

createScroller()
Defined by dojox/grid/_Grid

Creates a new virtual scroller

createSelection()
createView(inClass, idx)
Defined by dojox/grid/_Grid
ParameterTypeDescription
inClassundefined
idxundefined
Returns: instance
createViews()
Defined by dojox/grid/_Grid
defaultUpdate()
Defined by dojox/grid/_Grid
defer(fcn, delay)

Wrapper to setTimeout to avoid deferred functions executing after the originating widget has been destroyed. Returns an object handle with a remove method (that returns null) (replaces clearTimeout).

ParameterTypeDescription
fcnundefined
delayundefined
Returns: object
destroy()
destroyDescendants(preserveDom)

Recursively destroy the children of this widget and their descendants.

ParameterTypeDescription
preserveDomBoolean
Optional.

If true, the preserveDom attribute is passed to all descendant widget's .destroy() method. Not for use with _Templated widgets.

destroyRecursive(preserveDom)

Destroy this widget and its descendants

This is the generic "destructor" function that all widget users should call to cleanly discard with a widget. Once a widget is destroyed, it is removed from the manager object.

ParameterTypeDescription
preserveDomBoolean
Optional.

If true, this method will leave the original DOM structure alone of descendant Widgets. Note: This will NOT work with dijit._Templated widgets.

destroyRendering(preserveDom)

Destroys the DOM nodes associated with this widget

ParameterTypeDescription
preserveDomBoolean
Optional.

If true, this method will leave the original DOM structure alone during tear-down. Note: this will not work with _Templated widgets yet.

disconnect(handle)

Deprecated, will be removed in 2.0, use handle.remove() instead.

Disconnects handle created by connect.

ParameterTypeDescription
handleundefined
dispatchContentEvent(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
dispatchHeaderEvent(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
dispatchKeyEvent(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
doApplyCellEdit(inValue, inRowIndex, inAttrName)
ParameterTypeDescription
inValueundefined
inRowIndexundefined
inAttrNameundefined
doApplyEdit(inRowIndex, inDataAttr)
ParameterTypeDescription
inRowIndexundefined
inDataAttrundefined
doCancelEdit(inRowIndex)
ParameterTypeDescription
inRowIndexundefined
doclick(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
docontextmenu(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
dodblclick(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
doheaderclick(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
doheadercontextmenu(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
doheaderdblclick(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
dokeydown(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
doKeyEvent(e)
Defined by dojox/grid/_Grid
ParameterTypeDescription
eundefined
doStartEdit(inCell, inRowIndex)
ParameterTypeDescription
inCellundefined
inRowIndexundefined
emit(type, eventObj, callbackArgs)

Used by widgets to signal that a synthetic event occurred, ex:

myWidget.emit("attrmodified-selectedChildWidget", {}).

Emits an event on this.domNode named type.toLowerCase(), based on eventObj. Also calls onType() method, if present, and returns value from that method. By default passes eventObj to callback, but will pass callbackArgs instead, if specified. Modifies eventObj by adding missing parameters (bubbles, cancelable, widget).

ParameterTypeDescription
typeString
eventObjObject
Optional.
callbackArgsArray
Optional.
Returns: undefined
endUpdate()
Defined by dojox/grid/_Grid

Use after calling beginUpdate to render any changes made to rows.

filter(query, reRender)
ParameterTypeDescription
queryundefined
reRenderundefined
finishScrollJob()
Defined by dojox/grid/_Grid
get(inRowIndex, inItem)

Default data getter.

Provides data to display in a grid cell. Called in grid cell context. So this.cell.index is the column index.

ParameterTypeDescription
inRowIndexInteger

Row for which to provide data

inItemundefined
Returns: any | undefined

Data to display for a given grid cell.

getCell(inIndex)
Defined by dojox/grid/_Grid

Retrieves the cell object for a given grid column.

ParameterTypeDescription
inIndexInteger

Grid column index of cell to retrieve

Returns: any | undefined

a grid cell

getCellName(inCell)
ParameterTypeDescription
inCellundefined
Returns: undefined
getChildren()

Returns all the widgets contained by this, i.e., all widgets underneath this.containerNode. Does not return nested widgets, nor widgets that are part of this widget's template.

Returns: Array
getColumnTogglingItems()
Defined by dojox/grid/_Grid

returns an array of dijit.CheckedMenuItem widgets that can be added to a menu for toggling columns on and off.

Returns: undefined
getDescendants()
Defined by dijit/_Widget

Returns all the widgets contained by this, i.e., all widgets underneath this.containerNode. This method should generally be avoided as it returns widgets declared in templates, which are supposed to be internal/hidden, but it's left here for back-compat reasons.

Returns: Array
getItem(idx)
ParameterTypeDescription
idxundefined
Returns: null | undefined
getItemIndex(item)
ParameterTypeDescription
itemundefined
Returns: undefined
getParent()

Returns the parent widget of this widget

Returns: undefined
getRowNode(inRowIndex)
Defined by dojox/grid/_Grid

find the rowNode that is not a rowSelector

ParameterTypeDescription
inRowIndexundefined
Returns: undefined | null
getSortAsc(inSortInfo)
Defined by dojox/grid/_Grid

Returns true if grid is sorted in an ascending direction.

ParameterTypeDescription
inSortInfoundefined
Returns: undefined
getSortIndex(inSortInfo)
Defined by dojox/grid/_Grid

Returns the index of the column on which the grid is sorted

ParameterTypeDescription
inSortInfoundefined
Returns: number
getSortProps()
Returns: undefined | null | Array
getTextDir(text, originalDir)

Return direction of the text. The function overridden in the _BidiSupport module, its main purpose is to calculate the direction of the text, if was defined by the programmer through textDir.

ParameterTypeDescription
textString
originalDirString
Returns: String
hasLayout()
Defined by dojox/grid/_Grid
Returns: undefined
isFocusable()

Return true if this widget can currently be focused and false if not

Returns: undefined
isLeftToRight()

Return this widget's explicit or implicit orientation (true for LTR, false for RTL)

Returns: undefined
markupFactory(props, node, ctor, cellFunc)
ParameterTypeDescription
propsundefined
nodeundefined
ctorundefined
cellFuncundefined
on(type, func)
Defined by dijit/_Widget
ParameterTypeDescription
typeString | Function

protected

funcFunction
Returns: undefined
own()

Track specified handles and remove/destroy them when this instance is destroyed, unless they were already removed/destroyed manually.

Returns: any | undefined

The array of specified handles, so you can do for example:

var handle = this.own(on(...))[0];
placeAt(reference, position)

Place this widget somewhere in the DOM based on standard domConstruct.place() conventions.

A convenience function provided in all _Widgets, providing a simple shorthand mechanism to put an existing (or newly created) Widget somewhere in the dom, and allow chaining.

ParameterTypeDescription
referenceString | DomNode | _Widget

Widget, DOMNode, or id of widget or DOMNode

positionString | Int
Optional.

If reference is a widget (or id of widget), and that widget has an ".addChild" method, it will be called passing this widget instance into that method, supplying the optional position index passed. In this case position (if specified) should be an integer.

If reference is a DOMNode (or id matching a DOMNode but not a widget), the position argument can be a numeric index or a string "first", "last", "before", or "after", same as dojo/dom-construct::place().

Returns: dijit/_WidgetBase | function

Provides a useful return of the newly created dijit._Widget instance so you can "chain" this function by instantiating, placing, then saving the return value to a variable.

Example 1
// create a Button with no srcNodeRef, and place it in the body:
var button = new Button({ label:"click" }).placeAt(win.body());
// now, 'button' is still the widget reference to the newly created button
button.on("click", function(e){ console.log('click'); }));
Example 2
// create a button out of a node with id="src" and append it to id="wrapper":
var button = new Button({},"src").placeAt("wrapper");
Example 3
// place a new button as the first element of some div
var button = new Button({ label:"click" }).placeAt("wrapper","first");
Example 4
// create a contentpane and add it to a TabContainer
var tc = dijit.byId("myTabs");
new ContentPane({ href:"foo.html", title:"Wow!" }).placeAt(tc)
postCreate()
postMixInProperties()
Defined by dojox/grid/_Grid
postrender()
Defined by dojox/grid/_Grid
postresize()
Defined by dojox/grid/_Grid
postscript(params, srcNodeRef)

Kicks off widget instantiation. See create() for details.

ParameterTypeDescription
paramsObject
Optional.
srcNodeRefDomNode | String
prerender()
Defined by dojox/grid/_Grid
removeSelectedRows()

Remove the selected rows from the grid.

render()
Defined by dojox/grid/_Grid

Render the grid, headers, and views. Edit and scrolling states are reset. To retain edit and scrolling states, see Update.

renderRow(inRowIndex, inNodes)
Defined by dojox/grid/_Grid

used internally to render rows

ParameterTypeDescription
inRowIndexundefined
inNodesundefined
resize(changeSize, resultSize)
Defined by dojox/grid/_Grid

Update the grid's rendering dimensions and resize it

ParameterTypeDescription
changeSizeundefined
resultSizeundefined
rowHeightChanged(inRowIndex)
Defined by dojox/grid/_Grid

Update grid when the height of a row has changed. Row height is handled automatically as rows are rendered. Use this function only to update a row's height outside the normal rendering process.

ParameterTypeDescription
inRowIndexInteger

index of the row that has changed height

rowRemoved(inRowIndex)
Defined by dojox/grid/_Grid

used internally to remove rows

ParameterTypeDescription
inRowIndexundefined
scrollTo(inTop)
Defined by dojox/grid/_Grid

Vertically scroll the grid to a given pixel position

ParameterTypeDescription
inTopInteger

vertical position of the grid in pixels

scrollToRow(inRowIndex)
Defined by dojox/grid/_Grid

Scroll the grid to a specific row.

ParameterTypeDescription
inRowIndexInteger

grid row index

set(name, value)

Set a property on a widget

Sets named properties on a widget which may potentially be handled by a setter in the widget.

For example, if the widget has properties foo and bar and a method named _setFooAttr(), calling myWidget.set("foo", "Howdy!") would be equivalent to calling widget._setFooAttr("Howdy!") and myWidget.set("bar", 3) would be equivalent to the statement widget.bar = 3;

set() may also be called with a hash of name/value pairs, ex:

myWidget.set({
    foo: "Howdy",
    bar: 3
});

This is equivalent to calling set(foo, "Howdy") and set(bar, 3)

ParameterTypeDescription
nameundefined

The property to set.

valueundefined

The value to set in the property.

Returns: function | string

Set a property on a widget

setAttribute(attr, value)
Defined by dijit/_Widget

Deprecated. Use set() instead.

ParameterTypeDescription
attrString
valueanything
setCellWidth(inIndex, inUnitWidth)
Defined by dojox/grid/_Grid
ParameterTypeDescription
inIndexundefined
inUnitWidthundefined
setHeaderMenu(menu)
Defined by dojox/grid/_Grid
ParameterTypeDescription
menudijit/Menu
setItems(items)
ParameterTypeDescription
itemsundefined
setQuery(query, queryOptions)
ParameterTypeDescription
queryundefined
queryOptionsundefined
setScrollTop(inTop)
Defined by dojox/grid/_Grid
ParameterTypeDescription
inTopundefined
setSortIndex(inIndex, inAsc)
Defined by dojox/grid/_Grid

Sort the grid on a column in a specified direction

ParameterTypeDescription
inIndexInteger

Column index on which to sort.

inAscBoolean

If true, sort the grid in ascending order, otherwise in descending order

setSortInfo(inSortInfo)
Defined by dojox/grid/_Grid
ParameterTypeDescription
inSortInfoundefined
setStore(store, query, queryOptions)
ParameterTypeDescription
storeundefined
queryundefined
queryOptionsundefined
setStructure(inStructure)
Defined by dojox/grid/_Grid

Install a new structure and rebuild the grid.

ParameterTypeDescription
inStructuredojox.grid.__ViewDef | dojox.grid.__ViewDef[] | dojox.grid.__CellDef[] | Array[dojox.grid.__CellDef[]]
setupHeaderMenu()
Defined by dojox/grid/_Grid
showMessage(message)
Defined by dojox/grid/_Grid
ParameterTypeDescription
messageundefined
sizeChange()
Defined by dojox/grid/_Grid
sort()
startup()
Defined by dojox/grid/_Grid
styleRowNode(inRowIndex, inRowNode)
Defined by dojox/grid/_Grid

styling (used internally to style individual parts of a row)

ParameterTypeDescription
inRowIndexundefined
inRowNodeundefined
styleRowState(inRow)

Perform row styling

ParameterTypeDescription
inRowundefined
subscribe(t, method)

Deprecated, will be removed in 2.0, use this.own(topic.subscribe()) instead.

Subscribes to the specified topic and calls the specified method of this object and registers for unsubscribe() on widget destroy.

Provide widget-specific analog to dojo.subscribe, except with the implicit use of this widget as the target object.

ParameterTypeDescription
tString

The topic

methodFunction

The callback

Returns: undefined
Example
var btn = new Button();
// when /my/topic is published, this button changes its label to
// be the parameter of the topic.
btn.subscribe("/my/topic", function(v){
    this.set("label", v);
});
textSizeChanged()
Defined by dojox/grid/_Grid
toString()

Returns a string that represents the widget

When a widget is cast to a string, this method will be used to generate the output. Currently, it does not implement any sort of reversible serialization.

Returns: string
uninitialize()

Deprecated. Override destroy() instead to implement custom widget tear-down behavior.

Returns: boolean
unsubscribe(handle)

Deprecated, will be removed in 2.0, use handle.remove() instead.

Unsubscribes handle created by this.subscribe. Also removes handle from this widget's list of subscriptions

ParameterTypeDescription
handleObject
update()
Defined by dojox/grid/_Grid

Update the grid, retaining edit and scrolling states.

updateRow(inRowIndex)
Defined by dojox/grid/_Grid

Render a single row.

ParameterTypeDescription
inRowIndexInteger

Index of the row to render

updateRowCount(inRowCount)
Defined by dojox/grid/_Grid

Change the number of rows.

ParameterTypeDescription
inRowCountint

Number of rows in the grid.

updateRows(startIndex, howMany)
Defined by dojox/grid/_Grid

Render consecutive rows at once.

ParameterTypeDescription
startIndexInteger

Index of the starting row to render

howManyInteger

How many rows to update.

updateRowStyles(inRowIndex)
Defined by dojox/grid/_Grid

Update the styles for a row after it's state has changed.

ParameterTypeDescription
inRowIndexundefined
watch(name, callback)
Defined by dojo/Stateful

Watches a property for changes

ParameterTypeDescription
nameString
Optional.

Indicates the property to watch. This is optional (the callback may be the only parameter), and if omitted, all the properties will be watched

callbackFunction

The function to execute when the property changes. This will be called after the property has been changed. The callback will be called with the |this| set to the instance, the first argument as the name of the property, the second argument as the old value and the third argument as the new value.

Returns: any | object

An object handle for the watch. The unwatch method of this object can be used to discontinue watching this property:

var watchHandle = obj.watch("foo", callback);
watchHandle.unwatch(); // callback won't be called now

Events

_onBlur()

This is where widgets do processing for when they stop being active, such as changing CSS classes. See onBlur() for more details.

_onDelete(item)
ParameterTypeDescription
itemundefined
_onFetchBegin(size, req)
ParameterTypeDescription
sizeundefined
requndefined
_onFetchComplete(items, req)
ParameterTypeDescription
itemsundefined
requndefined
_onFetchError(err, req)
ParameterTypeDescription
errundefined
requndefined
_onFocus()

This is where widgets do processing for when they are active, such as changing CSS classes. See onFocus() for more details.

_onMap(type)

Maps on() type parameter (ex: "mousemove") to method name (ex: "onMouseMove"). If type is a synthetic event like touch.press then returns undefined.

ParameterTypeDescription
typeString | Function
Returns: undefined
_onNew(item, parentInfo)
ParameterTypeDescription
itemundefined
parentInfoundefined
_onRevert()
_onSet(item, attribute, oldValue, newValue)
ParameterTypeDescription
itemundefined
attributeundefined
oldValueundefined
newValueundefined
_onShow()
Defined by dijit/_Widget

Internal method called when this widget is made visible. See onShow for details.

onApplyCellEdit(inValue, inRowIndex, inFieldIndex)

Event fired when editing is applied for a given grid cell

ParameterTypeDescription
inValueString

Value from cell editor

inRowIndexInteger

Index of the grid row

inFieldIndexInteger

Index in the grid's data store

onApplyEdit(inRowIndex)

Event fired when editing is applied for a given grid row

ParameterTypeDescription
inRowIndexInteger

Index of the grid row

onBlur()

Called when the widget stops being "active" because focus moved to something outside of it, or the user clicked somewhere outside of it, or the widget was hidden.

onCancelEdit(inRowIndex)

Event fired when editing is cancelled for a given grid cell

ParameterTypeDescription
inRowIndexInteger

Index of the grid row

onCanDeselect(inRowIndex)

Event to determine if a grid row may be deselected

ParameterTypeDescription
inRowIndexInteger

Index of the grid row

Returns: Boolean | boolean

true if the row can be deselected

onCanSelect(inRowIndex)

Event to determine if a grid row may be selected

ParameterTypeDescription
inRowIndexInteger

Index of the grid row

Returns: Boolean | boolean

true if the row can be selected

onCellClick(e)

Event fired when a cell is clicked.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onCellContextMenu(e)

Event fired when a cell context menu is accessed via mouse right click.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onCellDblClick(e)

Event fired when a cell is double-clicked.

ParameterTypeDescription
eEvent

Decorated event object contains reference to grid, cell, and rowIndex

onCellFocus(inCell, inRowIndex)

Event fired when a cell receives focus.

ParameterTypeDescription
inCellObject

Cell object containing properties of the grid column.

inRowIndexInteger

Index of the grid row

onCellMouseDown(e)

Event fired when mouse is down in a header cell.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onCellMouseOut(e)

Event fired when mouse moves out of a cell.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onCellMouseOver(e)

Event fired when mouse is over a cell.

ParameterTypeDescription
eEvent

Decorated event object contains reference to grid, cell, and rowIndex

onClick(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of mouse click events.

ParameterTypeDescription
eventundefined

mouse Event

onClose()
Defined by dijit/_Widget

Called when this widget is being displayed as a popup (ex: a Calendar popped up from a DateTextBox), and it is hidden. This is called from the dijit.popup code, and should not be called directly.

Also used as a parameter for children of dijit/layout/StackContainer or subclasses. Callback if a user tries to close the child. Child will be closed if this function returns true.

Returns: boolean
onContentEvent(e)

Top level handler for Content events

ParameterTypeDescription
eundefined
onDblClick(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of mouse double click events.

ParameterTypeDescription
eventundefined

mouse Event

onDeselected(inRowIndex)

Event fired when a grid row is deselected

ParameterTypeDescription
inRowIndexInteger

Index of the grid row

onFetchError(err, req)
ParameterTypeDescription
errundefined
requndefined
onFocus()

Called when the widget becomes "active" because it or a widget inside of it either has focus, or has recently been clicked.

onHeaderCellClick(e)

Event fired when a header cell is clicked.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderCellContextMenu(e)

Event fired when a header cell context menu is accessed via mouse right click.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderCellDblClick(e)

Event fired when a header cell is double clicked.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderCellMouseDown(e)

Event fired when mouse is down in a header cell.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderCellMouseOut(e)

Event fired when mouse moves out of a header cell.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderCellMouseOver(e)

Event fired when mouse moves over a header cell.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderClick(e)

Event fired when the grid header is clicked.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderContextMenu(e)

Event fired when the grid header context menu is accessed via mouse right click.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderDblClick(e)

Event fired when the grid header is double clicked.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderEvent(e)

Top level handler for header events

ParameterTypeDescription
eundefined
onHeaderMouseOut(e)

Event fired when mouse moves out of the grid header.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onHeaderMouseOver(e)

Event fired when mouse moves over the grid header.

ParameterTypeDescription
eEvent

Decorated event object contains reference to grid, cell, and rowIndex

onHide()
Defined by dijit/_Widget

Called when another widget becomes the selected pane in a dijit/layout/TabContainer, dijit/layout/StackContainer, dijit/layout/AccordionContainer, etc.

Also called to indicate hide of a dijit.Dialog, dijit.TooltipDialog, or dijit.TitlePane.

onKeyDown(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of keys being pressed down.

ParameterTypeDescription
eventundefined

key Event

onKeyEvent(e)

top level handler for Key Events

ParameterTypeDescription
eundefined
onKeyPress(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of printable keys being typed.

ParameterTypeDescription
eventundefined

key Event

onKeyUp(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of keys being released.

ParameterTypeDescription
eventundefined

key Event

onMouseDown(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of when the mouse button is pressed down.

ParameterTypeDescription
eventundefined

mouse Event

onMouseDownRow(e)

Event fired when mouse is down inside grid row

ParameterTypeDescription
eEvent

Decorated event object that contains reference to grid, cell, and rowIndex

onMouseEnter(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of when the mouse moves onto this widget.

ParameterTypeDescription
eventundefined

mouse Event

onMouseLeave(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of when the mouse moves off of this widget.

ParameterTypeDescription
eventundefined

mouse Event

onMouseMove(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of when the mouse moves over nodes contained within this widget.

ParameterTypeDescription
eventundefined

mouse Event

onMouseOut(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of when the mouse moves off of nodes contained within this widget.

ParameterTypeDescription
eventundefined

mouse Event

onMouseOutRow(e)

Event fired when mouse moves out of any row (data or header).

ParameterTypeDescription
eEvent

Decorated event object contains reference to grid, cell, and rowIndex

onMouseOver(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of when the mouse moves onto nodes contained within this widget.

ParameterTypeDescription
eventundefined

mouse Event

onMouseOverRow(e)

Event fired when mouse is over any row (data or header).

ParameterTypeDescription
eEvent

Decorated event object contains reference to grid, cell, and rowIndex

onMouseUp(event)
Defined by dijit/_Widget

Connect to this function to receive notifications of when the mouse button is released.

ParameterTypeDescription
eventundefined

mouse Event

onMoveColumn()
Defined by dojox/grid/_Grid
onResizeColumn(cellIdx)
Defined by dojox/grid/_Grid
ParameterTypeDescription
cellIdxint
onRowClick(e)

Event fired when a row is clicked.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onRowContextMenu(e)

Event fired when a row context menu is accessed via mouse right click.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onRowDblClick(e)

Event fired when a row is double clicked.

ParameterTypeDescription
eEvent

decorated event object which contains reference to grid, cell, and rowIndex

onRowMouseDown(e)

Event fired when mouse is down in a row.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onRowMouseOut(e)

Event fired when mouse moves out of a data row.

ParameterTypeDescription
eEvent

Decorated event object contains reference to grid, cell, and rowIndex

onRowMouseOver(e)

Event fired when mouse moves over a data row.

ParameterTypeDescription
eEvent

Decorated event object which contains reference to grid, cell, and rowIndex

onSelected(inRowIndex)

Event fired when a grid row is selected

ParameterTypeDescription
inRowIndexInteger

Index of the grid row

onSelectionChanged()
onShow()
Defined by dijit/_Widget

Called when this widget becomes the selected pane in a dijit/layout/TabContainer, dijit/layout/StackContainer, dijit/layout/AccordionContainer, etc.

Also called to indicate display of a dijit.Dialog, dijit.TooltipDialog, or dijit.TitlePane.

onStartEdit(inCell, inRowIndex)

Event fired when editing is started for a given grid cell

ParameterTypeDescription
inCellObject

Cell object containing properties of the grid column.

inRowIndexInteger

Index of the grid row

onStyleRow(inRow)
ParameterTypeDescription
inRowundefined