~ubuntu-desktop/dee/ubuntu : revision 131.1.20

3

<head>

4

5

<title>DeeModel</title>

6

6

7

8

9

10

9

10

11

12

13

</head>

14

15

16

17

17

18

19

20

<th width="100%" align="center">Dee Reference Manual</th>

21

21

22

</tr>

23

24

40

41

#include <dee.h>

42

43

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> (<a class="link" href="dee-1.0-DeeModel.html#DeeCompareRowFunc" title="DeeCompareRowFunc ()">*DeeCompareRowFunc</a>) (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row1</code>,

44

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row2</code>,

45

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

43

46

struct <a class="link" href="dee-1.0-DeeModel.html#DeeModelIface" title="struct DeeModelIface">DeeModelIface</a>;

44

47

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a>;

45

48

<a class="link" href="dee-1.0-DeeModel.html#DeeModelTag" title="DeeModelTag">DeeModelTag</a>;

47

50

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

48

51

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-append-row" title="dee_model_append_row ()">dee_model_append_row</a> (<code>DeeModel *self</code>,

49

52

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row_members</code>);

50

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-append-valist" title="dee_model_append_valist ()">dee_model_append_valist</a> (<code>DeeModel *self</code>,

51

<code>va_list *args</code>);

52

53

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> ** <a class="link" href="dee-1.0-DeeModel.html#dee-model-build-row" title="dee_model_build_row ()">dee_model_build_row</a> (<code>DeeModel *self</code>,

53

54

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **out_row_members</code>,

54

55

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

55

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> ** <a class="link" href="dee-1.0-DeeModel.html#dee-model-build-row-valist" title="dee_model_build_row_valist ()">dee_model_build_row_valist</a> (<code>DeeModel *self</code>,

56

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **out_row_members</code>,

57

<code>va_list *args</code>);

58

56

void <a class="link" href="dee-1.0-DeeModel.html#dee-model-clear" title="dee_model_clear ()">dee_model_clear</a> (<code>DeeModel *self</code>);

59

57

void <a class="link" href="dee-1.0-DeeModel.html#dee-model-clear-tag" title="dee_model_clear_tag ()">dee_model_clear_tag</a> (<code>DeeModel *self</code>,

60

58

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

61

59

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelTag" title="DeeModelTag">DeeModelTag</a> *tag</code>);

60

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-find-row-sorted" title="dee_model_find_row_sorted ()">dee_model_find_row_sorted</a> (<code>DeeModel *self</code>,

61

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row_spec</code>,

62

<code><a class="link" href="dee-1.0-DeeModel.html#DeeCompareRowFunc" title="DeeCompareRowFunc ()">DeeCompareRowFunc</a> cmp_func</code>,

63

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

64

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> *out_was_found</code>);

65

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-find-sorted" title="dee_model_find_sorted ()">dee_model_find_sorted</a> (<code>DeeModel *self</code>,

66

<code><a class="link" href="dee-1.0-DeeModel.html#DeeCompareRowFunc" title="DeeCompareRowFunc ()">DeeCompareRowFunc</a> cmp_func</code>,

67

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

68

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> *out_was_found</code>,

69

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

62

70

void <a class="link" href="dee-1.0-DeeModel.html#dee-model-get" title="dee_model_get ()">dee_model_get</a> (<code>DeeModel *self</code>,

63

71

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

64

72

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

71

79

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

72

80

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);

73

81

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-first-iter" title="dee_model_get_first_iter ()">dee_model_get_first_iter</a> (<code>DeeModel *self</code>);

74

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32">gint32</a> <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-int32" title="dee_model_get_int32 ()">dee_model_get_int32</a> (<code>DeeModel *self</code>,

82

gint32 <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-int32" title="dee_model_get_int32 ()">dee_model_get_int32</a> (<code>DeeModel *self</code>,

75

83

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

76

84

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);

77

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64">gint64</a> <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-int64" title="dee_model_get_int64 ()">dee_model_get_int64</a> (<code>DeeModel *self</code>,

85

gint64 <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-int64" title="dee_model_get_int64 ()">dee_model_get_int64</a> (<code>DeeModel *self</code>,

78

86

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

79

87

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);

80

88

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-iter-at-row" title="dee_model_get_iter_at_row ()">dee_model_get_iter_at_row</a> (<code>DeeModel *self</code>,

98

106

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guchar">guchar</a> <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-uchar" title="dee_model_get_uchar ()">dee_model_get_uchar</a> (<code>DeeModel *self</code>,

99

107

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

100

108

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);

101

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a> <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-uint32" title="dee_model_get_uint32 ()">dee_model_get_uint32</a> (<code>DeeModel *self</code>,

102

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

103

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);

