Das kaskadierte RealTimeStylus-Modell
Mit dem kaskadierten RealTimeStylus-Modell können Sie zwei RealTimeStylus-Objekte verwenden, die jeweils in einem anderen Thread ausgeführt werden. Mit diesem Modell fügen Sie ein sekundäres RealTimeStylus-Objekt an ein primäres RealTimeStylus-Objekt an. Das sekundäre RealTimeStylus-Objekt wird als einziges asynchrones Plug-In in der asynchronen Plug-In-Auflistung des primären RealTimeStylus-Objekts angefügt.
Das kaskadierte RealTimeStylus-Modell kann in den folgenden Szenarien nützlich sein.
- Sie können der synchronen Plug-In-Auflistung des sekundären RealTimeStylus-Objekts bestimmte Aufgaben hinzufügen, die möglicherweise rechenintensiv sind, aber dennoch Echtzeitzugriff auf den Datenstrom des Tablet-Stifts erfordern, z. B. die Erkennung mehrerer Gesten.
- Sie können die Rechenlast Ihrer synchronen Plug-Ins auf zwei Threads verteilen, wodurch Verzögerungen bei der Freihandsammlung auf einigen Tablet-PCs verringert werden.
Das folgende Diagramm veranschaulicht den Fluss von Tablet-Stiftdaten durch zwei kaskadierte RealTimeStylus-Objekte und deren Plug-In-Auflistungen.
In diesem Diagramm stellt der Kreisbuchstaben "A" Tablet-Stiftdaten dar, die bereits von den primären und sekundären RealTimeStylus-Objekten verarbeitet wurden und in der Ausgabewarteschlange des sekundären RealTimeStylus-Objekts platziert wurden. Der Kreisbuchstaben "B" stellt Tablet-Stiftdaten dar, die bereits vom primären RealTimeStylus-Objekt verarbeitet und der Ausgabewarteschlange des primären RealTimeStylus-Objekts hinzugefügt wurden und noch nicht an das sekundäre RealTimeStylus-Objekt gesendet wurden. Der Kreisbuchstaben "C" stellt die Tablet-Stiftdaten dar, die das primäre RealTimeStylus-Objekt derzeit verarbeitet. Sie wird an die synchrone Plug-In-Auflistung gesendet und in der Ausgabewarteschlange platziert. Der leere Kreis stellt die Position in der Ausgabewarteschlange dar, an der zukünftige Tablet-Stiftdaten hinzugefügt werden.
Einschränkungen
Wenn Sie den Standard-RealTimeStylus-Konstruktor verwenden, erstellen Sie ein RealTimeStylus-Objekt , das nur Eingaben von einem anderen RealTimeStylus-Objekt akzeptieren kann.
In der folgenden Liste werden die Einschränkungen beschrieben, die der Verwendung des kaskadierten RealTimeStylus-Modells zugeordnet sind.
- Es können nur zwei RealTimeStylus-Objekte verwendet werden, ein primäres RealTimeStylus-Objekt und ein sekundäres RealTimeStylus-Objekt .
- Das primäre RealTimeStylus-Objekt muss mit einem Konstruktor erstellt werden, der den angefügtenControl- oder handle-Parameter verwendet. Das sekundäre RealTimeStylus-Objekt muss mit dem Konstruktor ohne Argument erstellt werden.
- Das sekundäre RealTimeStylus-Objekt muss das einzige asynchrone Plug-In in der asynchronen Plug-In-Auflistung des primären RealTimeStylus-Objekts sein.
- Ein sekundäres RealTimeStylus-Objekt kann jeweils nur an ein primäres RealTimeStylus-Objekt angefügt werden. Wenn es einem zweiten primären RealTimeStylus-Objekt hinzugefügt wird, löst die Add-Methode eine Ausnahme aus, und das sekundäre RealTimeStylus-Objekt wird nicht an das zweite primäre RealTimeStylus-Objekt angefügt.
- Das Verhalten einiger Elemente des sekundären RealTimeStylus-Objekts wird geändert. In der folgenden Tabelle wird das geänderte Verhalten dieser Member beschrieben.
| Mitglied | Verhalten |
|---|---|
| GetDesiredPacketDescription | Diese Methode gibt die Informationen aus dem primären RealTimeStylus-Objekt zurück. Wenn das sekundäre RealTimeStylus nicht an ein primäres RealTimeStylus-Objekt angefügt ist, gibt diese Methode den Standardwert zurück. |
| SetDesiredPacketDescription | Diese Methode löst eine InvalidOperationException-Ausnahme aus. |
| GetStyluses | Diese Methode gibt die Informationen aus dem primären RealTimeStylus-Objekt zurück. Wenn das sekundäre RealTimeStylus nicht an ein primäres RealTimeStylus-Objekt angefügt ist, gibt diese Methode ein leeres Array zurück. |
| Aktiviert | Beim Abrufen dieser Eigenschaft werden die Informationen aus dem primären RealTimeStylus-Objekt zurückgegeben. Wenn das sekundäre RealTimeStylus nicht an ein primäres RealTimeStylus-Objekt angefügt ist, gibt das Abrufen dieser Eigenschaft den Standardwert zurück. Hinweis: Durch Festlegen dieser Eigenschaft wird eine InvalidOperationException-Ausnahme ausgelöst. |
| WindowInputRectangle | Beim Abrufen dieser Eigenschaft werden die Informationen aus dem primären RealTimeStylus-Objekt zurückgegeben. Wenn das sekundäre RealTimeStylus nicht an ein primäres RealTimeStylus-Objekt angefügt ist, gibt das Abrufen dieser Eigenschaft den Standardwert zurück. Hinweis: Durch Festlegen dieser Eigenschaft wird eine InvalidOperationException-Ausnahme ausgelöst. |
- Es wird erwartet, dass das übergeordnete RealTimeStylus-Objekt nicht mehr funktioniert, wenn das untergeordnete RealTimeStylus-Objekt verworfen wird.