Freigeben über


IInkCollector::get_MarginY-Methode (msinkaut.h)

Ruft den Rand der y-Achse um das Fensterrechteck in Bildschirmkoordinaten ab oder legt diese fest.

Dieser Rand stellt einen Puffer um den Rand des Freihandfensters bereit.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_MarginY(
  long *MarginY
);

Parameter

MarginY

Rückgabewert

Keine

Bemerkungen

Diese Eigenschaft wird am häufigsten bei nicht integrierten Tablet-Geräten verwendet. Der Puffer bietet Benutzern eine Fehlerspanne beim Schreiben auf einem Gerät, das dem Bildschirm möglicherweise nicht 1 bis 1 zugeordnet ist.

Der Rand wird in Bildschirmkoordinaten angegeben. Eine positive Marge erstreckt sich außerhalb des Kontexts, eine negative Marge erstreckt sich innerhalb des Kontexts, und ein Wert von null erzeugt keine Marge. Freihand wird gesammelt, wenn der Strich innerhalb des Rands beginnt. Dieses Verhalten klammert die Freihand nicht aus. Der Kontext des Objekts oder Steuerelements ist entweder das Fenstereingaberechteck der GetWindowInputRectangle-Methode oder das Clientrechteck für das Fenster.

Der Rand ist nur innerhalb des Anwendungsfensters wirksam. Wenn der Stift außerhalb des Anwendungsfensters angewendet wird, verliert die Anwendung den Fokus und kann keine Freihandeingaben sammeln.

Hinweis Das InkCollector-Objekt , das InkOverlay-Objekt oder das InkPicture-Steuerelement muss deaktiviert werden, bevor diese Eigenschaft festgelegt wird. Um das InkCollector - oder InkOverlay-Objekt zu deaktivieren, legen Sie die Enabled-Eigenschaft auf FALSE fest. Um Freihandeingaben im InkOverlay-Steuerelement zu deaktivieren, legen Sie die InkEnabled-Eigenschaft auf FALSE fest. Anschließend können Sie die MarginY-Eigenschaft festlegen und das Objekt oder Steuerelement erneut aktivieren, indem Sie die Enabled-Eigenschaft (oder die InkEnabled-Eigenschaft ) auf TRUE festlegen.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile msinkaut.h
Bibliothek InkObj.dll

Weitere Informationen

Enabled-Eigenschaft

IInkCollector

InkCollector-Klasse

InkEnabled-Eigenschaft

MarginX-Eigenschaft