Автор:	© Анатолий Камынин
Дата публикации:	2004
Дата обновления:	2010

Здесь представлены функции и скрипты языка сценариев JAWS, которые позволяют отслеживать состояние буфера обмена, записывать в него текст и получать из него данные.

Начиная с JAWS версии 7, появился специализированный буфер Freedom (Freedom clipboard), позволяющий накапливать скопированный текст, а затем вставлять весь накопленный текст при помощи стандартной команды "Вставить".

• Скрипт AppendSelectedTextToClipboard
• Функция AppendToClipboard
• Функция ClipboardChangedEvent
• Функция ClipboardHasData
• Скрипт CopySelectedTextToClipboard
• Функция CopyToClipboard
• Скрипт CutToClipboard
• Функция GetClipboardText
• Скрипт PasteFromClipboard
• Скрипт Replace

Скрипт AppendSelectedTextToClipboard

Описание: С помощью буфера Freedom выделенный текст будет добавлен к содержимому буфера обмена.

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих версиях:

1. JAWS 7.00 более поздних

Функция AppendToClipboard

Описание:Добавляет текст в конец или начало буфера обмена, сохраняя существующее содержимое буфера обмена. Вставляемые фрагменты текста будут отделены друг от друга пустой строкой. Допускается добавление только простого текста.

Возвращаемое значение: Int, TRUE, если текст был успешно добавлен; FALSE -- в противном случае.

Параметр 1:

String,добавляемый текст. Параметр является обязательным.

Параметр 2:

Int, TRUE, если текст надо добавить в конец содержимого буфера обмена; FALSE -- если в начало.

Эта функция доступна в следующих версиях:

1. JAWS 7.00
2. Magic 10.5 и более поздних

Функция ClipboardChangedEvent

Описание: функция будет вызвана, если произойдёт изменение содержимого Буфера обмена (clipboard) Windows.

Возвращаемое значение: Void

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция ClipboardHasData

Описание: функция возвращает TRUE, если в Буфере обмена (clipboard) содержатся данные.

Возвращаемое значение: Int (целый). True означает, что Буфер обмена содержит данные, false - Буфер обмена пуст.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт CopySelectedTextToClipboard

Описание: скрипт выполняет стандартную для Windows команду Копировать (Copy) или Копировать в буфер обмена (Copy to Clipboard), которая обычно располагается в меню "Правка" и копирует выделенный текст или объект в Буфер обмена Windows. Помещённый в Буфер обмена текст или объект можно вставить в другое приложение.

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция CopyToClipboard

Описание: функция помещает в Буфер обмена (clipboard) строку текста, уничтожая при этом предыдущее содержимое Буфера обмена. Чтобы разместить в Буфере обмена несколько строк текста, следует использовать функцию конкатенации (соединения) строк, прежде чем копировать в Буфер обмена. В результирующем тексте разбиение на строки должно обозначаться символами "\r\n".

Возвращаемое значение: Void

Параметр 1:

String, Содержит текст, который должен быть размещён в Буфере обмена. Этот параметр является обязательным.

Эта функция доступна в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт CutToClipboard

Описание: стандартная для Windows команда Вырезать(cut), которая обычно находится в меню Правка (Edit) и которая удаляет выделенный текст или объект и помещает их в Буфер обмена (Clipboard) Windows. Примечание: используйте команду Вставить (Paste), чтобы поместить вырезанный текст или объект в другое место.

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция GetClipboardText

Описание: функция возвращает текст в формате ANSI из Буфера обмена (clipboard). Каждая строка текста заканчивается символом возврата каретки (carriage return) и символом перевода строки (linefeed): CR-LF.

Возвращаемое значение: String, Содержит текст из Буфера обмена или пустую строку (""), если Буфер обмена пуст.

Параметры: отсутствуют

Эта функция доступна в следующих версиях:

1. JAWS 5.0 и более поздних

Скрипт PasteFromClipboard

Описание: стандартная для Windows команда Вставить (Paste), которая находится обычно в меню Правка (Edit) и которая помещает текст или объект из Буфера обмена (Clipboard) в позицию, где располагается системная каретка (PC-курсор). Примечание: прежде чем производить вставку из Буфера обмена, необходимо поместить в него текст или объект при помощи команд Копировать (Copy) или Вырезать (Cut).

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих версиях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт Replace

Описание: активирует пункт Заменить (Replace) в меню в приложениях, использующих операции поиска и замены текста. Скрипт может быть недоступным в некоторых приложениях.

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих версиях:

1. PAC Mate 1.10 и более поздних