Luncurkan cuplikan layar

Ms-screenclip : dan ms-screensketch: Skema URI memungkinkan Anda untuk memulai cuplikan atau mengedit cuplikan layar.

Buka cuplikan baru dari aplikasi Anda

Ms-screenclip : URI memungkinkan aplikasi Anda untuk membuka dan memulai cuplikan baru secara otomatis. Cuplikan yang dihasilkan disalin ke clipboard pengguna, tetapi tidak secara otomatis diteruskan kembali ke aplikasi pembuka.

ms-screenclip: mengambil parameter berikut:

Parameter	Tipe	Wajib	Deskripsi
sumber	string	no	String bentuk bebas untuk menunjukkan sumber yang meluncurkan URI.
jenis	string	no	Nilai string untuk menunjukkan jenis tangkapan khusus mana yang diminta. Parameter ini dapat dihilangkan saat memulai cuplikan baru. Nilai yang didukung meliputi: rekam jepret, perekaman*
clippingMode	string	no	Nilai string untuk menunjukkan jenis kliping untuk cuplikan. Nilai yang didukung meliputi: Persegi Panjang, Bentuk Bebas, Jendela
delayInSeconds	int	no	Nilai bilangan bulat, dari 1 hingga 30. Menentukan penundaan, dalam detik penuh, antara panggilan URI dan saat pemotongan dimulai.
callbackformat	string	no	Parameter ini tidak tersedia.

* type=recording hanya tersedia di PC Windows 11 dengan Snipping Tool versi 11.2307 atau yang lebih baru, dan hanya ketika handler default untuk ms-screenclip diatur ke "Snipping Tool" alih-alih "Screen Clipping".

Meluncurkan Snipping Tool atau Snip & Sketch App

Ms-screensketch : URI memungkinkan Anda meluncurkan aplikasi Alat Pemotongan secara terprogram (di Windows 11) atau aplikasi Snip & Sketch (di Windows 10), dan membuka gambar tertentu di aplikasi tersebut untuk anotasi.

ms-screensketch: mengambil parameter berikut:

Parameter	Tipe	Wajib	Deskripsi
sharedAccessToken	string	no	Token yang mengidentifikasi file yang akan dibuka. Diambil dari SharedStorageAccessManager.AddFile. Jika parameter ini dihilangkan, aplikasi akan diluncurkan tanpa file terbuka.
secondarySharedAccessToken	string	no	String yang mengidentifikasi file JSON dengan metadata tentang cuplikan. Metadata dapat mencakup bidang clipPoints dengan array koordinat x,y, dan/atau userActivity.
sumber	string	no	String bentuk bebas untuk menunjukkan sumber yang meluncurkan URI.
isTemporary	bool	no	Jika diatur ke True, Snipping Tool akan mencoba menghapus file setelah membukanya.

Contoh berikut memanggil metode LaunchUriAsync untuk mengirim gambar ke Alat Pemotongan dari aplikasi pengguna.

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-screensketch:edit?source=MyApp&isTemporary=false&sharedAccessToken=2C37ADDA-B054-40B5-8B38-11CED1E1A2D"));

Contoh berikut menggambarkan apa yang mungkin dimuat oleh parameter sekunderSharedAccessToken dari ms-screensketch :

{
  "clipPoints": [
    {
      "x": 0,
      "y": 0
    },
    {
      "x": 2080,
      "y": 0
    },
    {
      "x": 2080,
      "y": 780
    },
    {
      "x": 0,
      "y": 780
    }
  ],
  "userActivity": "{\"$schema\":\"http://activity.windows.com/user-activity.json\",\"UserActivity\":\"type\",\"1.0\":\"version\",\"cross-platform-identifiers\":[{\"platform\":\"windows_universal\",\"application\":\"Microsoft.MicrosoftEdge_8wekyb3d8bbwe!MicrosoftEdge\"},{\"platform\":\"host\",\"application\":\"edge.activity.windows.com\"}],\"activationUrl\":\"microsoft-edge:https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"contentUrl\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"visualElements\":{\"attribution\":{\"iconUrl\":\"https://www.microsoft.com/favicon.ico?v2\",\"alternateText\":\"microsoft.com\"},\"description\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"backgroundColor\":\"#FF0078D7\",\"displayText\":\"Use snipping tool to capture screenshots - Windows Help\",\"content\":{\"$schema\":\"http://adaptivecards.io/schemas/adaptive-card.json\",\"type\":\"AdaptiveCard\",\"version\":\"1.0\",\"body\":[{\"type\":\"Container\",\"items\":[{\"type\":\"TextBlock\",\"text\":\"Use snipping tool to capture screenshots - Windows Help\",\"weight\":\"bolder\",\"size\":\"large\",\"wrap\":true,\"maxLines\":3},{\"type\":\"TextBlock\",\"text\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\",\"size\":\"normal\",\"wrap\":true,\"maxLines\":3}]}]}},\"isRoamable\":true,\"appActivityId\":\"https://support.microsoft.com/help/13776/windows-use-snipping-tool-to-capture-screenshots\"}"
}