DHTMLX Docs & Samples Explorer

Index
dhtmlxgrid

## Managing select box collection (co, coro excells)

### Initialization by script

The following method can be used to get a select box collection common for the whole column:

           combo = grid.getCombo(index);

If you need a collection to be specific for a cell:

           combo = grid.getCustomCombo(rId,cIndex)

The collection supports the following API:

        combo.put(value,label) - adds a new record in the collection;
        combo.remove(value) - removes a record from the collection;
        combo.clear() - removes all records from the collection;

        combo.size() - returns the current size of the combo box;
        combo.get(value) - returns the label by value;
        combo.getKeys() - returns the array of all possible values;

        combo.save() - saves the current state;
        combo.restore() - restores the previously saved state.

### Initialization from XML

The list of options for combo can be defined from XML in two ways:

- With column configuration the values will be set for all cells in a column

        <rows>
            <head>
                <column type="co"> Combo column
                    <option value="1"> First </option>
                    <option value="2"> Second </option>
                    <option value="3"> Third </option>
                </column>

- For separate cells ( pro version only )

        <rows>
            <row id="some1">
                <cell> some </cell>
                <cell> some </cell>
                <cell xmlcontent="true">1<option value="1">The first</option><option value="2">The second</option></cell>
                <cell> some </cell>
            </row>
        </rows>