NAME<\/a> ______________________________________________________________________________<\/p>\n selection \u2212 Manipulate the X selection<\/p>\n selection<\/b> option<\/i> ?arg arg …<\/i>? ______________________________________________________________________________<\/p>\n This command provides a Tcl interface to the X selection mechanism and implements the full selection functionality described in the X Inter-Client Communication Conventions Manual (ICCCM).<\/p>\n Note that for management of the CLIPBOARD<\/b> selection (see below), the clipboard<\/b> command may also be used.<\/p>\n The first argument to selection<\/b> determines the format of the rest of the arguments and the behavior of the command. The following forms are currently supported: If selection<\/i> exists anywhere on window<\/i>\u2019s display, clear it so that no window owns the selection anymore. Selection<\/i> specifies the X selection that should be cleared, and should be an atom name such as PRIMARY<\/b> or CLIPBOARD<\/b>; see the Inter-Client Communication Conventions Manual for complete details. Selection<\/i> defaults to PRIMARY<\/b> and window<\/i> defaults to \u201c.\u201d. Returns an empty string.<\/p>\n selection get<\/b> ?\u2212displayof<\/b> window<\/i>? ?\u2212selection<\/b> selection<\/i>? ?\u2212type<\/b> type<\/i>?<\/p>\n Retrieves the value of selection<\/i> from window<\/i>\u2019s display and returns it as a result. Selection<\/i> defaults to PRIMARY<\/b> and window<\/i> defaults to \u201c.\u201d. Type<\/i> specifies the form in which the selection is to be returned (the desired \u201ctarget\u201d for conversion, in ICCCM terminology), and should be an atom name such as STRING<\/b> or FILE_NAME<\/b>; see the Inter-Client Communication Conventions Manual for complete details. Type<\/i> defaults to STRING<\/b>. The selection owner may choose to return the selection in any of several different representation formats, such as STRING<\/b>, UTF8_STRING<\/b>, ATOM<\/b>, INTEGER<\/b>, etc. (this format is different than the selection type; see the ICCCM for all the confusing details). If the selection is returned in a non-string format, such as INTEGER<\/b> or ATOM<\/b>, the selection<\/b> command converts it to string format as a collection of fields separated by spaces: atoms are converted to their textual names, and anything else is converted to hexadecimal integers. Note that selection get<\/b> does not retrieve the selection in the UTF8_STRING<\/b> format unless told to.<\/p>\n selection handle<\/b> ?\u2212selection<\/b> s<\/i>? ?\u2212type<\/b> t<\/i>? ?\u2212format<\/b> f<\/i>? window command<\/i><\/p>\n Creates a handler for selection requests, such that command<\/i> will be executed whenever selection s<\/i> is owned by window<\/i> and someone attempts to retrieve it in the form given by type t<\/i> (e.g. t<\/i> is specified in the selection get<\/b> command). S<\/i> defaults to PRIMARY<\/b>, t<\/i> defaults to STRING<\/b>, and f<\/i> defaults to STRING<\/b>. If command<\/i> is an empty string then any existing handler for window<\/i>, t<\/i>, and s<\/i> is removed. Note that when the selection is handled as type STRING<\/b> it is also automatically handled as type UTF8_STRING<\/b> as well.<\/p>\n When selection<\/i> is requested, window<\/i> is the selection owner, and type<\/i> is the requested type, command<\/i> will be executed as a Tcl command with two additional numbers appended to it (with space separators). The two additional numbers are offset<\/i> and maxChars<\/i>: offset<\/i> specifies a starting character position in the selection and maxChars<\/i> gives the maximum number of characters to retrieve. The command should return a value consisting of at most maxChars<\/i> of the selection, starting at position offset<\/i>. For very large selections (larger than maxChars<\/i>) the selection will be retrieved using several invocations of command<\/i> with increasing offset<\/i> values. If command<\/i> returns a string whose length is less than maxChars<\/i>, the return value is assumed to include all of the remainder of the selection; if the length of command<\/i>\u2019s result is equal to maxChars<\/i> then command<\/i> will be invoked again, until it eventually returns a result shorter than maxChars<\/i>. The value of maxChars<\/i> will always be relatively large (thousands of characters).<\/p>\n If command<\/i> returns an error then the selection retrieval is rejected just as if the selection did not exist at all.<\/p>\n The format<\/i> argument specifies the representation that should be used to transmit the selection to the requester (the second column of Table 2 of the ICCCM), and defaults to STRING<\/b>. If format<\/i> is STRING<\/b>, the selection is transmitted as 8-bit ASCII characters (i.e. just in the form returned by command<\/i>, in the system encoding<\/b>; the UTF8_STRING<\/b> format always uses UTF-8 as its encoding). If format<\/i> is ATOM<\/b>, then the return value from command<\/i> is divided into fields separated by white space; each field is converted to its atom value, and the 32-bit atom value is transmitted instead of the atom name. For any other format<\/i>, the return value from command<\/i> is divided into fields separated by white space and each field is converted to a 32-bit integer; an array of integers is transmitted to the selection requester.<\/p>\n The format<\/i> argument is needed only for compatibility with selection requesters that do not use Tk. If Tk is being used to retrieve the selection then the value is converted back to a string at the requesting end, so format<\/i> is irrelevant.<\/p>\n selection own<\/b> ?\u2212displayof<\/b> window<\/i>? ?\u2212selection<\/b> selection<\/i>? The first form of selection own<\/b> returns the path name of the window in this application that owns selection<\/i> on the display containing window<\/i>, or an empty string if no window in this application owns the selection. Selection<\/i> defaults to PRIMARY<\/b> and window<\/i> defaults to \u201c.\u201d.<\/p>\n The second form of selection own<\/b> causes window<\/i> to become the new owner of selection<\/i> on window<\/i>\u2019s display, returning an empty string as result. The existing owner, if any, is notified that it has lost the selection. If command<\/i> is specified, it is a Tcl script to execute when some other window claims ownership of the selection away from window<\/i>. Selection<\/i> defaults to PRIMARY.<\/p>\n The text<\/b>, entry<\/b>, ttk::entry<\/b>, listbox<\/b>, spinbox<\/b> and ttk::spinbox<\/b> widgets have the option \u2212exportselection<\/b>. If a widget has this option set to boolean true<\/b>, then (in an unsafe interpreter) a selection made in the widget is automatically written to the PRIMARY<\/b> selection.<\/p>\n A GUI event, for example < On X11, the PRIMARY<\/b> selection is a system-wide feature of the X server, allowing communication between different processes that are X11 clients.<\/p>\n On Windows, the PRIMARY<\/b> selection is not provided by the system, but only by Tk, and so it is shared only between windows of a master interpreter and its unsafe slave interpreters. It is not shared between interpreters in different processes or different threads. Each master interpreter has a separate PRIMARY<\/b> selection that is shared only with its unsafe slaves.<\/p>\n A safe interpreter cannot read from the PRIMARY<\/b> selection because its selection<\/b> command is hidden. For this reason the PRIMARY<\/b> selection cannot be written to the Tk widgets of a safe interpreter.<\/p>\n A Tk widget can have its option \u2212exportselection<\/b> set to boolean true<\/b>, but in a safe interpreter this option has no effect: writing from the widget to the PRIMARY<\/b> selection is disabled.<\/p>\n These are security features. A safe interpreter may run untrusted code, and it is a security risk if this untrusted code can read or write the PRIMARY<\/b> selection used by other interpreters.<\/p>\n On X11 platforms, one of the standard selections available is the SECONDARY<\/b> selection. Hardly anything uses it, but here is how to read it using Tk:<\/p>\n set selContents [selection get<\/b> \u2212selection SECONDARY]<\/p>\n Many different types of data may be available for a selection; the special type TARGETS<\/b> allows you to get a list of available types:<\/p>\n foreach type [selection get<\/b> \u2212type TARGETS] { To claim the selection, you must first set up a handler to supply the data for the selection. Then you have to claim the selection…<\/p>\n # Set up the data handler ready for incoming requests # Now we grab the selection itself clipboard(n)<\/p>\n clear, format, handler, ICCCM, own, selection, target, type<\/p>\n selection \u2212 Manipulate the X selection <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3783,1],"tags":[2635,2814],"class_list":["post-6170","post","type-post","status-publish","format-standard","hentry","category-n-comandos-tcl-tk","category-sin-categoria","tag-mann","tag-selection"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6170","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=6170"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6170\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=6170"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=6170"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=6170"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
SYNOPSIS<\/a>
DESCRIPTION<\/a>
WIDGET FACILITIES<\/a>
PORTABILITY ISSUES<\/a>
SECURITY<\/a>
EXAMPLES<\/a>
SEE ALSO<\/a>
KEYWORDS<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
DESCRIPTION <\/a> <\/h2>\n
selection clear<\/b> ?\u2212displayof<\/b> window<\/i>? ?\u2212selection<\/b> selection<\/i>?<\/p>\n
selection own<\/b> ?\u2212command<\/b> command<\/i>? ?\u2212selection<\/b> selection<\/i>? window<\/i><\/p>\nWIDGET FACILITIES <\/a> <\/h2>\n
PORTABILITY ISSUES <\/a> <\/h2>\n
SECURITY <\/a> <\/h2>\n
EXAMPLES <\/a> <\/h2>\n
puts “Selection PRIMARY supports type $type”
}<\/p>\n
set foo “This is a string with some data in it… blah blah”
selection handle<\/b> \u2212selection SECONDARY . getData
proc getData {offset maxChars} {
puts “Retrieving selection starting at $offset”
return [string range $::foo $offset [expr {$offset+$maxChars-1}]]
}<\/p>\n
puts “Claiming selection”
selection own<\/b> \u2212command lost \u2212selection SECONDARY .
proc lost {} {
puts “Lost selection”
}<\/p>\nSEE ALSO <\/a> <\/h2>\n
KEYWORDS <\/a> <\/h2>\n
\n","protected":false},"excerpt":{"rendered":"