104

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-uint64" title="dee_model_get_uint64 ()">dee_model_get_uint64</a> (<code>DeeModel *self</code>,

105

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

106

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);

107

void <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-valist" title="dee_model_get_valist ()">dee_model_get_valist</a> (<code>DeeModel *self</code>,

108

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

109

<code>va_list args</code>);

109

guint32 <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-uint32" title="dee_model_get_uint32 ()">dee_model_get_uint32</a> (<code>DeeModel *self</code>,

110

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

111

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);

112

guint64 <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-uint64" title="dee_model_get_uint64 ()">dee_model_get_uint64</a> (<code>DeeModel *self</code>,

113

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

114

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);

110

115

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-get-value" title="dee_model_get_value ()">dee_model_get_value</a> (<code>DeeModel *self</code>,

111

116

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

112

117

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);

116

121

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-before" title="dee_model_insert_before ()">dee_model_insert_before</a> (<code>DeeModel *self</code>,

117

122

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

118

123

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

119

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-before-valist" title="dee_model_insert_before_valist ()">dee_model_insert_before_valist</a> (<code>DeeModel *self</code>,

120

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

121

<code>va_list *args</code>);

122

124

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-row" title="dee_model_insert_row ()">dee_model_insert_row</a> (<code>DeeModel *self</code>,

123

125

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> pos</code>,

124

126

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row_members</code>);

125

127

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-row-before" title="dee_model_insert_row_before ()">dee_model_insert_row_before</a> (<code>DeeModel *self</code>,

126

128

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

127

129

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row_members</code>);

128

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-valist" title="dee_model_insert_valist ()">dee_model_insert_valist</a> (<code>DeeModel *self</code>,

129

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> pos</code>,

130

<code>va_list *args</code>);

130

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-row-sorted" title="dee_model_insert_row_sorted ()">dee_model_insert_row_sorted</a> (<code>DeeModel *self</code>,

131

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row_members</code>,

132

<code><a class="link" href="dee-1.0-DeeModel.html#DeeCompareRowFunc" title="DeeCompareRowFunc ()">DeeCompareRowFunc</a> cmp_func</code>,

133

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);

134

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-sorted" title="dee_model_insert_sorted ()">dee_model_insert_sorted</a> (<code>DeeModel *self</code>,

135

<code><a class="link" href="dee-1.0-DeeModel.html#DeeCompareRowFunc" title="DeeCompareRowFunc ()">DeeCompareRowFunc</a> cmp_func</code>,

136

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

137

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

131

138

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="dee-1.0-DeeModel.html#dee-model-is-first" title="dee_model_is_first ()">dee_model_is_first</a> (<code>DeeModel *self</code>,

132

139

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>);

133

140

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="dee-1.0-DeeModel.html#dee-model-is-last" title="dee_model_is_last ()">dee_model_is_last</a> (<code>DeeModel *self</code>,

138

145

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

139

146

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-prepend-row" title="dee_model_prepend_row ()">dee_model_prepend_row</a> (<code>DeeModel *self</code>,

140

147

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row_members</code>);

141

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-prepend-valist" title="dee_model_prepend_valist ()">dee_model_prepend_valist</a> (<code>DeeModel *self</code>,

142

<code>va_list *args</code>);

143

148

<a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-prev" title="dee_model_prev ()">dee_model_prev</a> (<code>DeeModel *self</code>,

