<!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>