InkPresenter.ActivateCustomDrying Methode

Referenz

Definition

Namespace:: Windows.UI.Input.Inking

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Gibt an, dass Ihre App eine vollständige Kontrolle über das Rendering von Freihandeingaben erfordert.

Standardmäßig werden Freihandeingaben in einem Hintergrundthread mit geringer Wartezeit verarbeitet und während des Zeichnens „nass“ gerendert. Wenn der Strich abgeschlossen ist (Stift oder Finger angehoben oder Maustaste freigegeben), wird der Strich im UI-Thread verarbeitet und in die Renderingebene "trocken" gerendert (oberhalb des Anwendungsinhalts und ersetzen die nasse Freihand).

InkPresenter-Hostingmodelle

InkCanvas

Eine App erstellt durch Aufruf von ActivateCustomDrying (vor dem Laden des InkCanvas-Steuerelements) ein InkSynchronizer-Objekt, um zu definieren, wie ein letzter Strich trocken in einer SurfaceImageSource- oder VirtualSurfaceImageSource-Klasse gerendert wird. Beispielsweise kann ein letzter Strich gerastert und in den Anwendungsinhalt integriert werden, statt auf einer separaten InkCanvas-Ebene gerendert zu werden.

InkDesktopHost (Windows 10 Version 1511 und höher)

Win32-Apps können einen InkPresenter in einem InkDesktopHost mithilfe der visuellen Struktur "DirectComposition" hosten.

Dazu ist ein IInkD2DRenderer-Objekt erforderlich, um die Freihandeingabe zu verwalten (siehe Beispiel für komplexe Freihandeingaben).

CoreInkPresenterHost (Windows 10 Fall Creators Update und neuer)

Hosten Sie eine InkPresenter-Datei in Ihrem eigenen Windows.BENUTZEROBERFLÄCHE.Kompositionsstruktur ohne zugeordnetes InkCanvas-Steuerelement .

public:
 virtual InkSynchronizer ^ ActivateCustomDrying() = ActivateCustomDrying;

InkSynchronizer ActivateCustomDrying();

public InkSynchronizer ActivateCustomDrying();

function activateCustomDrying()

Public Function ActivateCustomDrying () As InkSynchronizer

Gibt zurück

InkSynchronizer

Das Objekt, das für das Rendering benutzerdefinierter Freihandstriche verwendet wird.

Hinweise

Fehlercodes

E_ILLEGAL_METHOD_CALL (0x8000000E)

Wird ausgelöst, wenn ActivateCustomDrying aufgerufen wird, nachdem InkCanvas geladen wurde.

Diese Methode muss vor dem Laden der InkCanvas aufgerufen werden.

Benutzerdefinierte Trocknung und die InkToolbar
Standardmäßig werden Freihandeingaben in einem Hintergrundthread mit geringer Wartezeit verarbeitet und während des Zeichnens „nass“ gerendert. Wenn der Strich abgeschlossen ist (der Stift oder Finger wurde angehoben oder die Maustaste losgelassen), wird er im UI-Thread verarbeitet und auf der InkCanvas-Ebene „trocken“ gerendert (über dem Anwendungsinhalt, wo er die nasse Freihandeingabe ersetzt). Die Freihandplattform ermöglicht es Ihnen, dieses Verhalten zu überschreiben und die Freihandfunktionen durch benutzerdefiniertes Trocknen der Freihandeingabe umfassend anzupassen.

Wenn Ihre App das Standardverhalten des Freihandrenderings von InkPresenter mit einer benutzerdefinierten Trocknungsimplementierung außer Kraft setzt, stehen die gerenderten Freihandstriche für die InkToolbar nicht mehr zur Verfügung, und die integrierten Löschbefehle der InkToolbar funktionieren nicht wie erwartet. Damit Sie Löschfunktionen bereitstellen können, müssen Sie alle Zeigerereignisse verarbeiten, für jeden Strich einen Treffertest ausführen und den integrierten Befehl „Freihand vollständig löschen“ außer Kraft setzen.

Weitere Informationen zum benutzerdefinierten Trocknen finden Sie unter Stiftinteraktionen und Windows Ink in UWP-Apps.

Gilt für:

Freigeben über