/usr/share/doc/python-gtk2-tutorial/html/ch-ManagingSelections.html is in python-gtk2-tutorial 2.4-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 21. Managing Selections</title><meta name="generator" content="DocBook XSL Stylesheets V1.65.1"><link rel="home" href="index.html" title="PyGTK 2.0 Tutorial"><link rel="up" href="index.html" title="PyGTK 2.0 Tutorial"><link rel="previous" href="sec-SignalEmissionAndPropagation.html" title="20.2. Signal Emission and Propagation"><link rel="next" href="sec-RetrievingTheSelection.html" title="21.2. Retrieving the Selection"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 21. Managing Selections</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sec-SignalEmissionAndPropagation.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="sec-RetrievingTheSelection.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="ch-ManagingSelections"></a>Chapter 21. Managing Selections</h2></div></div><div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="ch-ManagingSelections.html#sec-SelectionOverview">21.1. Selection Overview</a></span></dt><dt><span class="sect1"><a href="sec-RetrievingTheSelection.html">21.2. Retrieving the Selection</a></span></dt><dt><span class="sect1"><a href="sec-SupplyingTheSelection.html">21.3. Supplying the Selection</a></span></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec-SelectionOverview"></a>21.1. Selection Overview</h2></div></div><div></div></div><p>One type of interprocess communication supported by X and GTK+ is
selections. A selection identifies a chunk of data, for instance, a portion
of text, selected by the user in some fashion, for instance, by dragging
with the mouse. Only one application on a display (the owner) can own a
particular selection at one time, so when a selection is claimed by one
application, the previous owner must indicate to the user that selection has
been relinquished. Other applications can request the contents of a
selection in different forms, called targets. There can be any number of
selections, but most X applications only handle one, the primary
selection.</p><p>In most cases, it isn't necessary for a PyGTK application to deal
with selections itself. The standard widgets, such as the
<tt class="classname">Entry</tt> (see <a href="sec-TextEntries.html" title="9.9. Text Entries">Section 9.9, “Text Entries”</a>)
widget, already have the capability to claim the selection when appropriate
(e.g., when the user drags over text), and to retrieve the contents of the
selection owned by another widget or another application (e.g., when the
user clicks the second mouse button). However, there may be cases in which
you want to give other widgets the ability to supply the selection, or you
wish to retrieve targets not supported by default.</p><p>A fundamental concept needed to understand selection handling is
that of the atom. An atom is an integer that uniquely identifies a string
(on a certain display). Certain atoms are predefined by the X server,
GTK.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sec-SignalEmissionAndPropagation.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="index.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sec-RetrievingTheSelection.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">20.2. Signal Emission and Propagation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 21.2. Retrieving the Selection</td></tr></table></div></body></html>
|