Bagikan melalui


Clipboard Kelas

Definisi

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)]
class Clipboard final
/// [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)]
public static class Clipboard
[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

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.

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.

Berlaku untuk

Lihat juga