~inkscape.dev/inkscape-devlibs/devlibs-gtk3

<a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> * <a class="link" href="GtkListStore.html#gtk-list-store-new" title="gtk_list_store_new ()">gtk_list_store_new</a> (<code>gint n_columns</code>,

<code>...</code>);

<a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> * <a class="link" href="GtkListStore.html#gtk-list-store-newv" title="gtk_list_store_newv ()">gtk_list_store_newv</a> (<code>gint n_columns</code>,

<code>GType *types</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-set-column-types" title="gtk_list_store_set_column_types ()">gtk_list_store_set_column_types</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code>gint n_columns</code>,

<code>GType *types</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()">gtk_list_store_set</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

<code>...</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-set-valist" title="gtk_list_store_set_valist ()">gtk_list_store_set_valist</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

<code>va_list var_args</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()">gtk_list_store_set_value</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

<code>gint column</code>,

<code>GValue *value</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-set-valuesv" title="gtk_list_store_set_valuesv ()">gtk_list_store_set_valuesv</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

<code>gint *columns</code>,

<code>GValue *values</code>,

<code>gint n_values</code>);

gboolean <a class="link" href="GtkListStore.html#gtk-list-store-remove" title="gtk_list_store_remove ()">gtk_list_store_remove</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-insert" title="gtk_list_store_insert ()">gtk_list_store_insert</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

<code>gint position</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-insert-before" title="gtk_list_store_insert_before ()">gtk_list_store_insert_before</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *sibling</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-insert-after" title="gtk_list_store_insert_after ()">gtk_list_store_insert_after</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *sibling</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-insert-with-values" title="gtk_list_store_insert_with_values ()">gtk_list_store_insert_with_values</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

<code>gint position</code>,

<code>...</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-insert-with-valuesv" title="gtk_list_store_insert_with_valuesv ()">gtk_list_store_insert_with_valuesv</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

<code>gint position</code>,

<code>gint *columns</code>,

<code>GValue *values</code>,

<code>gint n_values</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-prepend" title="gtk_list_store_prepend ()">gtk_list_store_prepend</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-append" title="gtk_list_store_append ()">gtk_list_store_append</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-clear" title="gtk_list_store_clear ()">gtk_list_store_clear</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>);

gboolean <a class="link" href="GtkListStore.html#gtk-list-store-iter-is-valid" title="gtk_list_store_iter_is_valid ()">gtk_list_store_iter_is_valid</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>);

void <a class="link" href="GtkListStore.html#gtk-list-store-reorder" title="gtk_list_store_reorder ()">gtk_list_store_reorder</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *store</code>,

<code>gint *new_order</code>);

100

void <a class="link" href="GtkListStore.html#gtk-list-store-swap" title="gtk_list_store_swap ()">gtk_list_store_swap</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *store</code>,

101

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *a</code>,

102

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *b</code>);

103

void <a class="link" href="GtkListStore.html#gtk-list-store-move-before" title="gtk_list_store_move_before ()">gtk_list_store_move_before</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *store</code>,

104

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

105

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *position</code>);

106

void <a class="link" href="GtkListStore.html#gtk-list-store-move-after" title="gtk_list_store_move_after ()">gtk_list_store_move_after</a> (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *store</code>,

107

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

108

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *position</code>);

109

</pre>

110

</div>

111

112

<a name="GtkListStore.object-hierarchy"></a><h2>Object Hierarchy</h2>

113

114

GObject

115

+----GtkListStore

116

</pre>

117

</div>

118

119

<a name="GtkListStore.implemented-interfaces"></a><h2>Implemented Interfaces</h2>

120

121

GtkListStore implements

122

<a class="link" href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a>, <a class="link" href="gtk2-GtkTreeView-drag-and-drop.html#GtkTreeDragSource">GtkTreeDragSource</a>, <a class="link" href="gtk2-GtkTreeView-drag-and-drop.html#GtkTreeDragDest">GtkTreeDragDest</a>, <a class="link" href="GtkTreeSortable.html" title="GtkTreeSortable">GtkTreeSortable</a> and <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.

123

</div>

124

125

<a name="GtkListStore.description"></a><h2>Description</h2>

126

127

The <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> object is a list model for use with a <a class="link" href="GtkTreeView.html" title="GtkTreeView">GtkTreeView</a>

128

