summaryrefslogtreecommitdiff
path: root/lib/libXt/man/XtGetSelectionValue.man
diff options
context:
space:
mode:
authorMatthieu Herrb <matthieu@cvs.openbsd.org>2020-01-14 20:49:02 +0000
committerMatthieu Herrb <matthieu@cvs.openbsd.org>2020-01-14 20:49:02 +0000
commit332defa5d8762e8c04e4e707c08ae3893173581f (patch)
tree3d1096bd168085fd8eac02831142c2466f9b2d26 /lib/libXt/man/XtGetSelectionValue.man
parentc6b1589c2baee04df73cce89e6ffdaabe9a91a87 (diff)
Update to libXt 1.2.0. Tested by tb@
Diffstat (limited to 'lib/libXt/man/XtGetSelectionValue.man')
-rw-r--r--lib/libXt/man/XtGetSelectionValue.man73
1 files changed, 23 insertions, 50 deletions
diff --git a/lib/libXt/man/XtGetSelectionValue.man b/lib/libXt/man/XtGetSelectionValue.man
index 6107174c4..d57900840 100644
--- a/lib/libXt/man/XtGetSelectionValue.man
+++ b/lib/libXt/man/XtGetSelectionValue.man
@@ -34,54 +34,29 @@
.ds Vn 2.2
.hw XtGet-Selection-Value XtGet-Selection-Values wid-get
.na
-.de Ds
-.nf
-.\\$1D \\$2 \\$1
-.ft CW
-.ps \\n(PS
-.\".if \\n(VS>=40 .vs \\n(VSu
-.\".if \\n(VS<=39 .vs \\n(VSp
-..
-.de De
-.ce 0
-.if \\n(BD .DF
-.nr BD 0
-.in \\n(OIu
-.if \\n(TM .ls 2
-.sp \\n(DDu
-.fi
-..
-.de IN \" send an index entry to the stderr
-..
-.de Pn
-.ie t \\$1\fB\^\\$2\^\fR\\$3
-.el \\$1\fI\^\\$2\^\fP\\$3
-..
-.de ZN
-.ie t \fB\^\\$1\^\fR\\$2
-.el \fI\^\\$1\^\fP\\$2
-..
-.ny0
.TH XtGetSelectionValue __libmansuffix__ __xorgversion__ "XT FUNCTIONS"
.SH NAME
XtGetSelectionValue, XtGetSelectionValues \- obtain selection values
.SH SYNTAX
+#include <X11/Intrinsic.h>
.HP
-void XtGetSelectionValue(Widget \fIw\fP, Atom \fIselection\fP, Atom
-\fItarget\fP, XtSelectionCallbackProc \fIcallback\fP, XtPointer
-\fIclient_data\fP, Time \fItime\fP);
-.HP
-void XtGetSelectionValues(Widget \fIw\fP, Atom \fIselection\fP, Atom
-*\fItargets\fP, int \fIcount\fP, XtSelectionCallbackProc \fIcallback\fP,
+void XtGetSelectionValue(Widget \fIw\fP,
+Atom \fIselection\fP,
+Atom \fItarget\fP,
+XtSelectionCallbackProc \fIcallback\fP,
XtPointer \fIclient_data\fP, Time \fItime\fP);
+.HP
+void XtGetSelectionValues(Widget \fIw\fP,
+Atom \fIselection\fP,
+Atom *\fItargets\fP, int \fIcount\fP,
+XtSelectionCallbackProc \fIcallback\fP,
+XtPointer *\fIclient_data\fP, Time \fItime\fP);
.SH ARGUMENTS
-.ds Cb \ that is to be called when the selection value has been obtained
.IP \fIcallback\fP 1i
-Specifies the callback procedure\*(Cb.
-.ds Cd it is called
+Specifies the callback procedure that is to be called when the selection value has been obtained.
.IP \fIclient_data\fP 1i
Specifies the argument that is to be passed to the specified procedure
-when \*(Cd.
+when it is called.
.IP \fIclient_data\fP 1i
Specifies the client data (one for each target type)
that is passed to the callback procedure when it is called for that target.
@@ -93,38 +68,36 @@ Specifies the particular selection desired (that is, primary or secondary).
Specifies the type of the information that is needed about the selection.
.IP \fItargets\fP 1i
Specifies the types of information that is needed about the selection.
-.ds Ti value is desired
.IP \fItime\fP 1i
-Specifies the timestamp that indicates when the selection \*(Ti.
-.ds Wi that is making the request
+Specifies the timestamp that indicates when the selection value is desired.
.IP \fIw\fP 1i
-Specifies the widget \*(Wi.
+Specifies the widget that is making the request.
.SH DESCRIPTION
The
-.ZN XtGetSelectionValue
+.B XtGetSelectionValue
function requests the value of the selection that has been converted to
the target type.
The specified callback will be called some time after
-.ZN XtGetSelectionValue
+.B XtGetSelectionValue
is called;
in fact, it may be called before or after
-.ZN XtGetSelectionValue
+.B XtGetSelectionValue
returns.
.LP
The
-.ZN XtGetSelectionValues
+.B XtGetSelectionValues
function is similar to
-.ZN XtGetSelectionValue
+.B XtGetSelectionValue
except that it takes a list of target types and a list of client data
and obtains the current value of the selection converted to each of the targets.
The effect is as if each target were specified in a separate call to
-.ZN XtGetSelectionValue .
+.BR XtGetSelectionValue .
The callback is called once with the corresponding client data for each target.
-.ZN XtGetSelectionValues
+.B XtGetSelectionValues
does guarantee that all the conversions will use the same selection value
because the ownership of the selection cannot change in the middle of the list,
as would be when calling
-.ZN XtGetSelectionValue
+.B XtGetSelectionValue
repeatedly.
.SH "SEE ALSO"
XtAppGetSelectionTimeout(__libmansuffix__),