Clipboard 類別

定義

命名空間:

Windows.ApplicationModel.DataTransfer

從剪貼簿物件取得及設定資訊。

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

繼承

Object Platform::Object IInspectable Clipboard

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

下列範例示範如何追蹤剪貼簿的變更。 如果剪貼簿有文字，程式碼會將文字新增至 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;
    }
}

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 複製和貼上。

開啟 WinUI 3 資源庫應用程式，並查看剪貼簿功能運作情形。

WinUI 3 資源庫應用程式包含大部分 WinUI 3 控制項、特性和功能的互動式範例。 從Microsoft Store取得應用程式，或在GitHub上取得原始程式碼

備註

由於剪貼簿類別是靜態類別，因此您不需要建立實例來存取其方法。

當呼叫的應用程式專注于 UI 執行緒 (時，您只能存取剪貼簿，例如，當其 CoreWindow 處於作用中) 時。 使用 CoreWindow.Activated 事件來追蹤呼叫應用程式的狀態。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
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

方法

Clear()	從剪貼簿中移除所有資料。
ClearHistory()	清除剪貼簿記錄。
DeleteItemFromHistory(ClipboardHistoryItem)	從剪貼簿記錄中刪除指定的專案。
Flush()	將內容新增至剪貼簿，並從來源應用程式釋放 DataPackage 物件。 這個方法可讓內容在應用程式關閉之後維持可用狀態。
GetContent()	取得儲存在剪貼簿物件中的目前內容。
GetHistoryItemsAsync()	取得剪貼簿歷程記錄中目前的專案清單。
IsHistoryEnabled()	指出剪貼簿記錄是否 (，目前使用者是否能夠將多個專案儲存至剪貼簿) 。
IsRoamingEnabled()	指出剪貼簿資料是否設定為同步處理目前使用者的裝置。
SetContent(DataPackage)	設定儲存在剪貼簿物件中的目前內容。
SetContentWithOptions(DataPackage, ClipboardContentOptions)	使用內容的選項，設定儲存在剪貼簿物件中的內容。
SetHistoryItemAsContent(ClipboardHistoryItem)	將剪貼簿記錄中的專案設定為剪貼簿的目前內容。

事件

ContentChanged	發生于儲存在剪貼簿中的資料變更時。
HistoryChanged	發生于將新專案新增至剪貼簿記錄時。
HistoryEnabledChanged	發生于控制是否為目前使用者啟用剪貼簿記錄的 OS 設定變更時。
RoamingEnabledChanged	發生于控制剪貼簿資料是否設定為跨裝置同步處理目前使用者的 OS 設定時。

另請參閱

• 剪貼簿範例 (Windows 10)