widget. It implements the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a> interface, and consequentialy,

129

can use all of the methods available there. It also implements the

130

<a class="link" href="GtkTreeSortable.html" title="GtkTreeSortable">GtkTreeSortable</a> interface so it can be sorted by the view.

131

Finally, it also implements the tree <GTKDOCLINK HREF="gtktreednd">drag and

132

drop</GTKDOCLINK> interfaces.

133

134

135

The <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> can accept most GObject types as a column type, though

136

it can't accept all custom types. Internally, it will keep a copy of

137

data passed in (such as a string or a boxed pointer). Columns that

138

accept GObjects are handled a little differently. The

139

<a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> will keep a reference to the object instead of copying the

140

value. As a result, if the object is modified, it is up to the

141

application writer to call <code>gtk_tree_model_row_changed</code> to emit the

142

"row_changed" signal. This most commonly affects lists with

143

<a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a>s stored.

144

145

146

<a name="idp67836080"></a>Example 27. Creating a simple list store.

147

148

149

<tbody>

150

<tr>

151

<td class="listing_lines" align="right"><pre>1

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

41</pre></td>

192

<td class="listing_code"><pre class="programlisting">enum {

193

COLUMN_STRING,

194

COLUMN_INT,

195

COLUMN_BOOLEAN,

196

N_COLUMNS

197

};

198

{

199

GtkListStore *list_store;

200

GtkTreePath *path;

201

GtkTreeIter iter;

202

gint i;

203

list_store = <a href="GtkListStore.html#gtk-list-store-new">gtk_list_store_new</a> (N_COLUMNS,

204

G_TYPE_STRING,

205

G_TYPE_INT,

206

G_TYPE_BOOLEAN);

207

for (i = 0; i < 10; i++)

208

{

209

gchar *some_data;

210

some_data = get_some_data (i);

211

/* Add a new row to the model */

212

<a href="GtkListStore.html#gtk-list-store-append">gtk_list_store_append</a> (list_store, &iter);

213

<a href="GtkListStore.html#gtk-list-store-set">gtk_list_store_set</a> (list_store, &iter,

214

COLUMN_STRING, some_data,

215

COLUMN_INT, i,

216

COLUMN_BOOLEAN, FALSE,

217

-1);

218

/* As the store will keep a copy of the string internally, we

219

* free some_data.

220

*/

221

g_free (some_data);

222

}

223

/* Modify a particular row */

224

path = <a href="GtkTreeModel.html#gtk-tree-path-new-from-string">gtk_tree_path_new_from_string</a> ("4");

225

<a href="GtkTreeModel.html#gtk-tree-model-get-iter">gtk_tree_model_get_iter</a> (GTK_TREE_MODEL (list_store),

226

&iter,

227

path);

228

<a href="GtkTreeModel.html#gtk-tree-path-free">gtk_tree_path_free</a> (path);

229

230

COLUMN_BOOLEAN, TRUE,

231

-1);

232

}</pre></td>

233

</tr>

234

</tbody>

235

</table>

236

</div>

237

238

</div>

239

240

<a name="idp67839008"></a><h3>Performance Considerations</h3>

241

242

Internally, the <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> was implemented with a linked list with a

243

tail pointer prior to GTK+ 2.6. As a result, it was fast at data

244

insertion and deletion, and not fast at random data access. The

245

<a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> sets the <a class="link" href="GtkTreeModel.html#GTK-TREE-MODEL-ITERS-PERSIST:CAPS">GTK_TREE_MODEL_ITERS_PERSIST</a> flag, which means

246

that <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a>s can be cached while the row exists. Thus, if

247

access to a particular row is needed often and your code is expected to

248

run on older versions of GTK+, it is worth keeping the iter around.

249

250

251

It is important to note that only the methods

252

<a class="link" href="GtkListStore.html#gtk-list-store-insert-with-values" title="gtk_list_store_insert_with_values ()"><code class="function">gtk_list_store_insert_with_values()</code></a> and <a class="link" href="GtkListStore.html#gtk-list-store-insert-with-valuesv" title="gtk_list_store_insert_with_valuesv ()"><code class="function">gtk_list_store_insert_with_valuesv()</code></a>

253

are atomic, in the sense that the row is being appended to the store and the

254

values filled in in a single operation with regard to <a class="link" href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a> signaling.

