Lancer la capture d’écran

Les schémas d’URI ms-screenclip: et ms-screenketch : vous permettent de lancer des captures d’écran ou de modifier des captures d’écran.

Ouvrir une nouvelle capture à partir de votre SPA

L’URI ms-screenclip : permet à votre SPA d’ouvrir et de démarrer automatiquement une nouvelle capture. La capture qui en résulte est copiée dans le presse-papiers de l’utilisateur, mais n’est pas automatiquement transférée à l’application d’ouverture.

ms-screenclip : utilise les paramètres suivants :

Paramètre	Type	Requise	Description
source	string	non	Chaîne de forme libre pour indiquer la source qui a lancé l’URI.
type	string	non	Valeur de chaîne pour indiquer quel type spécial de capture est demandé. Ce paramètre peut être omis lors du démarrage d’une nouvelle capture. Les valeurs prises en charge inlcuent : instantané, enregistrement*
clippingMode	string	non	Valeur de chaîne permettant d’indiquer le type de découpage pour la capture. Les valeurs prises en charge incluent : Rectangle, Forme libre, Fenêtre
delayInSeconds	int	non	Une valeur entière comprise entre 1 et 30. Spécifie le délai, en secondes complètes, entre l’appel d’URI et le début de la prise de capture.
callbackformat	string	non	Ce paramètre n’est pas disponible.

* type=recording est disponible uniquement sur les PC Windows 11 avec l’Outil Capture d’écran version 11.2307 ou ultérieure, et uniquement lorsque le gestionnaire par défaut pour ms-screenclip est défini sur « Outil de capture d’écran » au lieu de « Capture d’écran ».

Lancement de l’Outil Capture d’écran ou de l’application Snip & Sketch

Ms-screensketch: URI vous permet de lancer programmatiquement l’application Outil Capture d'écran (sur Windows 11) ou l’application Snip &Sketch (sur Windows 10) et d’ouvrir une image spécifique dans cette application pour l’annotation.

ms-screensketch : utilise les paramètres suivants :

Paramètre	Type	Requise	Description
sharedAccessToken	string	non	Jeton identifiant le fichier à ouvrir. Récupéré à partir de SharedStorageAccessManager.AddFile. Si ce paramètre est omis, l’application est lancée sans ouvrir de fichier.
secondarySharedAccessToken	string	non	Chaîne identifiant un fichier JSON avec des métadonnées sur la capture. Les métadonnées peuvent inclure un champ ClipPoints avec un tableau de coordonnées x,y et/ou userActivity.
source	string	non	Chaîne de forme libre pour indiquer la source qui a lancé l’URI.
isTemporary	bool	non	Si la valeur est True, l’outil Capture d’écran tente de supprimer le fichier après l’avoir ouvert.

L’exemple suivant appelle la méthode LaunchUriAsync pour envoyer une image à Outil Capture d'écran à partir de l’application de l’utilisateur.

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

L’exemple suivant illustre ce qu’un fichier spécifié par le paramètre secondarySharedAccessToken de ms-screensketch peut contenir :

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