InkPresenter.ActivateCustomDrying Méthode

Référence

Définition

Espace de noms:: Windows.UI.Input.Inking

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Indique que votre application nécessite un contrôle total du rendu d’entrée manuscrite.

Par défaut, l’entrée manuscrite est traitée sur un thread d’arrière-plan de faible latence et restituée « humide » comme elle est dessinée. Une fois le trait terminé (stylet ou doigt levé, ou bouton de la souris relâché), le trait est traité sur le thread d’interface utilisateur et rendu « sec » dans la couche de rendu (au-dessus du contenu de l’application et en remplaçant l’encre humide).

Modèles d’hébergement InkPresenter

InkCanvas

En appelant ActivateCustomDrying (avant le chargement de InkCanvas), une application crée un objet InkSynchronizer pour personnaliser la manière dont un trait d’encre est restitué sec à un élément SurfaceImageSource ou VirtualSurfaceImageSource. Par exemple, un trait d’encre pourrait être rastérisé et intégré au contenu d’application plutôt que d’être intégré sous forme de couche InkCanvas distincte.

InkDesktopHost (Windows 10 version 1511 et ultérieure)

Les applications Win32 peuvent héberger un InkPresenter dans un InkDesktopHost à l’aide de l’arborescence visuelle DirectComposition.

Cela nécessite un objet IInkD2DRenderer pour gérer l’entrée manuscrite (voir l’exemple d’entrée manuscrite complexe).

CoreInkPresenterHost (Windows 10 Fall Creators Update et versions ultérieures)

Hébergez un InkPresenter dans votre propre Windows.UI.Arborescence de composition sans contrôle InkCanvas associé.

public:
 virtual InkSynchronizer ^ ActivateCustomDrying() = ActivateCustomDrying;

InkSynchronizer ActivateCustomDrying();

public InkSynchronizer ActivateCustomDrying();

function activateCustomDrying()

Public Function ActivateCustomDrying () As InkSynchronizer

Retours

InkSynchronizer

Objet utilisé pour le rendu des traits d’encre personnalisés.

Remarques

Codes d’erreur

E_ILLEGAL_METHOD_CALL (0x8000000E)

Levée si ActivateCustomDrying est appelé après le chargement d’InkCanvas .

Cette méthode doit être appelée avant de charger InkCanvas.

Séchage personnalisé et InkToolbar
Par défaut, l’entrée manuscrite est traitée sur un thread d’arrière-plan de faible latence et restituée « humide » comme elle est dessinée. Lorsque le trait est terminé (stylet ou doigt relevé, ou bouton de la souris relâché), le trait est traité sur le thread de l’interface utilisateur et restitué « sec » à la couche InkCanvas (au-dessus du contenu de l’application et en remplaçant l’encre humide). La plateforme d’entrée manuscrite vous permet de remplacer ce comportement et de personnaliser entièrement l’expérience d’entrée manuscrite par un séchage personnalisé de cette dernière.

Si votre application remplace le comportement de rendu d’entrée manuscrite par défaut d’InkPresenter par une implémentation de séchage personnalisée, les traits d’encre rendus ne sont plus disponibles pour InkToolbar et les commandes d’effacement intégrées d’InkToolbar ne fonctionnent pas comme prévu. Pour fournir des fonctionnalités d’effacement, vous devez gérer tous les événements de pointeur, effectuer le test de positionnement sur chaque trait et remplacer la commande intégrée « Effacer toutes les entrées manuscrites ».

Pour plus d’informations sur le séchage personnalisé, voir Interactions avec le stylet et Windows Ink dans les applications UWP.

S’applique à

Partager via