RealTimeStylus.GetStyluses-Methode
Gibt das Array der vom RealTimeStylus übergebenen Stylus-Objekte zurück.
Namespace: Microsoft.StylusInput
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)
Syntax
'Declaration
Public Function GetStyluses As Stylus()
'Usage
Dim instance As RealTimeStylus
Dim returnValue As Stylus()
returnValue = instance.GetStyluses()
public Stylus[] GetStyluses()
public:
array<Stylus^>^ GetStyluses()
public Stylus[] GetStyluses()
public function GetStyluses() : Stylus[]
Rückgabewert
Typ: array<Microsoft.StylusInput.Stylus[]
Das Array der vom RealTimeStylus übergebenen Stylus-Objekte.
Hinweise
Wenn noch kein Stylus-Objekt auf den Tablet-Objekten gefunden wurde, die dem RealTimeStylus zugeordnet sind, dann gibt diese Methode ein leeres Array zurück.
Diese Methode löst eine Ausnahme aus, wenn der RealTimeStylus deaktiviert ist oder freigegeben wurde.
Beispiele
Dieses C#-Beispiel ist ein Ausschnitt aus dem Click-Ereignishandler eines Menüelements. Das Menü ist Teil eines Formulars, für das das TextBox-Objekt theTextBox definiert ist. Wenn das RealTimeStylus-Objekt deaktiviert ist, wird der Ereignishandler beendet. Andernfalls ruft der Ereignishandler die GetStyluses-Methode des RealTimeStylus-Objekts auf und zeigt Informationen zu jedem Tablettstift in theTextBox an. Die Hilfsmethode des Formulars, StylusDataToString, gibt ein String-Objekt zurück, das Informationen zu einem angegebenen Tablettstift enthält.
using Microsoft.Ink;
using Microsoft.StylusInput;
using Microsoft.StylusInput.PluginData;
// ...
// Declare the RealTimeStylus objects, the GestureRecognizer plugin,
// and the DynamicRenderer plug-in.
private Microsoft.StylusInput.RealTimeStylus thePrimaryRealTimeStylus = null;
private Microsoft.StylusInput.RealTimeStylus theSecondaryRealTimeStylus = null;
private Microsoft.StylusInput.GestureRecognizer theGestureRecognizer = null;
private Microsoft.StylusInput.DynamicRenderer theDynamicRenderer = null;
// ...
// The GetStyluses menu item's ClickEventHandler
private void theMenuItemGetStyluses_Click(object sender, System.EventArgs e)
{
// Can not call this method while the RealTimeStylus is disabled.
if (!this.thePrimaryRealTimeStylus.Enabled)
{
MessageBox.Show("The GetStyluses method of the RealTimeStylus can only be called while the RealTimeStylus is enabled.");
return;
}
this.theTextBox.Text = "The Styluses encountered so far:" + Environment.NewLine;
foreach (Stylus theStylus in this.thePrimaryRealTimeStylus.GetStyluses())
{
this.theTextBox.Text +=
this.StylusDataToString(theStylus) + Environment.NewLine;
}
}
Plattformen
Windows Vista, Windows XP SP2, Windows Server 2003
.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