Partager via

Lancer la capture d’écran

  • Article

Les schémas d’URI ms-screenclip : et ms-screensketch : vous permettent de démarrer la capture d'écrans ou de modifier les captures d'écrans existantes.

Ouvrir un nouveau snip à partir de votre application

Le ms-screenclip : URI permet à votre application d’ouvrir et de démarrer automatiquement un nouveau snip. Le snip résultant est copié dans le presse-papiers de l’utilisateur, mais n’est pas automatiquement renvoyé à l'application initiale.

ms-screenclip : prend les paramètres suivants :

Paramètre Type Obligatoire Description
source corde Non Chaîne de forme libre pour indiquer la source qui a lancé l’URI.
type corde 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’un nouveau snip. Les valeurs prises en charge sont les suivantes : instantané, enregistrement*
mode de découpage corde Non Valeur de chaîne permettant d’indiquer le type de découpage pour le snip. Les valeurs prises en charge sont les suivantes : Rectangle, Forme libre, Fenêtre
délaiEnSecondes Int Non 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 capture d’écran.
callbackformat corde Non Ce paramètre n’est pas disponible.

* type=recording est disponible uniquement sur les PC Windows 11 avec L’outil de 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

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

ms-screensketch : prend les paramètres suivants :

Paramètre Type Obligatoire Description
jeton d'accès partagé corde 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 corde Non Chaîne identifiant un fichier JSON avec des métadonnées sur le snip. Les métadonnées peuvent inclure un champ clipPoints avec un tableau de coordonnées x,y et/ou un userActivity.
source corde Non Chaîne de forme libre pour indiquer la source qui a lancé l’URI.
estTemporaire Bool Non Si la valeur est True, l’outil Snipping tente de supprimer le fichier après l’avoir ouvert.

L’exemple suivant appelle la méthode LaunchUriAsync pour envoyer une image à Snipping Tool à 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\"}"
}

Contenu connexe

Lancer une application Windows avec un URI