The Official GNOME 2 Developer's Guide

Table of Contents......Page 2
The Official GNOME 2 Developer\'s Guide......Page 9
Foreword......Page 11
Preface to the Original Edition......Page 13
Preface to the English Edition......Page 15
 Limits......Page 16
Platform......Page 17
Pointers and Addresses......Page 18
1.3 Basic Types......Page 19
1.4 Basic Utilities......Page 20
 1.4.1 Memory Management......Page 21
 1.4.2 Quarks......Page 24
 1.4.3 C Strings......Page 25
 1.4.4 Unicode and Character Encodings......Page 28
 1.4.5 Timer......Page 34
 1.4.6 Message Logging......Page 36
 1.4.7 Debugging Functions......Page 38
 1.4.8 Exception Handling with Error Reporting......Page 39
 1.5.1 Strings......Page 43
 1.5.2 Lists......Page 46
 1.5.3 Arrays......Page 52
 1.5.4 Trees......Page 55
 1.5.6 Creating Hash Tables......Page 60
1.6 Further Topics......Page 64
 2.1.1 Objects as Instances of Classes......Page 66
 2.1.2 Inheritance......Page 67
 2.2.1 Structure Definitions......Page 70
 2.2.2 Utility Macros......Page 71
 2.2.3 Initializing Type Identifiers......Page 73
 2.2.4 The Base Class: GObject......Page 75
2.4 Properties......Page 77
 2.4.1 Declaring Parameters......Page 78
 2.4.2 Tangent: Generic Containers for Values......Page 80
 2.4.3 Installing Properties......Page 81
2.5 Using Objects......Page 85
 2.5.1 Using Properties......Page 86
 2.5.2 Strong and Weak Object References......Page 87
2.6 Signals......Page 88
 2.6.1 Defining Signals and Installing Handlers......Page 89
 2.6.2 Emitting Signals......Page 91
 2.6.3 Marshallers......Page 92
 2.6.4 Signal Accumulators......Page 95
 2.6.5 Attaching Handlers to Signals......Page 96
 2.6.6 Details......Page 97
 2.6.7 Emission Hooks......Page 98
 2.6.8 More Signal Utilities......Page 100
2.7 Inheritance......Page 101
 2.7.1 Interfaces......Page 106
2.8 Further Topics......Page 110
 3.1 What Is GTK+?......Page 111
 3.1.1 Widgets and Containers......Page 112
 3.1.3 An Elementary Example......Page 113
 3.1.5 Methods......Page 117
 3.1.7 Signals......Page 118
3.2 Windows......Page 119
3.3 Display Widgets......Page 120
 3.3.1 Labels and Pango Markup......Page 124
 3.3.2 Images and GDK Pixbufs......Page 126
 3.3.3 Progress Bars......Page 133
3.4 Container and Layout Widgets......Page 134
 3.4.1 Boxes......Page 139
 3.4.2 Tables......Page 141
 3.4.3 Paned Widgets......Page 142
 3.4.4 Notebooks......Page 143
 3.4.6 Sensible Widget Arrangement......Page 144
3.5 Button Widgets......Page 145
3.6 Data Entry Widgets......Page 149
 3.6.2 Entry Boxes......Page 154
 3.6.3 Combo Boxes......Page 156
 3.6.5 Slider Widgets......Page 157
 3.6.6 Spin Button Widgets......Page 158
 3.6.7 Color Chooser Widgets......Page 159
 3.6.9 File Browsers......Page 160
 3.6.10 Chooser Examples......Page 161
3.7 Dividers and Decorations......Page 165
 3.7.2 Separators......Page 167
 3.8.1 Tooltips......Page 168
 3.8.2 Keyboard Operation......Page 170
3.9 Scrolling......Page 172
 3.9.1 Scrolled Window Properties......Page 174
3.10 Dialogs......Page 175
3.11 Tree and List Widgets......Page 179
 3.11.1 List and Tree API Reference......Page 183
 3.11.2 Tree Views......Page 188
 3.11.3 Selecting Rows......Page 194
 3.11.4 An Extended Example......Page 197
3.12 Text......Page 202
 3.12.1 Text Buffers......Page 209
 3.12.2 Text View Widgets......Page 224
3.13 Further Topics......Page 226
 4.1.1 \"Take This GNOME and Shove It\"......Page 228
 4.2.1 Initializing GNOME......Page 229
 4.2.2 Utility Functions......Page 231
 4.2.3 Sound......Page 236
