InkOverlay-Klasse

Stellt ein Objekt dar, das für Anmerkungsszenarien nützlich ist, bei denen Es benutzern nicht darum geht, Freihanderkennung durchzuführen, sondern stattdessen an Größe, Form, Farbe und Position der Freihandfarbe interessiert ist.

Durch das Erstellen des InkOverlay-Steuerelements hinter einem transparenten Steuerelement (z. B. eine GroupBox mit festgelegter WS _ EX _ TRANSPARENT-Eigenschaft) wird verhindert, dass InkOverlay InkOverlay inkk erfasst.

InkOverlay verfügt über diese Typen von Membern:

Events

Die InkOverlay-Klasse verfügt über diese Ereignisse.

Ereignis BESCHREIBUNG
CursorButtonDown Tritt ein, wenn inkOverlay eine cursor-Schaltfläche erkennt, die nicht aktiv ist.
CursorButtonUp Tritt ein, wenn inkOverlay eine cursor-Schaltfläche erkennt, die aktiv ist.
Cursordown Tritt ein, wenn die Cursorspitze mit der digitalisierenden Tablettoberfläche in Kontakt tritt.
Cursorinrange Tritt ein, wenn ein Cursor in den physischen Erkennungsbereich (Näherung) des Tabletkontexts eintritt.
Cursoroutofrange Tritt ein, wenn der Cursor den physischen Erkennungsbereich (Nähe) des Tabletkontexts verlässt.
Doubleclick Tritt ein, wenn auf das InkOverlay-Objekt doppelklickt wird.
Geste Tritt ein, wenn eine anwendungsspezifische Geste erkannt wird.
Mousedown Tritt ein, wenn sich der Mauszeiger über dem InkOverlay-Objekt befindet und eine Maustaste gedrückt wird.
Mousemove Tritt ein, wenn der Mauszeiger über das InkOverlay-Objekt bewegt wird.
Mouseup Tritt ein, wenn sich der Mauszeiger über dem InkOverlay-Objekt befindet und eine Maustaste losgelassen wird.
Mousewheel Tritt ein, wenn das Mausrad bewegt wird, während das InkOverlay-Objekt den Fokus besitzt.
Newinairpackets Tritt ein, wenn ein In-Air-Paket angezeigt wird. Dies geschieht, wenn ein Benutzer einen Stift in der Nähe des Tabletts verschiebt und sich der Cursor im Fenster des InkOverlay-Objekts befindet oder der Benutzer eine Maus innerhalb des zugeordneten Fensters des InkOverlay-Objektobjekts bewegt.
Newpackets Tritt ein, wenn das InkOverlay-Objekt Pakete empfängt.
Gemalt Tritt ein, wenn das InkOverlay-Objekt die Neuzeichnung abgeschlossen hat.
Malerei Tritt ein, bevor sich das InkOverlay-Objekt neu gezeichnet hat.
SelectionChanged Tritt ein, wenn sich die Auswahl von Freihand innerhalb des Steuerelements geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, Prozeduren zum Ausschneiden und Einfügen oder die Selection-Eigenschaft.
Selectionchanging Tritt ein, wenn sich die Auswahl von Freihand innerhalb des Steuerelements ändert, z. B. durch Änderungen an der Benutzeroberfläche, Ausschneide- und Einfügeverfahren oder die Selection-Eigenschaft.
Selectionmoved Tritt ein, wenn sich die Position der aktuellen Auswahl geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, Prozeduren zum Ausschneiden und Einfügen oder die Selection-Eigenschaft.
Selectionmoving Tritt ein, wenn sich die Position der aktuellen Auswahl ändert, z. B. durch Änderungen an der Benutzeroberfläche, Prozeduren zum Ausschneiden und Einfügen oder die Selection-Eigenschaft.
Selectionresized Tritt ein, wenn sich die Größe der aktuellen Auswahl geändert hat, z. B. durch Änderungen an der Benutzeroberfläche, Prozeduren zum Ausschneiden und Einfügen oder die Selection-Eigenschaft.
Selectionresizing Tritt ein, wenn sich die Größe der aktuellen Auswahl ändert, z. B. durch Änderungen an der Benutzeroberfläche, Prozeduren zum Ausschneiden und Einfügen oder die Selection-Eigenschaft.
Takt Tritt ein, wenn der Benutzer mit dem Zeichnen eines neuen Strichs auf einem Tablet fertig ist.
Striche gelöscht Tritt ein, nachdem Striche aus der Ink-Eigenschaft gelöscht wurden.
StrokesDeleting Tritt ein, bevor Striche aus der Ink-Eigenschaft gelöscht werden.
Systemgesture Tritt ein, wenn eine Systemgeste erkannt wird.
Tabletadded Tritt ein, wenn dem System eine IInkTablet hinzugefügt wird.
Tabletremoved Tritt ein, wenn ein Tablet aus dem System entfernt wird.

