| DHTMLX Documentation

# How to use new excell “combo”

“Combo” excell supports all modes of the dhtmlxcombo.

There are two ways of setting a combo:

1) For the whole column;

2) For a certain cell.

Combo loading and representation modes are set by special attributes in the xml:

a) xmlcontent - In this case the options can be defined directly in the grid xml;

b) source - Sets the source of the combo xml;

c) editable - true/false; "true" by default;

d) filtering - true/false; "false" by default. Enables filtering mode (the same as enableFilteringMode for the combo);

e) auto - true/false; "false" by default. Enables autocomplete mode (the same as enableFilteringMode(mode,source) for the combo);

- cache (the additional parameter for autocomplete mode) – the xml suggestions are cached (the same as enableFilteringMode(mode,source,cache));

- sub (the additional parameter for autocomplete mode) - enables auto load additional suggestions on selecting the last loaded option (the same as enableFilteringMode(mode,source,cache,sub)).

Setting “combo” column:

For the whole column the combo is set in the <column> tag.

Examples:

> <column width="150" type="combo” xmlcontent="1"…>TEXT<option value="1">one</option>

> <option value="2">two</option>

> <option value="3">three</option>

> …

> </column>

> <column width="150" type="combo" editable="false" source="data.xml" …>TEXT

> </column>

> <column type="combo" source="complete.php" auto="true" cache="true" sub="true"… >TEXT

> </column>

Combo value should be set inside the <cell> tags:

> <cell>1</cell>

In case of autocomplete mode the following instruction defines the value and the text:

> <cell>value^text</cell>

For example:

> <cell>1^one</cell>

Setting “combo” cell:

The combo for a cell is set practically in the same way as one for the column. The difference is in using the <cell> tag instead of the <column> one. Also the xmlcontent attribute is always necessary:

> <cell xmlcontent="1" editable="0">1<option value="1">one</option>

> <option value="2">two</option>

> <option value="3">three</option>

> </cell>
> <cell xmlcontent="1" source="data.xml" filter="true”>1</cell>

In case of auto complete mode the text should be set with the help of the text attribute:

> <cell xmlcontent="1" source="complete.php" auto="true" cache="true" text="some text">4</cell>

New methods:

getCellCombo returns cell combo object:

> combo = grid.cells(id,index).getCellCombo();

> combo.enableFilteingMode(true)

getColumnCombo returns column combo object:

> combo = grid.getCellCombo(column_index);

© DHTMLX, 2008