Clipboard Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет статические методы, которые способствуют двунаправленной передаче данных в системный буфер обмена.
public ref class Clipboard abstract sealedpublic static class Clipboardtype Clipboard = classPublic Class Clipboard- Наследование
-
Clipboard
Примеры
В следующем примере показано, как добавить данные в системный буфер обмена.
// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";
// After this call, the data (string) is placed on the clipboard and tagged
// with a data format of "Text".
Clipboard.SetData(DataFormats.Text, (Object)textData);
' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."
' After this call, the data (string) is placed on the clipboard and tagged
' with a data format of "Text".
Clipboard.SetData(DataFormats.Text, CType(textData, Object))
Комментарии
Все приложения для Windows совместно используют системный буфер обмена, поэтому содержимое может изменяться при переключении на другое приложение.
Список стандартных форматов, доступных для использования с классом Clipboard , см. в DataFormats разделе Класс .
Оповещение системы безопасности: В целях безопасности следует учитывать следующие моменты.
Операции вставки должны быть инициированы пользователем (CTRL+V, меню вставки).
Копировать можно только для выбранного пользователем содержимого.
При копировании или вырезания код с частичным доверием помещает открытый текст и язык XAML в буфер обмена. Обычный текст включает текст, текст Юникода, текст OEM (модель обмена объектами) и CSV (значения, разделенные запятыми).
При вставке Windows Presentation Foundation (WPF) будет вставляться на xaml, если источником этого содержимого является сайт с одинаковым доверием или более доверенным. В частности:
Приложение с частичным доверием может вставить язык XAML из приложения с полным доверием.
Приложение с частичным доверием может вставить язык XAML из приложения с частичным доверием.
Приложение с полным доверием может вставить XAML только из другого полностью доверенного приложения.
Приложение с полным доверием без Windows Presentation Foundation (WPF) может изучить формат ApplicationTrust в буфере обмена и при необходимости очищать XAML.
Методы
| Clear() |
Очищает любые данные из системного буфера обмена. |
| ContainsAudio() |
Запрашивает буфер обмена на наличие данных в формате WaveAudio. |
| ContainsData(String) |
Запрашивает буфер обмена на наличие данных в указанном формате. |
| ContainsFileDropList() |
Запрашивает буфер обмена на наличие данных в формате FileDrop. |
| ContainsImage() |
Запрашивает буфер обмена на наличие данных в формате Bitmap. |
| ContainsText() |
Запрашивает буфер обмена на наличие данных в формате UnicodeText. |
| ContainsText(TextDataFormat) |
Запрашивает буфер обмена на наличие данных в текстовом формате. |
| Flush() |
Окончательно добавляет данные из Clipboard, чтобы они были доступны после закрытия исходного приложения. |
| GetAudioStream() |
Возвращает поток данных из буфера обмена в формате WaveAudio. |
| GetData(String) |
Извлекает данные в указанном формате из буфера обмена. |
| GetDataObject() |
Возвращает объект данных, представляющий все содержимое буфера обмена. |
| GetFileDropList() |
Возвращает коллекцию строк, содержащую список перенесенных файлов, доступный в буфере обмена. |
| GetImage() |
Возвращает объект BitmapSource из буфера обмена, содержащий данные в формате Bitmap. |
| GetText() |
Возвращает строку, содержащую данные UnicodeText из буфера обмена. |
| GetText(TextDataFormat) |
Возвращает строку, содержащую текстовые данные из буфера обмена. |
| IsCurrent(IDataObject) |
Сравнивает указанный объект данных с содержимым буфера обмена. |
| SetAudio(Byte[]) |
Сохраняет аудиоданные (в формате WaveAudio) в буфере обмена. Аудиоданные указываются в виде массива байтов. |
| SetAudio(Stream) |
Сохраняет аудиоданные (в формате WaveAudio) в буфере обмена. Аудиоданные указываются в виде потока. |
| SetData(String, Object) |
Сохраняет указанные данные в буфере обмена в указанном формате. |
| SetDataObject(Object) |
Размещает указанный непостоянный объект данных в системном буфере обмена. |
| SetDataObject(Object, Boolean) |
Размещает указанный объект данных в системном буфере обмена и принимает логический параметр, указывающий, следует ли оставлять этот объект в буфере обмена при выходе из приложения. |
| SetFileDropList(StringCollection) |
Сохраняет в буфере обмена данные FileDrop. Список перенесенных файлов указывается в виде коллекции строк. |
| SetImage(BitmapSource) |
Сохраняет в буфере обмена данные Bitmap. Данные изображения обрабатываются как BitmapSource. |
| SetText(String) |
Сохраняет в буфере обмена данные UnicodeText. |
| SetText(String, TextDataFormat) |
Сохраняет текстовые данные в буфере обмена в указанном текстовом формате. Данные UnicodeText для сохранения указываются в виде строки. |
