86 lines
3.3 KiB
HTML
86 lines
3.3 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<title>clipboard</title>
|
||
</head>
|
||
<body>
|
||
|
||
<h1>clipboard</h1>
|
||
|
||
<p>Управление буфером временного хранения Tk.</p>
|
||
|
||
<h2><a name="СИНТАКСИС"></a>СИНТАКСИС</h2>
|
||
|
||
<pre>
|
||
<strong>clipboard</strong> <em>параметр арг арг</em>
|
||
</pre>
|
||
|
||
<h2><a name="ОПИСАНИЕ"></a>ОПИСАНИЕ"</h2>
|
||
|
||
<p>Команда обеспечивает Tcl интерфейс с буфером временного
|
||
хранения Tk, в котором хранятся данные для последующего
|
||
использования с помощью механизма выделения. Для копирования
|
||
данных в буфер необходимо вызвать очистку буфера, а затем одну
|
||
или несколько команд добавления данных в буфер. Полное
|
||
обновление буфера достигается, если все добавления произведены
|
||
до завершения события. Первый аргумент определяет формат
|
||
последующих аргументов и поведение команды. В настоящее время
|
||
поддерживаются следующие формы команды:</p>
|
||
|
||
<dl>
|
||
<dt><strong>clipboard clear -displayof</strong> <em>окно</em></dt>
|
||
|
||
<dd>Заявляет права на буфер в <em>окне</em> и удаляет текущее
|
||
содержимое буфера. Значением параметра <em>окно</em> по
|
||
умолчанию является ".". Команда возвращает пустую строку.</dd>
|
||
|
||
<dt><strong>clipboard append -displayof</strong> <em>окно</em> <strong>-format</strong>
|
||
<em>формат</em> <strong>-type</strong> <em>тип -- данные</em></dt>
|
||
|
||
<dd><p>Добавляет <em>данные</em> к содержимому буфера <em>окна</em> в
|
||
виде, заданном параметром <em>тип</em>, и представлении,
|
||
заданном параметром <em>формат</em>, а также заявляет права на
|
||
буфер в <em>окне</em>.</p>
|
||
|
||
<p>Параметр <em>тип</em> задает вид, в котором должно
|
||
возвращаться выделение; его значение должно быть именем
|
||
атома, например, STRING или FILE_NAME; детали описания см. в
|
||
(1). Параметр <em>тип</em> по умолчанию имеет значение
|
||
STRING.</p>
|
||
|
||
<p>Аргумент <em>формат</em> задает представление, в котором
|
||
выделение передается по запросу (см (1). второй столбец в
|
||
Таблице 2); по умолчанию его значение STRING. В
|
||
<em>формат</em>е STRING выделение передается в виде строки
|
||
8-битовых символов ASCII. В <em>формат</em>е ATOM данные
|
||
разделяются на поля, отделенные друг от друга пробелами;
|
||
каждое поле преобразуется в значение своего атома, а вместо
|
||
имени атома передается его 32-битовое значение. Во всех
|
||
других <em>формат</em>ах <em>данные</em> делятся на поля,
|
||
отделенные друг от друга пробелами, каждое поле
|
||
преобразуется в 32-битовое целое число; затем массив целых
|
||
чисел передается тому, кто запросил выделение. При этом
|
||
передаваемые в буфер строки объединяются перед
|
||
преобразованием, поэтому необходимо позаботиться заранее о
|
||
соответствующем обрамлении их пробелами. Все добавки в
|
||
буфер одного типа должны иметь одинаковый <em>формат</em>.</p>
|
||
|
||
<p>Аргумент <em>формат</em> необходим исключительно для
|
||
обеспечения совместимости пользователям буфера, не
|
||
использующим Tk. При выводе результатов поиска в выделении
|
||
CLIPBOARD с помощью инструментов Tk значение буфера
|
||
переводится в строковый формат, поэтому значение аргумента
|
||
<em>формат</em> не играет роли.</p>
|
||
|
||
<p>С помощью аргумента указывается конец списка параметров:
|
||
следующий за ним аргумент всегда интерпретируется как
|
||
<em>данные</em>. Такая возможность полезна, например, если
|
||
<em>данные</em> начинаются символом "-".</p>
|
||
</dd>
|
||
</dl>
|
||
|
||
</body>
|
||
</html>
|
||
|
||
|