Xlib â C Language X Interface

More documents

Recommendations

Info

Xlib − C LibraryX11, Release 6.7 DRAFThaving the property stored in the X server, the property is maintained by some client (the owner).Aselection is global in nature (considered to belong to the user but be maintained by clients)rather than being private to a particular window subhierarchy oraparticular set of clients.Xlib provides functions that you can use to set, get, or request conversion of selections. Thisallows applications to implement the notion of current selection, which requires that notificationbe sent to applications when they nolonger own the selection. Applications that support selectionoften highlight the current selection and so must be informed when another application hasacquired the selection so that they can unhighlight the selection.When a client asks for the contents of a selection, it specifies a selection target type. This targettype can be used to control the transmitted representation of the contents. For example, if theselection is ‘‘the last thing the user clicked on’’ and that is currently an image, then the target typemight specify whether the contents of the image should be sent in XY format or Z format.The target type can also be used to control the class of contents transmitted, for example, askingfor the ‘‘looks’’ (fonts, line spacing, indentation, and so forth) of a paragraph selection, not thetext of the paragraph. The target type can also be used for other purposes. The protocol does notconstrain the semantics.To set the selection owner, use XSetSelectionOwner.XSetSelectionOwner (display, selection, owner, time)Display *display;Atom selection;Window owner;Time time;displayselectionownertimeSpecifies the connection to the X server.Specifies the selection atom.Specifies the owner of the specified selection atom. Youcan pass a window orNone.Specifies the time. Youcan pass either a timestamp or CurrentTime.The XSetSelectionOwner function changes the owner and last-change time for the specifiedselection and has no effect if the specified time is earlier than the current last-change time of thespecified selection or is later than the current X server time. Otherwise, the last-change time isset to the specified time, with CurrentTime replaced by the current server time. If the ownerwindow isspecified as None, then the owner of the selection becomes None (that is, no owner).Otherwise, the owner of the selection becomes the client executing the request.If the new owner (whether a client or None) isnot the same as the current owner of the selectionand the current owner is not None, the current owner is sent a SelectionClear event. If the clientthat is the owner of a selection is later terminated (that is, its connection is closed) or if the ownerwindow ithas specified in the request is later destroyed, the owner of the selection automaticallyreverts to None, but the last-change time is not affected. The selection atom is uninterpreted bythe X server. XGetSelectionOwner returns the owner window, which is reported in Selection-Request and SelectionClear events. Selections are global to the X server.XSetSelectionOwner can generate BadAtom and BadWindow errors.To return the selection owner, use XGetSelectionOwner.71
Xlib − C LibraryX11, Release 6.7 DRAFTWindow XGetSelectionOwner (display, selection)Display *display;Atom selection;displayselectionSpecifies the connection to the X server.Specifies the selection atom whose owner you want returned.The XGetSelectionOwner function returns the window IDassociated with the window that currentlyowns the specified selection. If no selection was specified, the function returns the constantNone. If None is returned, there is no owner for the selection.XGetSelectionOwner can generate a BadAtom error.To request conversion of a selection, use XConvertSelection.XConvertSelection (display, selection, target, property, requestor, time)Display *display;Atom selection, target;Atom property;Window requestor;Time time;displayselectiontargetpropertyrequestortimeSpecifies the connection to the X server.Specifies the selection atom.Specifies the target atom.Specifies the property name. Youalso can pass None.Specifies the requestor.Specifies the time. Youcan pass either a timestamp or CurrentTime.XConvertSelection requests that the specified selection be converted to the specified target type:• Ifthe specified selection has an owner, the X server sends a SelectionRequest event to thatowner.• Ifnoowner for the specified selection exists, the X server generates a SelectionNotifyevent to the requestor with property None.The arguments are passed on unchanged in either of the events. There are two predefined selectionatoms: PRIMARY and SECONDARY.XConvertSelection can generate BadAtom and BadWindow errors.72
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: Xlib − C LibraryX11, Release 6.7
Page 75: Xlib − C LibraryX11, Release 6.7
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:
Page 343 and 344:
Page 345 and 346:
Page 347 and 348:
Page 349 and 350:
Page 351 and 352:
Page 353 and 354:
Page 355 and 356:
Page 357 and 358:
Page 359 and 360:
Page 361 and 362:
Page 363 and 364:
Page 365 and 366:
Page 367 and 368:
Page 369 and 370:
Page 371 and 372:
Page 373 and 374:
Page 375 and 376:
Page 377 and 378:
Page 379 and 380:
Page 381 and 382:
Page 383 and 384:
Page 385 and 386:
Page 387 and 388:
Page 389 and 390:
Page 391 and 392:
Page 393 and 394:
Page 395 and 396:
Page 397 and 398:
Page 399 and 400:
Page 401 and 402:
Page 403 and 404:
Page 405 and 406:
Page 407 and 408:
Page 409 and 410:
Page 411 and 412:
Page 413 and 414:
Page 415 and 416:
Page 417 and 418:
Page 419 and 420:
Page 421 and 422:
Page 423 and 424:
Page 425 and 426:
Page 427 and 428:
Page 429 and 430:
Page 431 and 432:
Page 433 and 434:
Page 435 and 436:
Page 437 and 438:
Page 439 and 440:
Page 441 and 442:
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