Schnittstellen

Diese Schnittstellen werden von der InkOverlay-Klasse definiert.

Schnittstelle BESCHREIBUNG
IInkOverlay Dieses Objekt implementiert die IInkOverlay-COM-Schnittstelle.

Methoden

Die InkOverlay-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
Draw Legt ein Rechteck fest, in dem die Farbe innerhalb des InkOverlay-Objekts neu gezeichnet werden soll.
GetEventInterest Gibt den aktuellen Zustand eines bestimmten InkOverlay-Objektereignisses zurück, d. h., ob das Ereignis überwacht oder verwendet wird.
GetGestureStatus Gibt zurück, ob das InkOverlay-Objekt an einer bestimmten Geste interessiert ist.
GetWindowInputRectangle Ruft das Fensterrechteck in Pixel ab, in dem Ink gezeichnet wird.
HitTestSelection Bestimmt, welcher Teil der Auswahl während eines Treffertests erreicht wurde.
Setalltabletsmode In diesem Modus kann das InkOverlay-Objekt InkOverlay von jedem Tablet sammeln, das an den Tablet PC angefügt ist.
SetEventInterest Legt fest, ob ein bestimmtes Ereignis überwacht oder verwendet werden soll.
Setgesturestatus Legt das Interesse des InkOverlay-Objekts in einer bekannten Geste fest.
SetSingleTabletIntegratedMode In diesem Modus kann das InkOverlay-Objekt Nur InkOverlay von nur einem Tablet erfassen. Ink von anderen Tablets wird vom InkOverlay-Objekt ignoriert.
SetWindowInputRectangle Legt das Fensterrechteck in Pixel fest, das zum Zuordnen von gezeichneter Ink zum Fenster verwendet werden soll.

Eigenschaften

Die InkOverlay-Klasse verfügt über diese Eigenschaften.

Eigenschaft Zugriffstyp BESCHREIBUNG
AttachMode
Lesen/Schreiben
Ruft den Wert ab, der angibt, ob das InkOverlay-Objekt hinter oder vor dem bekannten Fenster angefügt wird, oder legt diesen fest.
Autoredraw
Lesen/Schreiben
Ruft einen Wert ab, der angibt, ob das InkOverlay die InkOverlay-Eigenschaft neu zeichnet, wenn das Fenster ungültig wird, oder legt diesen fest.
CollectingInk
Schreibgeschützt
Ruft einen Wert ab, der angibt, ob InkOverlay derzeit für ein InkOverlay-Objekt gezeichnet wird.
CollectionMode
Lesen/Schreiben
Ruft den Auflistungsmodus ab, der bestimmt, ob Ink-, Gesten- oder beides beim Schreiben durch den Benutzer erkannt wird, oder legt diesen fest.
Cursor
Schreibgeschützt
Ruft die Cursors-Auflistung ab, die für die Verwendung im Freiraumbereich verfügbar ist.
DefaultDrawingAttributes
Lesen/Schreiben
Ruft das Standardobjekt InkDrawingAttributes ab, das die Zeichnungsattribute angibt, die beim Zeichnen und Anzeigen von Ink verwendet werden, oder legt dieses fest.
DesiredPacketDescription
Lesen/Schreiben
Ruft das Interesse an Aspekten des Pakets ab, das dem im InkOverlay-Objekt gezeichneten InkOverlay-Objekt zugeordnet ist, oder legt dieses fest.
Dynamicrendering
Lesen/Schreiben
Ruft einen Wert ab, der angibt, ob ink beim Gezeichneten gerendert wird, oder legt diesen fest.
Editingmode
Lesen/Schreiben
Ruft einen Wert ab, der angibt, ob sich InkOverlay im InkOverlay-Modus, im Löschmodus oder im Auswahl-/Bearbeitungsmodus befindet, oder legt diesen fest.
Aktiviert
Lesen/Schreiben
Ruft einen Wert ab, der angibt, ob das InkOverlay-Objekt Stifteingaben sammelt, oder legt diesen fest.
EraserMode
Lesen/Schreiben
Ruft einen Wert ab, der angibt, ob die Ink-Datei per Strich oder Punkt gelöscht wird, oder legt diesen fest.
EraserWidth
Lesen/Schreiben
Ruft einen Wert ab, der die Breite der Radiererstiftspitze angibt, oder legt diesen fest.
Behandeln
Lesen/Schreiben
Ruft das Handle des Fensters ab, an das das InkOverlay-Objekt angefügt ist, oder legt dieses fest.
Freihand
Lesen/Schreiben
Ruft das InkDisp-Objekt ab, das dem InkOverlay-Objekt zugeordnet ist, oder legt dieses fest.
MarginX
Lesen/Schreiben
Ruft die Ränder entlang der X-Achse in Pixel ab oder legt sie fest.
MarginY
Lesen/Schreiben
Ruft die Ränder entlang der y-Achse in Pixel ab oder legt sie fest.
MouseIcon
Lesen/Schreiben
Ruft das aktuelle benutzerdefinierte Maussymbol ab oder legt es fest.
Mousepointer
Lesen/Schreiben
Ruft einen Wert ab, der den Typ des Mauszeigers angibt, der angezeigt wird, wenn sich die Maus über einem bestimmten Teil des Objekts befindet, oder legt diesen fest.
Renderer
Lesen/Schreiben
Ruft das InkRenderer-Objekt ab, das zum Zeichnen von Ink verwendet wird, oder legt dieses fest.
Auswahl
Lesen/Schreiben
Ruft die InkStrokes-Auflistung ab, die derzeit im InkOverlay-Steuerelement ausgewählt ist, oder legt sie fest.
SupportHighContrastInk
Lesen/Schreiben
Ruft einen Wert ab, der angibt, ob Ink als nur eine Farbe gerendert wird, wenn sich das System im hoher Kontrast befindet, oder legt diesen fest.
SupportHighContrastSelectionUI
Lesen/Schreiben
Ruft einen Wert ab, der angibt, ob die auswahlbenutzeroberfläche mit hohem Kontrast gezeichnet wird, wenn sich das System im hoher Kontrast befindet, oder legt ihn fest.
Tablet
Schreibgeschützt
Ruft das Tablettgerät ab, das das InkOverlay-Objekt derzeit zum Erfassen von Eingaben verwendet.

