[редактировать]

UXClipboard

• class UXClipboard (php\gui\UXClipboard)
• package gui
• tags clipboard, cut, paste, copy, буфер, буффер, буфер обмена, копировать, вставить, вырезать

use php\gui\UXClipboard;
// или
use gui;

Утилитарный класс для работы с буфером обмена системы (функции копирования и вставки в рамках всей ОС). Класс имеет только статичные методы, невозможно создать объект данного класса.

---

Статичные методы

• UXClipboard ::clear() - очистка буфера
• UXClipboard ::getText() - получить текст из буфера
• UXClipboard ::setText() - положить текст в буфер
• UXClipboard ::setContent() - положить контент в буфер
• UXClipboard ::getImage() - получить изображение из буфера
• UXClipboard ::getFiles() - получить пути к файлам из буфера
• UXClipboard ::getHtml() - получить html из буфера
• UXClipboard ::getUrl() - получить ссылку из буфера
• UXClipboard ::hasText() - есть ли текст в буфере
• UXClipboard ::hasImage() - есть ли изображение в буфере
• UXClipboard ::hasFiles() - есть ли пути к файлам в буфере
• UXClipboard ::hasHtml() - есть ли html в буфере

---

Статичные методы

clear()

Очистить буфер обмена от любых данных.

// очистка буфера
UXClipboard::clear();

---

getText()

UXClipboard::getText(): string

Метод возвращает текст из буфера обмена, если его там нет, возвращает null.

// показать текст из буфера обмена
alert(UXClipboard::getText());

---

setText()

UXClipboard::setText(string $text)

Метод помещает текст $text в буфер обмена.

// поместить текст в буфер обмена.
UXClipboard::setText('Hello World');

Смотрите также метод setContent().

---

setContent()

UXClipboard::setContent(array $content)

Метод помещает разнообразный контент (текст, изображения, файлы и т.д.) в буфер обмена. В массиве $content под различными ключами передается нужный контент: text для текст, image для изображения объект UXImage, files для списка путей к файлам в виде массива или итератора, html для html, url для ссылки.

UXClipboard::setContent([
     'files' => ['path/to/file1.png', 'path/to/file2.png'],
     'text' => 'foobar text',
     'url' => 'http://develnext.org',
     'html' => '<b>World</b>',
     'image' => new UXImage('path/to/image.png')
]);

---

getImage()

UXClipboard::getImage(): UXImage

Метод возвращает изображения из буфера обмена в виде объекта UXImage.

// загрузить изображения из буфера в компонент изображение.
$this->clipImage->image = UXClipboard::getImage();

---

getFiles()

UXClipboard::getFiles(): array

Метод возвращает список путей к файлам из буфера обмена.

Копирование файлов в различных ОС происходит через помещение их полных путей в буфер обмена.

$files = UXClipboard::getFiles();
print_r($files);