InkSynchronizer.BeginDry 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

Initiiert eine benutzerdefinierte "Dry" der Freihandeingabe im Direct2D-Gerätekontext Ihrer App anstelle des InkCanvas-Standardsteuerelements . Dazu ist ein IInkD2DRenderer-Objekt erforderlich, um die Freihandeingabe zu verwalten (siehe Beispiel für komplexe Freihandeingaben).

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).

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.

public:
 virtual IVectorView<InkStroke ^> ^ BeginDry() = BeginDry;

IVectorView<InkStroke> BeginDry();

public IReadOnlyList<InkStroke> BeginDry();

function beginDry()

Public Function BeginDry () As IReadOnlyList(Of InkStroke)

Gibt zurück

IVectorView<InkStroke>

IReadOnlyList<InkStroke>

Die Auflistung von "nassen" Freihandstrichen, die an das IInkD2DRenderer-Objekt übergeben werden sollen.

Hinweise

Fehlercodes

E_ILLEGAL_METHOD_CALL (0x8000000E)

Wird ausgelöst, wenn BeginDry erneut aufgerufen wird, bevor EndDry aufgerufen wird.

Gilt für:

Freigeben über