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에서 소스 코드를 가져옵니다.

설명

Clipboard 클래스는 정적 클래스이므로 해당 메서드에 액세스하기 위해 instance 만들 필요가 없습니다.

호출하는 애플리케이션이 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)