Hinweise zur MFC-Implementierung

Wenn Sie das InkOverlay-Objekt an ein CView-Objekt angefügt haben, geben Sie das InkOverlay-Objekt als Antwort auf die WM DESTROY-Nachricht frei, wie _ im folgenden Beispiel gezeigt:

BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
    if(WM_DESTROY == msg)
        m_spInkOverlay.Release();
    return CView::OnWndMsg(msg, wp, lp, pLR);
}

Bemerkungen

Dieses Objekt kann durch Aufrufen der CoCreateInstance-Methode in C++ instanziiert werden.

Das InkOverlay-Objekt eignet sich gut für die Notiznahme und einfaches Beschriften. Die primäre beabsichtigte Verwendung dieses Objekts ist die Anzeige von Ink als Ink.

Im Allgemeinen ist die Laufzeitbenutzeroberfläche für dieses Objekt ein transparentes Fenster mit nicht transparenter Ink-Oberfläche.

Die Ereignisse MouseDown, MouseMove, MouseUpund MouseWheel geben x-Koordinaten und y-Koordinaten in Pixel und nicht die HIMETRIC-Einheiten zurück, die dem Freiraum zugeordnet sind. Dies liegt daran, dass diese Ereignisse die Mausereignisse von Nicht-Stiftanwendungen ersetzen und diese Anwendungen nur Pixel verstehen.

Achtung

Wenn Sie die AttachMode-Eigenschaft des InkOverlay-Objekts auf InFront festlegen, erstellen Sie das InkOverlay-Objekt in dem Thread, in dem das Formular ausgeführt wird. Ihre Anwendung reagiert möglicherweise nicht mehr, wenn das InkOverlay-Objekt in einem anderen Thread erstellt und die AttachMode-Eigenschaft auf InFront festgelegt ist.

Hinweis

Das InkOverlay-Objekt kann nicht sicher in einem Nicht-UI-Thread freigegeben werden.

Um die Leistung Ihrer Anwendung zu verbessern, veräußern Sie das InkOverlay-Objekt, wenn es nicht mehr benötigt wird.

Wenn Sie das InkOverlay-Objekt an ein CView-Objekt angefügt haben, geben Sie das InkOverlay-Objekt als Antwort auf die WM DESTROY-Nachricht frei, wie _ im folgenden Beispiel gezeigt:

BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
    if(WM_DESTROY == msg)
        m_spInkOverlay.Release();
    return CView::OnWndMsg(msg, wp, lp, pLR);
}

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur Desktop-Apps der XP Tablet PC Edition []
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
Msinkaut.h (erfordert auch Msinkaut _ i.c)
Bibliothek
InkObj.dll

Weitere Informationen

InkCollector-Klasse

Referenz zum InkPicture-Steuerelement

InkEdit-Steuerelementreferenz