Freigeben über


InkOverlay.MarginY-Eigenschaft

Ruft die Breite der Ränder auf der y-Achse (in Pixel) ab oder legt diese fest.

Namespace:  Microsoft.Ink
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Property MarginY As Integer
'Usage
Dim instance As InkOverlay
Dim value As Integer

value = instance.MarginY

instance.MarginY = value
[BrowsableAttribute(true)]
public int MarginY { get; set; }
[BrowsableAttribute(true)]
public:
property int MarginY {
    int get ();
    void set (int value);
}
/** @property */
/** @attribute BrowsableAttribute(true) */
public int get_MarginY()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_MarginY(int value)
public function get MarginY () : int
public function set MarginY (value : int)

Eigenschaftenwert

Typ: System.Int32
Die Ränder auf der y-Achse (in Pixel).

Wert

Bedeutung

DefaultMargin-Eigenschaft

Das DefaultMargin-Feld des InkOverlay-Steuerelements.

Int32

Die von der Anwendung definierten Ränder auf der y-Achse.

Hinweise

Dieser Rand bietet einen Puffer um das Freihandfenster. Das DefaultMargin-Feld gibt den Standardrand an, der von der MarginY-Eigenschaft verwendet wird.

Diese Eigenschaft wird am häufigsten für nicht integrierte Tablettgeräte verwendet. Der Puffer bietet Benutzern eine Fehlertoleranz beim Schreiben auf einem Gerät, das möglicherweise der Größe des Anzeigebildschirms nicht direkt entspricht.

Ein positiver Rand geht über die Begrenzungen des InkOverlay-Objekts hinaus, ein negativer Rand wird innerhalb der Begrenzungen des Steuerelements erweitert, und der Wert 0 (null) erzeugt keinen Rand. Freihand wird erfasst, wenn der Strich innerhalb des Rands beginnt.

Mit diesem Verhalten wird die Freihandeingabe nicht abgeschnitten. Die Begrenzungen des Steuerelements sind entweder die GetWindowInputRectangle-Eigenschaft oder das Clientrechteck für das Fenster.

Der Rand ist nur im Fenster der Anwendung wirksam. Wenn der Stift außerhalb des Anwendungsfensters angewendet wird, verliert die Anwendung den Fokus, und Freihandeingaben können nicht mehr erfasst werden.

Hinweis

Die Erfassung der Freihandeingaben für das InkOverlay-Objekt muss vor dem Festlegen dieser Eigenschaft deaktiviert werden. Um die Erfassung von Freihandeingaben für das InkOverlay-Objekt zu deaktivieren, legen Sie die Enabled-Eigenschaft auf false fest. Anschließend können Sie die MarginY-Eigenschaft festlegen und die Erfassung von Freihandeingaben für das Steuerelement erneut aktivieren, indem Sie die Enabled-Eigenschaft auf true festlegen.

Beispiele

Im folgenden Beispiel wird der Rand entlang der y-Achse eines Fensterrechtecks für ein InkOverlay auf fünf Pixel festgelegt.

mInkOverlay.Enabled = False
mInkOverlay.MarginY = 5
mInkOverlay.Enabled = True
mInkOverlay.Enabled = false;
mInkOverlay.MarginY = 5;
mInkOverlay.Enabled = true;

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

InkOverlay-Klasse

InkOverlay-Member

Microsoft.Ink-Namespace

InkOverlay.DefaultMargin

InkOverlay.Enabled

InkOverlay.MarginX