255

In contrast, using e.g. <a class="link" href="GtkListStore.html#gtk-list-store-append" title="gtk_list_store_append ()"><code class="function">gtk_list_store_append()</code></a> and then <a class="link" href="GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a>

256

will first create a row, which triggers the <a class="link" href="GtkTreeModel.html#GtkTreeModel-row-inserted" title='The "row-inserted" signal'>"row-inserted"</a> signal

257

on <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>. The row, however, is still empty, and any signal handler

258

connecting to "row-inserted" on this particular store should be prepared

259

for the situation that the row might be empty. This is especially important

260

if you are wrapping the <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> inside a <a class="link" href="GtkTreeModelFilter.html" title="GtkTreeModelFilter">GtkTreeModelFilter</a> and are

261

using a <a class="link" href="GtkTreeModelFilter.html#GtkTreeModelFilterVisibleFunc" title="GtkTreeModelFilterVisibleFunc ()">GtkTreeModelFilterVisibleFunc</a>. Using any of the non-atomic operations

262

to append rows to the <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> will cause the

263

<a class="link" href="GtkTreeModelFilter.html#GtkTreeModelFilterVisibleFunc" title="GtkTreeModelFilterVisibleFunc ()">GtkTreeModelFilterVisibleFunc</a> to be visited with an empty row first; the

264

function must be prepared for that.

265

266

</div>

267

<hr>

268

269

<a name="GtkListStore-BUILDER-UI"></a><h3>GtkListStore as GtkBuildable</h3>

270

271

The GtkListStore implementation of the GtkBuildable interface allows

272

to specify the model columns with a <columns> element that may

273

contain multiple <column> elements, each specifying one model

274

column. The "type" attribute specifies the data type for the column.

275

276

277

Additionally, it is possible to specify content for the list store

278

in the UI definition, with the <data> element. It can contain

279

multiple <row> elements, each specifying to content for one

280

row of the list model. Inside a <row>, the <col> elements

281

specify the content for individual cells.

282

283

284

Note that it is probably more common to define your models

285

in the code, and one might consider it a layering violation

286

to specify the content of a list store in a UI definition,

287

data, not presentation,

288

and common wisdom is to separate the two, as far as possible.

289

290

291

292

<a name="idp67861440"></a>Example 28. A UI Definition fragment for a list store

293

294

295

<tbody>

296

<tr>

297

<td class="listing_lines" align="right"><pre>1

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

19</pre></td>

316

317

318

319

320

321

</columns>

322

<data>

323

<row>

324

325

326

327

</row>

328

<row>

329

<col id="0">Johan</col>

330

<col id="1">Dahlin</col>

331

332

</row>

333

</data>

334

</object></pre></td>

335

</tr>

336

</tbody>

337

</table>

338

</div>

339

340

</div>

341

342

</div>

343

</div>

344

345

<a name="GtkListStore.details"></a><h2>Details</h2>

346

347

<a name="GtkListStore-struct"></a><h3>struct GtkListStore</h3>

348

<pre class="programlisting">struct GtkListStore;</pre>

349

350

351

</div>

352

<hr>

353

354

<a name="gtk-list-store-new"></a><h3>gtk_list_store_new ()</h3>

355

