ClipboardProxy Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет методы для управления буфером обмена.
public ref class ClipboardProxypublic class ClipboardProxytype ClipboardProxy = classPublic Class ClipboardProxy- Наследование
-
ClipboardProxy
Примеры
В этом примере текст из буфера обмена считывается в строку textOnClipboard.
Dim textOnClipboard As String = My.Computer.Clipboard.GetText()
Этот пример завершится ошибкой, если в буфере обмена нет текста.
Комментарии
Элементы, перемещенные или скопированные в буфер обмена, сохраняются даже после завершения работы приложения.
Данные в буфере обмена могут быть в любом формате данных, также называемом форматом буфера обмена. Список стандартных форматов для использования с буфером обмена см. в разделе DataFormats. При перемещении или копировании элемента в буфер обмена удаляются элементы в других форматах. Чтобы сохранить другие форматы, используйте DataObject, который копирует все существующее в текущем буфере обмена, включая элементы, вставленные из других приложений. Поместите данные в буфер обмена в нескольких форматах, чтобы обеспечить максимальную вероятность того, что целевое приложение, требования к формату которого, возможно, не известны, сможет успешно получить данные.
Так как все приложения Windows совместно используют системный буфер обмена, содержимое может измениться при переключении на другое приложение.
Класс должен быть сериализуемым, чтобы его можно было поместить в буфер обмена. Дополнительные сведения см. в разделах Сериализация — C# или Сериализация — Visual Basic.
При удаленном доступе к буферу ThreadStateException обмена возникает исключение , если поток доступа не работает в режиме STA (однопотоковое помещение). Чтобы устранить эту проблему, присвойте параметру ThreadApartmentState значение STA. Для получения дополнительной информации см. STAThreadAttribute.
Дополнительные сведения см. в разделах Хранение данных в буфер обмена и Чтение из буфера обмена.
Доступность по типу проекта
| Тип проекта | Доступно |
|---|---|
| Приложение Windows | Да |
| Библиотека классов | Да |
| Консольное приложение | Да |
| Библиотека элементов управления Windows | Да |
| Библиотека веб-элементов управления | Нет |
| Службы Windows | Да |
| Веб-сайт | Нет |
Методы
| Clear() |
Очищает буфер обмена |
| ContainsAudio() |
Указывает, содержатся ли аудиозаписи в буфере обмена. |
| ContainsData(String) |
Указывает, содержит ли буфер обмена данные в указанном пользовательском формате. |
| ContainsFileDropList() |
Возвращает логическое выражение |
| ContainsImage() |
Возвращает значение |
| ContainsText() |
Определяет, находится ли текст в буфере обмена. |
| ContainsText(TextDataFormat) |
Определяет, находится ли текст в буфере обмена. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetAudioStream() |
Получает аудиопоток из буфера обмена. |
| GetData(String) |
Получает данные из буфера обмена в пользовательском формате. |
| GetDataObject() |
Получает данные из буфера обмена как IDataObject. |
| GetFileDropList() |
Получает набор строк, представляющих имена файлов, из буфера обмена. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetImage() |
Получает изображения из буфера обмена. |
| GetText() |
Получает текст из буфера обмена. |
| GetText(TextDataFormat) |
Получает текст из буфера обмена. |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| SetAudio(Byte[]) |
Записывает аудиозапись в буфер обмена. |
| SetAudio(Stream) |
Записывает аудиозапись в буфер обмена. |
| SetData(String, Object) |
Записывает данные в пользовательском формате в буфер обмена. |
| SetDataObject(DataObject) |
Записывает DataObject в буфер обмена. |
| SetFileDropList(StringCollection) |
Записывает набор строк, представляющих путь к файлу, в буфер обмена. |
| SetImage(Image) |
Записывает изображение в буфер обмена. |
| SetText(String) |
Записывает текст в буфер обмена |
| SetText(String, TextDataFormat) |
Записывает текст в буфер обмена |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