144

149

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>);

145

150

<a class="link" href="dee-1.0-DeeModel.html#DeeModelTag" title="DeeModelTag">DeeModelTag</a> * <a class="link" href="dee-1.0-DeeModel.html#dee-model-register-tag" title="dee_model_register_tag ()">dee_model_register_tag</a> (<code>DeeModel *self</code>,

157

162

void <a class="link" href="dee-1.0-DeeModel.html#dee-model-set-schema-full" title="dee_model_set_schema_full ()">dee_model_set_schema_full</a> (<code>DeeModel *self</code>,

158

163

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * const *column_schemas</code>,

159

164

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> num_columns</code>);

160

void <a class="link" href="dee-1.0-DeeModel.html#dee-model-set-schema-valist" title="dee_model_set_schema_valist ()">dee_model_set_schema_valist</a> (<code>DeeModel *self</code>,

161

<code>va_list *args</code>);

162

165

void <a class="link" href="dee-1.0-DeeModel.html#dee-model-set-tag" title="dee_model_set_tag ()">dee_model_set_tag</a> (<code>DeeModel *self</code>,

163

166

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

164

167

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelTag" title="DeeModelTag">DeeModelTag</a> *tag</code>,

165

168

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> value</code>);

166

void <a class="link" href="dee-1.0-DeeModel.html#dee-model-set-valist" title="dee_model_set_valist ()">dee_model_set_valist</a> (<code>DeeModel *self</code>,

167

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

168

<code>va_list *args</code>);

169

void <a class="link" href="dee-1.0-DeeModel.html#dee-model-set-value" title="dee_model_set_value ()">dee_model_set_value</a> (<code>DeeModel *self</code>,

170

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

171

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>,

202

203

204

205

<a name="dee-1.0-DeeModel.on_sorting"></a><h3>Sorting</h3>

206

207

As a simpler alternative to using indexes you can rely on sorted models.

208

This is done by using the <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-sorted" title="dee_model_insert_sorted ()"><code class="function">dee_model_insert_sorted()</code></a> and

209

<a class="link" href="dee-1.0-DeeModel.html#dee-model-find-sorted" title="dee_model_find_sorted ()"><code class="function">dee_model_find_sorted()</code></a> family of APIs. Some model classes have

210

accelerated implementations of sorted inserts and lookups.

211

Notably <a class="link" href="DeeSequenceModel.html" title="DeeSequenceModel">DeeSequenceModel</a>.

212

213

</div>

214

215

216

217

218

205

219

<a name="dee-1.0-DeeModel.on_tags"></a><h3>Tags - Attach Arbitrary Data to Rows</h3>

206

220

207

221

It's a very common pattern that you want to render a DeeModel into some

222

236

223

237

<a name="dee-1.0-DeeModel.details"></a><h2>Details</h2>

224

238

239

<a name="DeeCompareRowFunc"></a><h3>DeeCompareRowFunc ()</h3>

240

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> (*DeeCompareRowFunc) (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row1</code>,

241

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row2</code>,

242

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

243

244

Compares <code>row1</code> and <code>row2</code>. Mainly used with <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-sorted" title="dee_model_insert_sorted ()"><code class="function">dee_model_insert_sorted()</code></a> and

245

<a class="link" href="dee-1.0-DeeModel.html#dee-model-find-sorted" title="dee_model_find_sorted ()"><code class="function">dee_model_find_sorted()</code></a>.

246

247

248

249

<tbody>

250

<tr>

251

252

<td>The model being indexed</td>

253

</tr>

254

<tr>

255

256

<td>The row to extract terms for</td>

257

</tr>

258

<tr>

259

260

<td>User data to pass to comparison function. [<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.">closure</acronym>]

261

</td>

262

</tr>

263

<tr>

264

<td>Returns :</td>

265

<td>-1, 0, or 1 if <code>row1</code> is respectively less than, equal, or greater

266

than <code>row2</code>.</td>

267

</tr>

268

</tbody>

269

</table></div>

270

</div>

271

<hr>

272

225

273

<a name="DeeModelIface"></a><h3>struct DeeModelIface</h3>

226

274

<pre class="programlisting">struct DeeModelIface {

227

275

GTypeInterface g_iface;

264

312

DeeModelIter *iter,

265

313

GVariant **row_members);

266

314

315

DeeModelIter* (*insert_row_sorted) (DeeModel *self,

316

GVariant **row_members,

317

DeeCompareRowFunc cmp_func,

318

gpointer user_data);

319

320

DeeModelIter* (*find_row_sorted) (DeeModel *self,

321

GVariant **row_spec,

322

DeeCompareRowFunc cmp_func,

323

gpointer user_data,

324

gboolean *out_was_found);

325

267

326

void (*remove) (DeeModel *self,

268

327

DeeModelIter *iter);

269

328

434

493

</div>

435

494

<hr>

436

495

437

<a name="dee-model-append-valist"></a><h3>dee_model_append_valist ()</h3>

438

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_append_valist (<code>DeeModel *self</code>,

439

440

441

442

</div>

443

<hr>

444

445

496

<a name="dee-model-build-row"></a><h3>dee_model_build_row ()</h3>

446

497

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> ** dee_model_build_row (<code>DeeModel *self</code>,

447

498

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **out_row_members</code>,

483

534

</div>

484

535

<hr>

485

536

486

<a name="dee-model-build-row-valist"></a><h3>dee_model_build_row_valist ()</h3>

487

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> ** dee_model_build_row_valist (<code>DeeModel *self</code>,

488

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **out_row_members</code>,

489

490

491

492

</div>

493

<hr>

494

495

537

<a name="dee-model-clear"></a><h3>dee_model_clear ()</h3>

496

538

<pre class="programlisting">void dee_model_clear (<code>DeeModel *self</code>);</pre>

497

539

537

579

</div>

538

580

<hr>

539

581

582

<a name="dee-model-find-row-sorted"></a><h3>dee_model_find_row_sorted ()</h3>

583

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_find_row_sorted (<code>DeeModel *self</code>,

584

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row_spec</code>,

585

<code><a class="link" href="dee-1.0-DeeModel.html#DeeCompareRowFunc" title="DeeCompareRowFunc ()">DeeCompareRowFunc</a> cmp_func</code>,

586

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

587

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> *out_was_found</code>);</pre>

588

589

Finds a row in <code>self</code> according to the sorting specified by <code>cmp_func</code>.

590

This method will assume that <code>self</code> is already sorted by <code>cmp_func</code>.

591

592

593

If you use this method for searching you should only use

594

<a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-row-sorted" title="dee_model_insert_row_sorted ()"><code class="function">dee_model_insert_row_sorted()</code></a> to insert rows in the model.

595

596

597

598

<tbody>

599

<tr>

600

601

<td>The model to search</td>

602

</tr>

603

<tr>

604

605

<td>An array of

606

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariants</a> with type signature matching those of the

607

column schemas of <code>self</code>. No references will be taken on the variants. [<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1]

608

</td>

609

</tr>

610

<tr>

611

612

<td>Callback used for comparison or rows. [<acronym title="The callback is valid only during the call to the method.">scope call</acronym>]

613

</td>

614

</tr>

615

<tr>

616

617

<td>Arbitrary pointer passed to <code>cmp_func</code> during search. [<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.">closure</acronym>]

618

</td>

619

</tr>

620

<tr>

621

<td><code>out_was_found</code> :</td>

622

<td>A place to store a boolean value that will be set when

623

this method returns. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then an exact match was found.

624

If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> then the returned iter points to a row just after

625

where <code>row_spec</code> would have been inserted.

626

Pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

627

</td>

628

</tr>

629

<tr>

630

<td>Returns :</td>

631

<td>If <code>out_was_found</code> is set to

632

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then a <a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> pointing to the first matching row.

633

If it is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> then the iter pointing to the row just after where

634

<code>row_spec_would</code> have been inserted. [<acronym title="Don't free data after the code is done.">transfer none</acronym>][<acronym title="Override the parsed C type with given type">type</acronym> Dee.ModelIter]

635

</td>

636

</tr>

637

</tbody>

638

</table></div>

639

</div>

640

<hr>

641

642

<a name="dee-model-find-sorted"></a><h3>dee_model_find_sorted ()</h3>

643

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_find_sorted (<code>DeeModel *self</code>,

644

<code><a class="link" href="dee-1.0-DeeModel.html#DeeCompareRowFunc" title="DeeCompareRowFunc ()">DeeCompareRowFunc</a> cmp_func</code>,

645

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

646

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> *out_was_found</code>,

647

648

649

Finds a row in <code>self</code> according to the sorting specified by <code>cmp_func</code>.

650

This method will assume that <code>self</code> is already sorted by <code>cmp_func</code>.

651

652

653

If you use this method for searching you should only use

654

<a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-row-sorted" title="dee_model_insert_row_sorted ()"><code class="function">dee_model_insert_row_sorted()</code></a> to insert rows in the model.

655

656

657

658

<tbody>

659

<tr>

660

661

<td>The model to search</td>

662

</tr>

663

<tr>

664

665

<td>Callback used for comparison or rows. [<acronym title="The callback is valid only during the call to the method.">scope call</acronym>]

666

</td>

667

</tr>

668

<tr>

669

670

<td>Arbitrary pointer passed to <code>cmp_func</code> during search. [<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.">closure</acronym>]

671

</td>

672

</tr>

673

<tr>

674

<td><code>out_was_found</code> :</td>

675

<td>A place to store a boolean value that will be set when

676

this method returns. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then an exact match was found.

677

If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> then the returned iter points to a row just after

678

where <code>row_spec</code> would have been inserted.

679

Pass <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

680

</td>

681

</tr>

682

<tr>

683

<td>Returns :</td>

684

<td>If <code>out_was_found</code> is set to

685

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then a <a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> pointing to the first matching row.

686

If it is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> then the iter pointing to the row just after where

687

<code>row_spec_would</code> have been inserted. [<acronym title="Don't free data after the code is done.">transfer none</acronym>][<acronym title="Override the parsed C type with given type">type</acronym> Dee.ModelIter]

688

</td>

689

</tr>

690

</tbody>

691

</table></div>

692

</div>

693

<hr>

694

540

695

<a name="dee-model-get"></a><h3>dee_model_get ()</h3>

541

696

<pre class="programlisting">void dee_model_get (<code>DeeModel *self</code>,

542

697

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

706

861

<hr>

707

862

708

863

<a name="dee-model-get-int32"></a><h3>dee_model_get_int32 ()</h3>

709

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32">gint32</a> dee_model_get_int32 (<code>DeeModel *self</code>,

864

<pre class="programlisting">gint32 dee_model_get_int32 (<code>DeeModel *self</code>,

710

865

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

711

866

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);</pre>

712

867

737

892

<hr>

738

893

739

894

<a name="dee-model-get-int64"></a><h3>dee_model_get_int64 ()</h3>

740

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64">gint64</a> dee_model_get_int64 (<code>DeeModel *self</code>,

895

<pre class="programlisting">gint64 dee_model_get_int64 (<code>DeeModel *self</code>,

741

896

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

742

897

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);</pre>

743

898

773

928

774

929

Retrieves a <a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> representing the row at the given index.

775

930

931

932

Note that this method does not have any performance guarantees. In particular

933

it is not guaranteed to be O(1).

934

776

935

777

936

778

937

<tbody>

799

958

<a name="dee-model-get-last-iter"></a><h3>dee_model_get_last_iter ()</h3>

800

959

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_get_last_iter (<code>DeeModel *self</code>);</pre>

801

960

802

Retrieves a <a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> representing the last row in <code>self</code>.

961

Retrieves a <a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> pointing right after the

962

last row in <code>self</code>. This is refered to also the the

963

end iter.

964

965

966

As with other iters the end iter, in particular, is stable over inserts,

967

changes, or removals.

803

968

804

969

805

970

869

1034

<a name="dee-model-get-position"></a><h3>dee_model_get_position ()</h3>

870

1035

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> dee_model_get_position (<code>DeeModel *self</code>,

871

1036

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>);</pre>

1037

1038

Get the numeric offset of <code>iter</code> into <code>self</code>. Note that this method is

1039

not guaranteed to be O(1).

1040

872

1041

873

1042

874

1043

<tbody>

1044

<tr>

1045

1046

<td>The model to inspect</td>

1047

</tr>

1048

<tr>

1049

1050

<td>The iter to get the position of</td>

1051

</tr>

1052

<tr>

875

1053

<td>Returns :</td>

876

1054

<td>The integer offset of <code>iter</code> in <code>self</code>

877

1055

</td>

878

</tr></tbody>

1056

</tr>

1057

</tbody>

879

1058

</table></div>

880

1059

</div>

881

1060

<hr>

897

1076

</tr>

898

1077

<tr>

899

1078

<td><code>out_row_members</code> :</td>

900

<td>An array

901

of variants with a length bigger than or equal to

1079

<td>An array of variants with a length bigger than or equal to

902

1080

the number of columns in <code>self</code>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. If you pass

903

1081

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> here a new array will be allocated for you. The

904

returned variants will have a non-floating reference. [<acronym title="Parameter points to an array of items.">array</acronym>][<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]

1082

returned variants will have a non-floating reference. [<acronym title="Parameter points to an array of items.">array</acronym>][<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>][<acronym title="Default parameter value (for in case the shadows-to function has less parameters).">default</acronym> NULL]

905

1083

</td>

906

1084

</tr>

907

1085

<tr>

908

1086

<td>Returns :</td>

909

1087

<td>

910

<code>out_row_members</code> if it was not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or a newly allocated array

911

otherwise which you must free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. The variants in the

912

array will have a strong reference and needs to be freed with

913

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>.</td>

1088

<code>out_row_members</code> if it was not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1089

or a newly allocated array otherwise which you must free

1090

with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. The variants in the array will have a strong

1091

reference and needs to be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#g-variant-unref"><code class="function">g_variant_unref()</code></a>. [<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1]

1092

</td>

914

1093

</tr>

915

1094

</tbody>

916

1095

</table></div>

939

1118

</tr>

940

1119

<tr>

941

1120

<td>Returns :</td>

942

<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated

943

array of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> type strings. The length of

1121

<td>A <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of <a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> type strings. The length of

944

1122

the returned array is written to <code>num_columns</code>. The returned array

945

should not be freed or modified. It is owned by the model. [<acronym title="Parameter points to an array of items.">array</acronym>][<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> utf8][<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1123

should not be freed or modified. It is owned by the model. [<acronym title="Parameter points to an array of items.">array</acronym> length=num_columns][<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> utf8][<acronym title="Don't free data after the code is done.">transfer none</acronym>]

946

1124

</td>

947

1125

</tr>

948

1126

</tbody>

1047

1225

<hr>

1048

1226

1049

1227

<a name="dee-model-get-uint32"></a><h3>dee_model_get_uint32 ()</h3>

1050

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a> dee_model_get_uint32 (<code>DeeModel *self</code>,

1228

<pre class="programlisting">guint32 dee_model_get_uint32 (<code>DeeModel *self</code>,

1051

1229

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

1052

1230

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);</pre>

1053

1231

1078

1256

<hr>

1079

1257

1080

1258

<a name="dee-model-get-uint64"></a><h3>dee_model_get_uint64 ()</h3>

1081

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> dee_model_get_uint64 (<code>DeeModel *self</code>,

1259

<pre class="programlisting">guint64 dee_model_get_uint64 (<code>DeeModel *self</code>,

1082

1260

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

1083

1261

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> column</code>);</pre>

1084

1262

1108

1286

</div>

1109

1287

<hr>

1110

1288

1111

<a name="dee-model-get-valist"></a><h3>dee_model_get_valist ()</h3>

1112

<pre class="programlisting">void dee_model_get_valist (<code>DeeModel *self</code>,

1113

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

1114

1115

1116

1117

</div>

1118

<hr>

1119

1120

1289

<a name="dee-model-get-value"></a><h3>dee_model_get_value ()</h3>

1121

1290

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> * dee_model_get_value (<code>DeeModel *self</code>,

1122

1291

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

1232

1401

</div>

1233

1402

<hr>

1234

1403

1235

<a name="dee-model-insert-before-valist"></a><h3>dee_model_insert_before_valist ()</h3>

1236

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_insert_before_valist (<code>DeeModel *self</code>,

1237

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

1238

1239

1240

1241

</div>

1242

<hr>

1243

1244

1404

<a name="dee-model-insert-row"></a><h3>dee_model_insert_row ()</h3>

1245

1405

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_insert_row (<code>DeeModel *self</code>,

1246

1406

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> pos</code>,

1321

1481

</div>

1322

1482

<hr>

1323

1483

1324

<a name="dee-model-insert-valist"></a><h3>dee_model_insert_valist ()</h3>

1325

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_insert_valist (<code>DeeModel *self</code>,

1326

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> pos</code>,

1327

1328

1329

1484

<a name="dee-model-insert-row-sorted"></a><h3>dee_model_insert_row_sorted ()</h3>

1485

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_insert_row_sorted (<code>DeeModel *self</code>,

1486

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariant</a> **row_members</code>,

1487

<code><a class="link" href="dee-1.0-DeeModel.html#DeeCompareRowFunc" title="DeeCompareRowFunc ()">DeeCompareRowFunc</a> cmp_func</code>,

1488

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

1489

1490

Inserts a row in <code>self</code> according to the sorting specified by <code>cmp_func</code>.

1491

If you use this method for insertion you should not use other methods as this

1492

method assumes the model to be already sorted by <code>cmp_func</code>.

1493

1494

1495

1496

<tbody>

1497

<tr>

1498

1499

<td>The model to do a sorted insert on</td>

1500

</tr>

1501

<tr>

1502

<td><code>row_members</code> :</td>

1503

<td>An array of

1504

<a href="http://library.gnome.org/devel/glib/unstable/glib-GVariant.html#GVariant">GVariants</a> with type signature matching those of the

1505

column schemas of <code>self</code>. If any of the variants have floating

1506

references they will be consumed. [<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1]

1507

</td>

1508

</tr>

1509

<tr>

1510

1511

<td>Callback used for comparison or rows. [<acronym title="The callback is valid only during the call to the method.">scope call</acronym>]

1512

</td>

1513

</tr>

1514

<tr>

1515

1516

<td>Arbitrary pointer passed to <code>cmp_func</code> during search. [<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.">closure</acronym>]

1517

</td>

1518

</tr>

1519

<tr>

1520

<td>Returns :</td>

1521

<td>A <a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> pointing to the new row. [<acronym title="Don't free data after the code is done.">transfer none</acronym>][<acronym title="Override the parsed C type with given type">type</acronym> Dee.ModelIter]

1522

</td>

1523

</tr>

1524

</tbody>

1525

</table></div>

1526

</div>

1527

<hr>

1528

1529

<a name="dee-model-insert-sorted"></a><h3>dee_model_insert_sorted ()</h3>

1530

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_insert_sorted (<code>DeeModel *self</code>,

1531

<code><a class="link" href="dee-1.0-DeeModel.html#DeeCompareRowFunc" title="DeeCompareRowFunc ()">DeeCompareRowFunc</a> cmp_func</code>,

1532

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>,

1533

1534

1535

Convenience function for calling <a class="link" href="dee-1.0-DeeModel.html#dee-model-insert-row-sorted" title="dee_model_insert_row_sorted ()"><code class="function">dee_model_insert_row_sorted()</code></a>.

1536

Inserts a row in <code>self</code> according to the sorting specified by <code>cmp_func</code>.

1537

If you use this method for insertion you should not use other methods as this

1538

method assumes the model to be already sorted by <code>cmp_func</code>.

1539

1540

1541

1542

<tbody>

1543

<tr>

1544

1545

<td>The model to do a sorted insert on</td>

1546

</tr>

1547

<tr>

1548

1549

<td>Callback used for comparison or rows. [<acronym title="The callback is valid only during the call to the method.">scope call</acronym>]

1550

</td>

1551

</tr>

1552

<tr>

1553

1554

<td>Arbitrary pointer passed to <code>cmp_func</code> during search. [<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.">closure</acronym>]

1555

</td>

1556

</tr>

1557

<tr>

1558

<td>Returns :</td>

1559

<td>A <a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> pointing to the new row. [<acronym title="Don't free data after the code is done.">transfer none</acronym>][<acronym title="Override the parsed C type with given type">type</acronym> Dee.ModelIter]

1560

</td>

1561

</tr>

1562

</tbody>

1563

</table></div>

1330

1564

</div>

1331

1565

<hr>

1332

1566

1334

1568

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> dee_model_is_first (<code>DeeModel *self</code>,

1335

1569

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>);</pre>

1336

1570

1337

Where <code>iter</code> is at the start of <code>self</code>.

1571

Checks if <code>iter</code> is the very first iter <code>self</code>.

1338

1572

1339

1573

1340

1574

1363

1597

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> dee_model_is_last (<code>DeeModel *self</code>,

1364

1598

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>);</pre>

1365

1599

1366

Whether <code>iter</code> is at the end of <code>self</code>.

1600

Whether <code>iter</code> is the end iter of <code>self</code>. Note that the end iter points

1601

right after the last valid row in <code>self</code>.

1367

1602

1368

1603

1369

1604

1484

1719

</div>

1485

1720

<hr>

1486

1721

1487

<a name="dee-model-prepend-valist"></a><h3>dee_model_prepend_valist ()</h3>

1488

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_prepend_valist (<code>DeeModel *self</code>,

1489

1490

1491

1492

</div>

1493

<hr>

1494

1495

1722

<a name="dee-model-prev"></a><h3>dee_model_prev ()</h3>

1496

1723

<pre class="programlisting"><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> * dee_model_prev (<code>DeeModel *self</code>,

1497

1724

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>);</pre>

1730

1957

</div>

1731

1958

<hr>

1732

1959

1733

<a name="dee-model-set-schema-valist"></a><h3>dee_model_set_schema_valist ()</h3>

1734

<pre class="programlisting">void dee_model_set_schema_valist (<code>DeeModel *self</code>,

1735

1736

1737

Like <a class="link" href="dee-1.0-DeeModel.html#dee-model-set-schema" title="dee_model_set_schema ()"><code class="function">dee_model_set_schema()</code></a> but for language bindings.

1738

1739

1740

1741

1742

1743

<td>The DeeModel to change</td>

1744

</tr></tbody>

1745

</table></div>

1746

</div>

1747

<hr>

1748

1749

1960

<a name="dee-model-set-tag"></a><h3>dee_model_set_tag ()</h3>

1750

1961

<pre class="programlisting">void dee_model_set_tag (<code>DeeModel *self</code>,

1751

1962

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

1784

1995

</div>

1785

1996

<hr>

1786

1997

1787

<a name="dee-model-set-valist"></a><h3>dee_model_set_valist ()</h3>

1788

<pre class="programlisting">void dee_model_set_valist (<code>DeeModel *self</code>,

1789

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,

1790

1791

1792

1793

</div>

1794

<hr>

1795

1796

1998

<a name="dee-model-set-value"></a><h3>dee_model_set_value ()</h3>

1797

1999

<pre class="programlisting">void dee_model_set_value (<code>DeeModel *self</code>,

1798

2000

<code><a class="link" href="dee-1.0-DeeModel.html#DeeModelIter" title="DeeModelIter">DeeModelIter</a> *iter</code>,