<pre class="programlisting"><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> * gtk_list_store_new (<code>gint n_columns</code>,

356

357

358

Creates a new list store as with <code>n_columns</code> columns each of the types passed

359

in. Note that only types derived from standard GObject fundamental types

360

are supported.

361

362

363

As an example, <code class="literal">gtk_tree_store_new (3, G_TYPE_INT, G_TYPE_STRING,

364

GDK_TYPE_PIXBUF);</code> will create a new <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> with three columns, of type

365

int, string and <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf">GdkPixbuf</a> respectively.

366

367

368

369

370

<col>

371

</colgroup>

372

<tbody>

373

<tr>

374

<td><code>n_columns</code> :</td>

375

<td>number of columns in the list store</td>

376

</tr>

377

<tr>

378

<td>Returns :</td>

379

<td>a new <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

380

</td>

381

</tr>

382

</tbody>

383

</table></div>

384

</div>

385

<hr>

386

387

<a name="gtk-list-store-newv"></a><h3>gtk_list_store_newv ()</h3>

388

<pre class="programlisting"><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> * gtk_list_store_newv (<code>gint n_columns</code>,

389

<code>GType *types</code>);</pre>

390

391

Non-vararg creation function. Used primarily by language bindings.

392

393

394

395

396

<col>

397

</colgroup>

398

<tbody>

399

<tr>

400

<td><code>n_columns</code> :</td>

401

<td>number of columns in the list store</td>

402

</tr>

403

<tr>

404

<td><code>types</code> :</td>

405

<td>an array of GType types for the columns, from first to last. [<acronym title="Parameter points to an array of items.">array</acronym> length=n_columns]

406

</td>

407

</tr>

408

<tr>

409

<td>Returns :</td>

410

<td>a new <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

411

</td>

412

</tr>

413

</tbody>

414

</table></div>

415

</div>

416

<hr>

417

418

<a name="gtk-list-store-set-column-types"></a><h3>gtk_list_store_set_column_types ()</h3>

419

<pre class="programlisting">void gtk_list_store_set_column_types (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

420

<code>gint n_columns</code>,

421

<code>GType *types</code>);</pre>

422

423

This function is meant primarily for GObjects that inherit from <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>,

424

and should only be used when constructing a new <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>. It will not

425

function after a row has been added, or a method on the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a>

426

interface is called.

427

428

429

430

431

<col>

432

</colgroup>

433

<tbody>

434

<tr>

435

<td><code>list_store</code> :</td>

436

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

437

</td>

438

</tr>

439

<tr>

440

<td><code>n_columns</code> :</td>

441

<td>Number of columns for the list store</td>

442

</tr>

443

<tr>

444

<td><code>types</code> :</td>

445

<td>An array length n of GTypes. [<acronym title="Parameter points to an array of items.">array</acronym> length=n_columns]

446

</td>

447

</tr>

448

</tbody>

449

</table></div>

450

</div>

451

<hr>

452

453

<a name="gtk-list-store-set"></a><h3>gtk_list_store_set ()</h3>

454

<pre class="programlisting">void gtk_list_store_set (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

455

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

456

457

458

Sets the value of one or more cells in the row referenced by <code>iter</code>.

459

The variable argument list should contain integer column numbers,

460

each column number followed by the value to be set.

461

The list is terminated by a -1. For example, to set column 0 with type

462

<code class="literal">G_TYPE_STRING</code> to "Foo", you would write <code class="literal">gtk_list_store_set (store, iter,

463

0, "Foo", -1)</code>.

464

465

466

The value will be referenced by the store if it is a <code class="literal">G_TYPE_OBJECT</code>, and it

467

will be copied if it is a <code class="literal">G_TYPE_STRING</code> or <code class="literal">G_TYPE_BOXED</code>.

468

469

470

471

472

<col>

473

</colgroup>

474

<tbody>

475

<tr>

476

<td><code>list_store</code> :</td>

477

<td>a <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

478

</td>

479

</tr>

480

<tr>

481

482

<td>row iterator</td>

483

</tr>

484

</tbody>

485

</table></div>

486

</div>

487

<hr>

488

489

<a name="gtk-list-store-set-valist"></a><h3>gtk_list_store_set_valist ()</h3>

490

<pre class="programlisting">void gtk_list_store_set_valist (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

491

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

492

493

494

See <a class="link" href="GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a>; this version takes a va_list for use by language

495

bindings.

496

497

498

499

500

<col>

501

</colgroup>

502

<tbody>

503

<tr>

504

<td><code>list_store</code> :</td>

505

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

506

</td>

507

</tr>

508

<tr>

509

510

<td>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> for the row being modified</td>

511

</tr>

512

<tr>

513

514

<td>va_list of column/value pairs</td>

515

</tr>

516

</tbody>

517

</table></div>

518

</div>

519

<hr>

520

521

<a name="gtk-list-store-set-value"></a><h3>gtk_list_store_set_value ()</h3>

522

<pre class="programlisting">void gtk_list_store_set_value (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

523

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

524

<code>gint column</code>,

525

<code>GValue *value</code>);</pre>

526

527

Sets the data in the cell specified by <code>iter</code> and <code>column</code>.

528

The type of <code>value</code> must be convertible to the type of the

529

column.

530

531

532

533

534

<col>

535

</colgroup>

536

<tbody>

537

<tr>

538

<td><code>list_store</code> :</td>

539

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

540

</td>

541

</tr>

542

<tr>

543

544

<td>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> for the row being modified</td>

545

</tr>

546

<tr>

547

<td><code>column</code> :</td>

548

<td>column number to modify</td>

549

</tr>

550

<tr>

551

<td><code>value</code> :</td>

552

<td>new value for the cell</td>

553

</tr>

554

</tbody>

555

</table></div>

556

</div>

557

<hr>

558

559

<a name="gtk-list-store-set-valuesv"></a><h3>gtk_list_store_set_valuesv ()</h3>

560

<pre class="programlisting">void gtk_list_store_set_valuesv (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

561

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

562

<code>gint *columns</code>,

563

<code>GValue *values</code>,

564

<code>gint n_values</code>);</pre>

565

566

A variant of <a class="link" href="GtkListStore.html#gtk-list-store-set-valist" title="gtk_list_store_set_valist ()"><code class="function">gtk_list_store_set_valist()</code></a> which

567

takes the columns and values as two arrays, instead of

568

varargs. This function is mainly intended for

569

language-bindings and in case the number of columns to

570

change is not known until run-time.

571

572

573

574

575

<col>

576

</colgroup>

577

<tbody>

578

<tr>

579

<td><code>list_store</code> :</td>

580

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

581

</td>

582

</tr>

583

<tr>

584

585

<td>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> for the row being modified</td>

586

</tr>

587

<tr>

588

<td><code>columns</code> :</td>

589

<td>an array of column numbers. [<acronym title="Parameter points to an array of items.">array</acronym> length=n_values]

590

</td>

591

</tr>

592

<tr>

593

<td><code>values</code> :</td>

594

<td>an array of GValues. [<acronym title="Parameter points to an array of items.">array</acronym> length=n_values]

595

</td>

596

</tr>

597

<tr>

598

<td><code>n_values</code> :</td>

599

<td>the length of the <code>columns</code> and <code>values</code> arrays</td>

600

</tr>

601

</tbody>

602

</table></div>

603

Since 2.12

604

</div>

605

<hr>

606

607

<a name="gtk-list-store-remove"></a><h3>gtk_list_store_remove ()</h3>

608

<pre class="programlisting">gboolean gtk_list_store_remove (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

609

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>);</pre>

610

611

Removes the given row from the list store. After being removed,

612

<code>iter</code> is set to be the next valid row, or invalidated if it pointed

613

to the last row in <code>list_store</code>.

614

615

616

617

618

<col>

619

</colgroup>

620

<tbody>

621

<tr>

622

<td><code>list_store</code> :</td>

623

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

624

</td>

625

</tr>

626

<tr>

627

628

<td>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a>

629

</td>

630

</tr>

631

<tr>

632

<td>Returns :</td>

633

<td>

634

<code class="literal">TRUE</code> if <code>iter</code> is valid, <code class="literal">FALSE</code> if not.</td>

635

</tr>

636

</tbody>

637

</table></div>

638

</div>

639

<hr>

640

641

<a name="gtk-list-store-insert"></a><h3>gtk_list_store_insert ()</h3>

642

<pre class="programlisting">void gtk_list_store_insert (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

643

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

644

<code>gint position</code>);</pre>

645

646

Creates a new row at <code>position</code>. <code>iter</code> will be changed to point to this new

647

row. If <code>position</code> is larger than the number of rows on the list, then the

648

new row will be appended to the list. The row will be empty after this

649

function is called. To fill in values, you need to call

650

<a class="link" href="GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()"><code class="function">gtk_list_store_set_value()</code></a>.

651

652

653

654

655

<col>

656

</colgroup>

657

<tbody>

658

<tr>

659

<td><code>list_store</code> :</td>

660

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

661

</td>

662

</tr>

663

<tr>

664

665

<td>An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> to set to the new row. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

666

</td>

667

</tr>

668

<tr>

669

<td><code>position</code> :</td>

670

<td>position to insert the new row</td>

671

</tr>

672

</tbody>

673

</table></div>

674

</div>

675

<hr>

676

677

<a name="gtk-list-store-insert-before"></a><h3>gtk_list_store_insert_before ()</h3>

678

<pre class="programlisting">void gtk_list_store_insert_before (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

679

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

680

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *sibling</code>);</pre>

681

682

Inserts a new row before <code>sibling</code>. If <code>sibling</code> is <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the row will

683

be appended to the end of the list. <code>iter</code> will be changed to point to this

684

new row. The row will be empty after this function is called. To fill in

685

values, you need to call <a class="link" href="GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()"><code class="function">gtk_list_store_set_value()</code></a>.

686

687

688

689

690

<col>

691

</colgroup>

692

<tbody>

693

<tr>

694

<td><code>list_store</code> :</td>

695

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

696

</td>

697

</tr>

698

<tr>

699

700

701

</td>

702

</tr>

703

<tr>

704

<td><code>sibling</code> :</td>

705

<td>A valid <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

706

</td>

707

</tr>

708

</tbody>

709

</table></div>

710

</div>

711

<hr>

712

713

<a name="gtk-list-store-insert-after"></a><h3>gtk_list_store_insert_after ()</h3>

714

<pre class="programlisting">void gtk_list_store_insert_after (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

715

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

716

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *sibling</code>);</pre>

717

718

Inserts a new row after <code>sibling</code>. If <code>sibling</code> is <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the row will be

719

prepended to the beginning of the list. <code>iter</code> will be changed to point to

720

this new row. The row will be empty after this function is called. To fill

721

in values, you need to call <a class="link" href="GtkListStore.html#gtk-list-store-set" title="gtk_list_store_set ()"><code class="function">gtk_list_store_set()</code></a> or <a class="link" href="GtkListStore.html#gtk-list-store-set-value" title="gtk_list_store_set_value ()"><code class="function">gtk_list_store_set_value()</code></a>.

722

723

724

725

726

<col>

727

</colgroup>

728

<tbody>

729

<tr>

730

<td><code>list_store</code> :</td>

731

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

732

</td>

733

</tr>

734

<tr>

735

736

737

</td>

738

</tr>

739

<tr>

740

<td><code>sibling</code> :</td>

741

742

</td>

743

</tr>

744

</tbody>

745

</table></div>

746

</div>

747

<hr>

748

749

<a name="gtk-list-store-insert-with-values"></a><h3>gtk_list_store_insert_with_values ()</h3>

750

<pre class="programlisting">void gtk_list_store_insert_with_values (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

751

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

752

<code>gint position</code>,

753

754

755

Creates a new row at <code>position</code>. <code>iter</code> will be changed to point to this new

756

row. If <code>position</code> is larger than the number of rows on the list, then the

757

new row will be appended to the list. The row will be filled with the

758

values given to this function.

759

760

761

Calling

762

<code class="literal">gtk_list_store_insert_with_values(list_store, iter, position...)</code>

763

has the same effect as calling

764

765

766

767

<tbody>

768

<tr>

769

<td class="listing_lines" align="right"><pre>1

770

2</pre></td>

771

<td class="listing_code"><pre class="programlisting"><a href="GtkListStore.html#gtk-list-store-insert">gtk_list_store_insert</a> (list_store, iter, position);

772

<a href="GtkListStore.html#gtk-list-store-set">gtk_list_store_set</a> (list_store, iter, ...);</pre></td>

773

</tr>

774

</tbody>

775

</table>

776

</div>

777

778

779

with the difference that the former will only emit a row_inserted signal,

780

while the latter will emit row_inserted, row_changed and, if the list store

781

is sorted, rows_reordered. Since emitting the rows_reordered signal

782

repeatedly can affect the performance of the program,

783

784

inserting rows in a sorted list store.

785

786

787

788

789

<col>

790

</colgroup>

791

<tbody>

792

<tr>

793

<td><code>list_store</code> :</td>

794

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

795

</td>

796

</tr>

797

<tr>

798

799

<td>An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> to set to the new row, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

800

</td>

801

</tr>

802

<tr>

803

<td><code>position</code> :</td>

804

<td>position to insert the new row</td>

805

</tr>

806

</tbody>

807

</table></div>

808

Since 2.6

809

</div>

810

<hr>

811

812

<a name="gtk-list-store-insert-with-valuesv"></a><h3>gtk_list_store_insert_with_valuesv ()</h3>

813

<pre class="programlisting">void gtk_list_store_insert_with_valuesv (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

814

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

815

<code>gint position</code>,

816

<code>gint *columns</code>,

817

<code>GValue *values</code>,

818

<code>gint n_values</code>);</pre>

819

820

A variant of <a class="link" href="GtkListStore.html#gtk-list-store-insert-with-values" title="gtk_list_store_insert_with_values ()"><code class="function">gtk_list_store_insert_with_values()</code></a> which

821

takes the columns and values as two arrays, instead of

822

varargs. This function is mainly intended for

823

language-bindings.

824

825

826

827

828

<col>

829

</colgroup>

830

<tbody>

831

<tr>

832

<td><code>list_store</code> :</td>

833

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

834

</td>

835

</tr>

836

<tr>

837

838

839

</td>

840

</tr>

841

<tr>

842

<td><code>position</code> :</td>

843

<td>position to insert the new row</td>

844

</tr>

845

<tr>

846

<td><code>columns</code> :</td>

847

<td>an array of column numbers. [<acronym title="Parameter points to an array of items.">array</acronym> length=n_values]

848

</td>

849

</tr>

850

<tr>

851

<td><code>values</code> :</td>

852

<td>an array of GValues. [<acronym title="Parameter points to an array of items.">array</acronym> length=n_values]

853

</td>

854

</tr>

855

<tr>

856

<td><code>n_values</code> :</td>

857

<td>the length of the <code>columns</code> and <code>values</code> arrays</td>

858

</tr>

859

</tbody>

860

</table></div>

861

Since 2.6

862

</div>

863

<hr>

864

865

<a name="gtk-list-store-prepend"></a><h3>gtk_list_store_prepend ()</h3>

866

<pre class="programlisting">void gtk_list_store_prepend (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

867

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>);</pre>

868

869

Prepends a new row to <code>list_store</code>. <code>iter</code> will be changed to point to this new

870

row. The row will be empty after this function is called. To fill in

871

872

873

874

875

876

<col>

877

</colgroup>

878

<tbody>

879

<tr>

880

<td><code>list_store</code> :</td>

881

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

882

</td>

883

</tr>

884

<tr>

885

886

<td>An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> to set to the prepend row. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

887

</td>

888

</tr>

889

</tbody>

890

</table></div>

891

</div>

892

<hr>

893

894

<a name="gtk-list-store-append"></a><h3>gtk_list_store_append ()</h3>

895

<pre class="programlisting">void gtk_list_store_append (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

896

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>);</pre>

897

898

Appends a new row to <code>list_store</code>. <code>iter</code> will be changed to point to this new

899

row. The row will be empty after this function is called. To fill in

900

901

902

903

904

905

<col>

906

</colgroup>

907

<tbody>

908

<tr>

909

<td><code>list_store</code> :</td>

910

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>

911

</td>

912

</tr>

913

<tr>

914

915

<td>An unset <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> to set to the appended row. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

916

</td>

917

</tr>

918

</tbody>

919

</table></div>

920

</div>

921

<hr>

922

923

<a name="gtk-list-store-clear"></a><h3>gtk_list_store_clear ()</h3>

924

<pre class="programlisting">void gtk_list_store_clear (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>);</pre>

925

926

Removes all rows from the list store.

927

928

929

930

931

<col>

932

</colgroup>

933

934

<td><code>list_store</code> :</td>

935

<td>a <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>.</td>

936

</tr></tbody>

937

</table></div>

938

</div>

939

<hr>

940

941

<a name="gtk-list-store-iter-is-valid"></a><h3>gtk_list_store_iter_is_valid ()</h3>

942

<pre class="programlisting">gboolean gtk_list_store_iter_is_valid (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *list_store</code>,

943

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>);</pre>

944

945

946

947

<h3 class="title">Warning</h3>This function is slow. Only use it for debugging and/or testing

948

purposes.</div>

949

950

951

952

Checks if the given iter is a valid iter for this <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>.

953

954

955

956

957

<col>

958

</colgroup>

959

<tbody>

960

<tr>

961

<td><code>list_store</code> :</td>

962

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>.</td>

963

</tr>

964

<tr>

965

966

<td>A <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a>.</td>

967

</tr>

968

<tr>

969

<td>Returns :</td>

970

<td>

971

<code class="literal">TRUE</code> if the iter is valid, <code class="literal">FALSE</code> if the iter is invalid.</td>

972

</tr>

973

</tbody>

974

</table></div>

975

Since 2.2

976

</div>

977

<hr>

978

979

<a name="gtk-list-store-reorder"></a><h3>gtk_list_store_reorder ()</h3>

980

<pre class="programlisting">void gtk_list_store_reorder (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *store</code>,

981

<code>gint *new_order</code>);</pre>

982

983

Reorders <code>store</code> to follow the order indicated by <code>new_order</code>. Note that

984

this function only works with unsorted stores.

985

986

987

988

989

<col>

990

</colgroup>

991

<tbody>

992

<tr>

993

<td><code>store</code> :</td>

994

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>.</td>

995

</tr>

996

<tr>

997

<td><code>new_order</code> :</td>

998

<td>an array of integers mapping the new position of each child

999

to its old position before the re-ordering,

1000

i.e. <code>new_order</code><code class="literal">[newpos] = oldpos</code>. [<acronym title="Parameter points to an array of items.">array</acronym>]

1001

</td>

1002

</tr>

1003

</tbody>

1004

</table></div>

1005

Since 2.2

1006

</div>

1007

<hr>

1008

1009

<a name="gtk-list-store-swap"></a><h3>gtk_list_store_swap ()</h3>

1010

<pre class="programlisting">void gtk_list_store_swap (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *store</code>,

1011

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *a</code>,

1012

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *b</code>);</pre>

1013

1014

Swaps <code>a</code> and <code>b</code> in <code>store</code>. Note that this function only works with

1015

unsorted stores.

1016

1017

1018

1019

1020

<col>

1021

</colgroup>

1022

<tbody>

1023

<tr>

1024

<td><code>store</code> :</td>

1025

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>.</td>

1026

</tr>

1027

<tr>

1028

1029

<td>A <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a>.</td>

1030

</tr>

1031

<tr>

1032

1033

<td>Another <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a>.</td>

1034

</tr>

1035

</tbody>

1036

</table></div>

1037

Since 2.2

1038

</div>

1039

<hr>

1040

1041

<a name="gtk-list-store-move-before"></a><h3>gtk_list_store_move_before ()</h3>

1042

<pre class="programlisting">void gtk_list_store_move_before (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *store</code>,

1043

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

1044

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *position</code>);</pre>

1045

1046

Moves <code>iter</code> in <code>store</code> to the position before <code>position</code>. Note that this

1047

function only works with unsorted stores. If <code>position</code> is <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>, <code>iter</code>

1048

will be moved to the end of the list.

1049

1050

1051

1052

1053

<col>

1054

</colgroup>

1055

<tbody>

1056

<tr>

1057

<td><code>store</code> :</td>

1058

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>.</td>

1059

</tr>

1060

<tr>

1061

1062

<td>A <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a>.</td>

1063

</tr>

1064

<tr>

1065

<td><code>position</code> :</td>

1066

<td>A <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1067

</td>

1068

</tr>

1069

</tbody>

1070

</table></div>

1071

Since 2.2

1072

</div>

1073

<hr>

1074

1075

<a name="gtk-list-store-move-after"></a><h3>gtk_list_store_move_after ()</h3>

1076

<pre class="programlisting">void gtk_list_store_move_after (<code><a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a> *store</code>,

1077

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *iter</code>,

1078

<code><a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> *position</code>);</pre>

1079

1080

Moves <code>iter</code> in <code>store</code> to the position after <code>position</code>. Note that this

1081

1082

will be moved to the start of the list.

1083

1084

1085

1086

1087

<col>

1088

</colgroup>

1089

<tbody>

1090

<tr>

1091

<td><code>store</code> :</td>

1092

<td>A <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>.</td>

1093

</tr>

1094

<tr>

1095

1096

<td>A <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a>.</td>

1097

</tr>

1098

<tr>

1099

<td><code>position</code> :</td>

1100

<td>A <a class="link" href="GtkTreeModel.html#GtkTreeIter">GtkTreeIter</a> or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1101

</td>

1102

</tr>

1103

</tbody>

1104

</table></div>

1105

Since 2.2

1106

</div>

1107

</div>

1108

1109

1110

1111

<a class="link" href="GtkTreeModel.html" title="GtkTreeModel">GtkTreeModel</a>, <a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a>

1112

1113

</div>

1114

</div>

1115

1116

<hr>

1117

Generated by GTK-Doc V1.18</div>

1118

</body>

1119

</html>

b'\\ No newline at end of file'

Older »