4.3 Libgnomeui......Page 237
 4.3.1 Application Windows......Page 238
 4.3.2 Context Menus......Page 248
 4.3.3 Enhanced Data Entry Widgets......Page 249
 4.3.4 Text Entry Widgets with History......Page 254
 4.3.5 File Choosers......Page 255
 4.3.6 Font Pickers......Page 256
 4.3.8 Icon Pickers......Page 257
 4.3.10 Date/Time Widgets......Page 258
 4.3.11 Hyperlinks......Page 259
 4.3.12 High Scores......Page 261
 4.3.13 About (Credits) Windows......Page 262
 4.3.15 Druids......Page 264
 4.3.16 Session Management......Page 274
4.4 Further Topics......Page 278
 5.1.1 Create a Project......Page 279
 5.1.3 Property Editor......Page 280
 5.1.5 Clipboard......Page 286
5.2 Using the Interface......Page 287
 5.2.2 Accessing Widgets......Page 290
 5.2.3 Automatically Attaching Signals......Page 291
 5.2.5 The Complete Temperature Converter......Page 292
5.3 Further Topics......Page 295
 6.1 pkg-config......Page 296
 6.1.1 Package Lists, Versions, and Descriptions......Page 297
6.2 The GNU Autotools......Page 298
 6.2.1 Overview......Page 299
 6.2.2 configure.ac......Page 300
 6.2.3 Makefile Templates......Page 302
 6.2.4 Extra Tools......Page 304
 6.2.9 configure......Page 305
6.3 Menu Items......Page 306
 6.4.1 Installing Documentation......Page 308
6.5 Supporting Locale Options with gettext and intltool......Page 309
 6.5.1 intltool......Page 311
7.1 Overview......Page 312
 7.2.1 Configuration Database Keys and Values......Page 313
 7.2.3 gconftool-2......Page 314
 7.3.1 Initializing and Finalizing GConf......Page 318
 7.3.2 Reading and Writing GConf Values......Page 319
 7.3.3 GConf Value Change Notification......Page 328
 7.3.5 Error Handling......Page 329
 7.3.6 Schemas......Page 331
 7.3.7 A Complete Example......Page 333
7.4 Further Topics......Page 338
 8.1 Transparency with URIs......Page 339
8.2 Initializing and Shutting Down GnomeVFS......Page 340
8.3 Synchronous Access......Page 341
 8.3.1 Opening, Creating, and Closing Files......Page 344
 8.3.2 Reading, Writing, and Seeking......Page 345
 8.3.3 Extracting and Changing File Information......Page 346
 8.3.4 File Management......Page 349
 8.4.1 Directory Navigation......Page 350
8.5 Asynchronous I/O......Page 352
 8.5.1 Opening and Closing Files......Page 353
 8.5.3 Retrieving and Setting File Information......Page 354
 8.5.4 Miscellaneous Operations......Page 355
 8.5.5 An Example......Page 357
8.6 Transfers......Page 367
 Step 2:......Page 368
 8.6.1 Additional Transfer Functions......Page 369
8.7 File Types......Page 370
 8.7.1 Declaring MIME Types......Page 372
 8.7.2 Declaring Application Support for a MIME Type......Page 373
 8.8.1 Building URI Paths......Page 374
 8.8.2 Extracting Path Information from a URI......Page 375
 8.8.3 Accessing URI Connection Information......Page 376
8.10 Result/Error Codes......Page 377
8.12 File Information Example......Page 379
8.13 Further Topics......Page 383
 9.1.2 WWW......Page 384
 9.1.3 Mailing Lists......Page 387
 9.2.2 Toolbars......Page 388
 9.2.8 System Sound......Page 389
9.3 Conclusion......Page 390
 GTK+ Stock Items......Page 391
GNOME Stock Items......Page 396
A......Page 398
C......Page 399
D......Page 400
F......Page 401
G......Page 402
I......Page 403
L......Page 404
M......Page 405
P......Page 406
S......Page 407
U......Page 408
X......Page 409
Appendix C: Bibliography......Page 411
GARNOME......Page 413
CVS......Page 414
Conventional Source Archives......Page 415
 License......Page 417
 Chapter 5: Glade and Libglade......Page 421
 Chapter 8: GnomeVFS......Page 422