Clipboard Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.DataTransfer

Mendapatkan dan mengatur informasi dari objek clipboard.

public ref class Clipboard abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Clipboard final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Clipboard

Public Class Clipboard

Warisan

Object Platform::Object IInspectable Clipboard

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh berikut menunjukkan cara melacak perubahan pada Clipboard. Jika Clipboard memiliki teks, kode akan menambahkan teks ke halaman HTML.

private async void TrackClipboardChanges_EventHandler(object sender, object e)
{
    DataPackageView dataPackageView = Clipboard.GetContent();
    if (dataPackageView.Contains(StandardDataFormats.Text))
    {
        String text = await dataPackageView.GetTextAsync();

        // To output the text from this example, you need a TextBlock control
        // with a name of "TextOutput".
        TextOutput.Text = "Clipboard now contains: " + text;
    }
}

Tip

Untuk informasi selengkapnya, panduan desain, dan contoh kode, lihat Menyalin dan menempelkan.

Buka aplikasi Galeri WinUI 3 dan lihat Fitur Clipboard beraksi.

Aplikasi WinUI 3 Gallery mencakup contoh interaktif sebagian besar kontrol, fitur, dan fungsi WinUI 3. Dapatkan aplikasi dari Microsoft Store atau dapatkan kode sumber di GitHub

Keterangan

Karena kelas Clipboard adalah kelas statis, Anda tidak perlu membuat instansnya untuk mengakses metodenya.

Anda hanya dapat mengakses clipboard ketika aplikasi panggilan berfokus pada utas UI (misalnya, ketika CoreWindow aktif). Gunakan peristiwa CoreWindow.Activated untuk melacak status aplikasi panggilan.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1809	17763	ClearHistory
1809	17763	DeleteItemFromHistory
1809	17763	GetHistoryItemsAsync
1809	17763	HistoryChanged
1809	17763	HistoryEnabledChanged
1809	17763	IsHistoryEnabled
1809	17763	IsRoamingEnabled
1809	17763	RoamingEnabledChanged
1809	17763	SetContentWithOptions
1809	17763	SetHistoryItemAsContent

Metode

Clear()	Menghapus semua data dari Clipboard.
ClearHistory()	Menghapus riwayat clipboard.
DeleteItemFromHistory(ClipboardHistoryItem)	Menghapus item yang ditentukan dari riwayat papan klip.
Flush()	Menambahkan konten ke Clipboard dan merilis objek DataPackage dari aplikasi sumber. Metode ini memungkinkan konten tetap tersedia setelah aplikasi dimatikan.
GetContent()	Mendapatkan isi saat ini yang disimpan dalam objek papan klip.
GetHistoryItemsAsync()	Mendapatkan daftar item yang saat ini ada dalam riwayat papan klip.
IsHistoryEnabled()	Menunjukkan apakah riwayat clipboard (yaitu, kemampuan untuk menyimpan beberapa item ke clipboard) diaktifkan untuk pengguna saat ini.
IsRoamingEnabled()	Menunjukkan apakah data clipboard diatur untuk disinkronkan di seluruh perangkat untuk pengguna saat ini.
SetContent(DataPackage)	Menyetel isi saat ini yang disimpan dalam objek papan klip.
SetContentWithOptions(DataPackage, ClipboardContentOptions)	Mengatur konten yang disimpan dalam objek clipboard dengan opsi untuk konten.
SetHistoryItemAsContent(ClipboardHistoryItem)	Menyetel item dalam riwayat papan klip sebagai isi saat ini untuk papan klip.

Acara

ContentChanged	Terjadi ketika data yang disimpan di Clipboard berubah.
HistoryChanged	Terjadi ketika item baru ditambahkan ke riwayat clipboard.
HistoryEnabledChanged	Terjadi ketika pengaturan OS yang mengontrol apakah riwayat clipboard diaktifkan untuk pengguna saat ini diubah.
RoamingEnabledChanged	Terjadi ketika pengaturan OS yang mengontrol apakah data clipboard diatur untuk disinkronkan di seluruh perangkat untuk pengguna saat ini diubah.

Lihat juga

• Sampel clipboard (Windows 10)