Xlib â C Language X Interface

More documents

Recommendations

Info

<strong>Xlib</strong> − C LibraryX11, Release 6.7 DRAFT#define XrmStringToNameList(str, name) XrmStringToQuarkList((str), (name))#define XrmStringToClassList(str, class) XrmStringToQuarkList((str), (class))void XrmStringToQuarkList (string, quarks_return)char *string;XrmQuarkList quarks_return;stringquarks_returnSpecifies the string for which a quark list is to be allocated.Returns the list of quarks. The caller must allocate sufficient space for the quarkslist before calling XrmStringToQuarkList.The XrmStringToQuarkList function converts the null-terminated string (generally a fully qualifiedname) to a list of quarks. Note that the string must be in the valid ResourceName format(see section 15.1). If the string is not in the Host Portable Character Encoding, the conversion isimplementation-dependent.Abinding list is a list of type XrmBindingList and indicates if components of name or class listsare bound tightly or loosely (that is, if wildcarding of intermediate components is specified).typedef enum {XrmBindTightly, XrmBindLoosely} XrmBinding, *XrmBindingList;XrmBindTightly indicates that a period separates the components, and XrmBindLoosely indicatesthat an asterisk separates the components.To convert a string with one or more components to a binding list and a quark list, use Xrm-StringToBindingQuarkList.XrmStringToBindingQuarkList (string, bindings_return, quarks_return)char *string;XrmBindingList bindings_return;XrmQuarkList quarks_return;stringSpecifies the string for which a quark list is to be allocated.bindings_returnReturns the binding list. The caller must allocate sufficient space for the bindinglist before calling XrmStringToBindingQuarkList.quarks_returnReturns the list of quarks. The caller must allocate sufficient space for the quarkslist before calling XrmStringToBindingQuarkList.Component names in the list are separated by a period or an asterisk character. The string mustbe in the format of a valid ResourceName (see section 15.1). If the string does not start with aperiod or an asterisk, a tight binding is assumed. For example, the string ‘‘*a.b*c’’ becomes:quarks: a b cbindings: loose tight loose15.4. Creating and Storing DatabasesAresource database is an opaque type, XrmDatabase. Each database value is stored in an Xrm-Value structure. This structure consists of a size, an address, and a representation type. The size387
<strong>Xlib</strong> − C LibraryX11, Release 6.7 DRAFTis specified in bytes. The representation type is a way for you to store data tagged by some application-definedtype (for example, the strings ‘‘font’’ or‘‘color’’). It has nothing to do with the Cdata type or with its class. The XrmValue structure is defined as:typedef struct {unsigned int size;XPointer addr;}XrmValue, *XrmValuePtr;To initialize the resource manager, use XrmInitialize.void XrmInitialize();To retrieve a database from disk, use XrmGetFileDatabase.XrmDatabase XrmGetFileDatabase(filename)char *filename;filenameSpecifies the resource database file name.The XrmGetFileDatabase function opens the specified file, creates a new resource database, andloads it with the specifications read in from the specified file. The specified file should contain asequence of entries in valid ResourceLine format (see section 15.1); the database that results fromreading a file with incorrect syntax is implementation-dependent. The file is parsed in the currentlocale, and the database is created in the current locale. If it cannot open the specified file,XrmGetFileDatabase returns NULL.To store a copy ofadatabase to disk, use XrmPutFileDatabase.void XrmPutFileDatabase(database, stored_db)XrmDatabase database;char *stored_db;databasestored_dbSpecifies the database that is to be used.Specifies the file name for the stored database.The XrmPutFileDatabase function stores a copy ofthe specified database in the specified file.Te xtiswritten to the file as a sequence of entries in valid ResourceLine format (see section 15.1).The file is written in the locale of the database. Entries containing resource names that are not inthe Host Portable Character Encoding or containing values that are not in the encoding of thedatabase locale, are written in an implementation-dependent manner. The order in which entriesare written is implementation-dependent. Entries with representation types other than ‘‘String’’are ignored.To obtain a pointer to the screen-independent resources of a display, use XResourceManager-String.388
Page 3 and 4:
AcknowledgmentsThe design and imple
Page 5 and 6:
Release 6Stephen Gildea (X Consorti
Page 7 and 8:
Xlib − C LibraryX11, Release 6.7
Page 9 and 10:
Page 11 and 12:
Page 13 and 14:
Page 15 and 16:
Page 17 and 18:
Page 19 and 20:
Page 21 and 22:
Page 23 and 24:
Page 25 and 26:
Page 27 and 28:
Page 29 and 30:
Page 31 and 32:
Page 33 and 34:
Page 35 and 36:
Page 37 and 38:
Page 39 and 40:
Page 41 and 42:
Page 43 and 44:
Page 45 and 46:
Page 47 and 48:
Page 49 and 50:
Page 51 and 52:
Page 53 and 54:
Page 55 and 56:
Page 57 and 58:
Page 59 and 60:
Page 61 and 62:
Page 63 and 64:
Page 65 and 66:
Page 67 and 68:
Page 69 and 70:
Page 71 and 72:
Page 73 and 74:
Page 75 and 76:
Page 77 and 78:
Page 79 and 80:
Page 81 and 82:
Page 83 and 84:
Page 85 and 86:
Page 87 and 88:
Page 89 and 90:
Page 91 and 92:
Page 93 and 94:
Page 95 and 96:
Page 97 and 98:
Page 99 and 100:
Page 101 and 102:
Page 103 and 104:
Page 105 and 106:
Page 107 and 108:
Page 109 and 110:
Page 111 and 112:
Page 113 and 114:
Page 115 and 116:
Page 117 and 118:
Page 119 and 120:
Page 121 and 122:
Page 123 and 124:
Page 125 and 126:
Page 127 and 128:
Page 129 and 130:
Page 131 and 132:
Page 133 and 134:
Page 135 and 136:
Page 137 and 138:
Page 139 and 140:
Page 141 and 142:
Page 143 and 144:
Page 145 and 146:
Page 147 and 148:
Page 149 and 150:
Page 151 and 152:
Page 153 and 154:
Page 155 and 156:
Page 157 and 158:
Page 159 and 160:
Page 161 and 162:
Page 163 and 164:
Page 165 and 166:
Page 167 and 168:
Page 169 and 170:
Page 171 and 172:
Page 173 and 174:
Page 175 and 176:
Page 177 and 178:
Page 179 and 180:
Page 181 and 182:
Page 183 and 184:
Page 185 and 186:
Page 187 and 188:
Page 189 and 190:
Page 191 and 192:
Page 193 and 194:
Page 195 and 196:
Page 197 and 198:
Page 199 and 200:
Page 201 and 202:
Page 203 and 204:
Page 205 and 206:
Page 207 and 208:
Page 209 and 210:
Page 211 and 212:
Page 213 and 214:
Page 215 and 216:
Page 217 and 218:
Page 219 and 220:
Page 221 and 222:
Page 223 and 224:
Page 225 and 226:
Page 227 and 228:
Page 229 and 230:
Page 231 and 232:
Page 233 and 234:
Page 235 and 236:
Page 237 and 238:
Page 239 and 240:
Page 241 and 242:
Page 243 and 244:
Page 245 and 246:
Page 247 and 248:
Page 249 and 250:
Page 251 and 252:
Page 253 and 254:
Page 255 and 256:
Page 257 and 258:
Page 259 and 260:
Page 261 and 262:
Page 263 and 264:
Page 265 and 266:
Page 267 and 268:
Page 269 and 270:
Page 271 and 272:
Page 273 and 274:
Page 275 and 276:
Page 277 and 278:
Page 279 and 280:
Page 281 and 282:
Page 283 and 284:
Page 285 and 286:
Page 287 and 288:
Page 289 and 290:
Page 291 and 292:
Page 293 and 294:
Page 295 and 296:
Page 297 and 298:
Page 299 and 300:
Page 301 and 302:
Page 303 and 304:
Page 305 and 306:
Page 307 and 308:
Page 309 and 310:
Page 311 and 312:
Page 313 and 314:
Page 315 and 316:
Page 317 and 318:
Page 319 and 320:
Page 321 and 322:
Page 323 and 324:
Page 325 and 326:
Page 327 and 328:
Page 329 and 330:
Page 331 and 332:
Page 333 and 334:
Page 335 and 336:
Page 337 and 338:
Page 339 and 340:
Page 341 and 342: Xlib − C LibraryX11, Release 6.7
Page 391: Xlib − C LibraryX11, Release 6.7
Page 443 and 444:
Page 445 and 446:
Page 447 and 448:
Page 449 and 450:
Page 451 and 452:
Page 453 and 454:
Page 455 and 456:
Page 457 and 458:
Page 459 and 460:
Page 461 and 462:
Page 463 and 464:
Page 465 and 466:
Page 467 and 468:
Page 469 and 470:
Page 471 and 472:
Page 473 and 474:
Page 475 and 476:
Page 477 and 478:
Page 479 and 480:
Page 481 and 482:
Page 483 and 484:
Page 485 and 486:
Page 487 and 488:
Page 489 and 490:
Page 491 and 492:
Page 493 and 494:
Page 495 and 496:
4.2. Translating Screen Coordinates
Page 497 and 498:
10.7. Input Focus Events . . . . .
Page 499 and 500:
13.5.6.1. Input Style . . . . . . .
show all

Xlib â C Language X Interface

Create successful ePaper yourself

Delete template?

Save as template?

Xlib â C Language X Interface