Aracılığıyla paylaş

Ekran alıntısını başlatma

  • Makale

ms-screenclip: ve ms-screensketch: URI şemaları, bir ekran alıntısı veya düzenleme işlemi başlatmanıza olanak tanır.

Uygulamanızdan yeni bir ekran alıntısı açma

ms-screenclip: URI,uygulamanızın otomatik olarak açılmasını ve yeni bir ekran alıntısı başlatmasını sağlar. Sonuçta elde edilen ekran alıntısı kullanıcının panosuna kopyalanır, ancak otomatik olarak açılış uygulamasına geri geçirılmaz.

ms-screenclip : aşağıdaki parametreleri alır:

Parametre Tür Gerekli Açıklama
kaynak dizgi Hayır URI'yi başlatan kaynağı belirten serbest biçimli bir dize.
tür dizgi Hayır Hangi özel yakalama türünün istendiğini belirten bir dize değeri. Yeni bir ekran alıntısı başlatılırken bu parametre atlanabilir. Desteklenen değerler şunlardır: anlık görüntü, kayıt*
kırpmaModu dizgi Hayır Ekran alıntısı için kırpma türünü gösteren dize değeri. Desteklenen değerler şunlardır: Rectangle, Freeform, Window
SaniyeCinsindenGecikme Int Hayır 1 ile 30 olan bir tamsayı değeri. URI çağrısı ile ekran alıntısının ne zaman başladığı arasındaki gecikmeyi tam saniye olarak belirtir.
geri çağırma biçimi dizgi Hayır Bu parametre kullanılamıyor.

* type=recording yalnızca Ekran Alıntısı Aracı sürüm 11.2307 veya üzeri olan Windows 11 bilgisayarlarda ve yalnızca ms-screenclip için varsayılan işleyici "Ekran Kırpma" yerine "Ekran Alıntısı Aracı" olarak ayarlandığında kullanılabilir.

Ekran Alıntısı Aracını veya Snip & Taslak Uygulamasını Başlatma

ms-screensketch: URI'si, Ekran Alıntısı Aracı uygulamasını (Windows 11'de) veya Ekran Alıntısı & Taslak uygulamasını (Windows 10'da) program aracılığıyla başlatmanıza ve ek açıklama için bu uygulamada belirli bir görüntüyü açmanıza olanak tanır.

ms-screensketch : aşağıdaki parametreleri alır:

Parametre Tür Gerekli Açıklama
paylaşılan erişim belirteci dizgi Hayır Açılacak dosyayı tanımlayan belirteç. SharedStorageAccessManager.AddFileüzerinden alınmıştır. Bu parametre atlanırsa, uygulama bir dosya açık olmadan başlatılır.
secondarySharedAccessToken karakter dizisi Hayır Ekran alıntısıyla ilgili meta verileri içeren bir JSON dosyasını tanımlayan dize. Meta veriler x,y koordinatları dizisine sahip bir clipPoints alanı ve/veya userActivityiçerebilir.
kaynak dizgi Hayır URI'yi başlatan kaynağı belirten serbest biçimli bir dize.
geçiciMi Boolean Hayır Doğru olarak ayarlanırsa Ekran Alıntısı Aracı dosyayı açtıktan sonra silmeyi dener.

Aşağıdaki örnek, kullanıcının uygulamasından Ekran Alıntısı Aracı'na görüntü göndermek için LaunchUriAsync yöntemini çağırır.

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

Aşağıdaki örnekte, ms-screensketchsecondarySharedAccessToken parametresi tarafından belirtilen bir dosyanın ne içerebileceği gösterilmektedir:

{
  "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\"}"
}

İlgili içerik

URI ile Bir Windows uygulaması başlatma