Запуск фрагмента экрана

Ms-screenclip: и ms-screenketch: схемы URI позволяют инициировать фрагменты экрана или редактировать снимки экрана.

Открытие нового фрагмента из приложения

Ms-screenclip : URI позволяет приложению автоматически открывать и запускать новый фрагмент. Полученный фрагмент копируется в буфер обмена пользователя, но не автоматически передается в открывающееся приложение.

ms-screenclip: принимает следующие параметры:

Параметр	Type	Обязательно	Описание
source	строка	no	Строка свободной формы, указывающая источник, запускающий универсальный код ресурса (URI).
type	строка	no	Строковое значение, указывающее, какой особый тип записи запрашивается. Этот параметр может быть опущен при запуске нового фрагмента кода. Поддерживаемые значения: моментальный снимок, запись*
clippingMode	строка	no	Строковое значение, указывающее тип вырезки для фрагмента кода. Поддерживаемые значения: Прямоугольник, Freeform, Window
delayInSeconds	INT	no	Целочисленное значение от 1 до 30. Указывает задержку в полных секундах между вызовом URI и началом фрагмента кода ресурса (URI).
callbackformat	строка	no	Этот параметр недоступен.

* type=recording доступен только на компьютерах с Windows 11 с помощью средства Snipping версии 11.2307 или более поздней, и только если обработчик по умолчанию для ms-screenclip имеет значение "Snipping Tool" вместо "Вырезка экрана".

Запуск средства фрагмента или фрагмента приложения и эскиза

Ms-screensketch : URI позволяет программно запустить приложение средства Snipping (в Windows 11) или приложение Snip & Sketch (в Windows 10) и открыть определенное изображение в этом приложении для заметки.

ms-screensketch: принимает следующие параметры:

Параметр	Type	Обязательно	Описание
sharedAccessToken	строка	no	Маркер, определяющий файл, который нужно открыть. Извлекается из Shared служба хранилища AccessManager.AddFile. Если этот параметр опущен, приложение будет запущено без открытия файла.
secondarySharedAccessToken	строка	no	Строка, определяющая JSON-файл с метаданными о фрагменте кода. Метаданные могут содержать поле clipPoints с массивом координат x,y и (или) userActivity.
source	строка	no	Строка свободной формы, указывающая источник, запускающий универсальный код ресурса (URI).
isTemporary	bool	no	Если задано значение True, средство Snipping попытается удалить файл после открытия файла.

В следующем примере вызывается метод LaunchUriAsync для отправки изображения в Snipping Tool из приложения пользователя.

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

В следующем примере показано, что файл, указанный параметром secondarySharedAccessToken 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\"}"
}