InkCollector.MarginX-Eigenschaft
Ruft die Breite der Ränder auf der x-Achse (in Pixel) ab oder legt diese fest.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public Property MarginX As Integer
'Usage
Dim instance As InkCollector
Dim value As Integer
value = instance.MarginX
instance.MarginX = value
public int MarginX { get; set; }
public:
property int MarginX {
int get ();
void set (int value);
}
/** @property */
public int get_MarginX()
/** @property */
public void set_MarginX(int value)
public function get MarginX () : int
public function set MarginX (value : int)
Eigenschaftenwert
Typ: System.Int32
Die Ränder auf der x-Achse (in Pixel).
Wert |
Bedeutung |
|---|---|
DefaultMargin-Eigenschaft |
Das DefaultMargin-Feld des InkCollector-Steuerelements. |
Int32 |
Die von der Anwendung definierten Ränder auf der x-Achse. |
Hinweise
Dieser Rand bietet einen Puffer um das Freihandfenster. Das DefaultMargin-Feld gibt den Standardrand an, der von der MarginX-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 Grenzen des InkCollector-Objekts hinaus, ein negativer Rand wird innerhalb der Grenzen 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 Grenzen 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 InkCollector-Objekt muss vor dem Festlegen dieser Eigenschaft deaktiviert werden. Um die Erfassung von Freihandeingaben für das InkCollector-Objekt zu deaktivieren, legen Sie die Enabled-Eigenschaft auf false fest. Anschließend können Sie die MarginX-Eigenschaft festlegen und die Erfassung von Freihandeingaben für das Steuerelement erneut aktivieren, indem Sie die Enabled-Eigenschaft auf true festlegen. Alternativ können Sie SetWindowInputRectangle verwenden, um den Eingabebereich zu ändern, während das InkCollector-Objekt aktiviert ist.
Beispiele
Im folgenden Beispiel wird der Rand entlang der x-Achse eines Fensterrechtecks für ein InkCollector auf fünf Pixel festgelegt.
mInkCollector.Enabled = False
mInkCollector.MarginX = 5
mInkCollector.Enabled = True
mInkCollector.Enabled = false;
mInkCollector.MarginX = 5;
mInkCollector.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