RealTimeStylus.GetStyluses (Método)
Actualización: noviembre 2007
Devuelve la matriz de objetos Stylus que RealTimeStylus ha encontrado.
Espacio de nombres: Microsoft.StylusInput
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)
Sintaxis
'Declaración
Public Function GetStyluses As Stylus()
'Uso
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[]
Valor devuelto
Tipo: array<Microsoft.StylusInput.Stylus[]
Matriz de objetos Stylus que RealTimeStylus ha encontrado.
Comentarios
Si todavía no se ha detectado ningún objeto Stylus en los objetos Tablet asociados a RealTimeStylus, este método devuelve una matriz vacía.
Este método inicia una excepción cuando RealTimeStylus se deshabilita o se elimina.
Ejemplos
Este ejemplo de C# es un fragmento de código del controlador de evento Click de un elemento de menú. El menú forma parte de un formulario en el que se define un objeto TextBox, theTextBox. Si el objeto RealTimeStylus se deshabilita, se produce la salida del controlador de eventos. De lo contrario, el controlador de eventos llama el método GetStyluses del objeto RealTimeStylus y muestra información sobre cada lápiz de Tablet PC en theTextBox. El método auxiliar del formulario, StylusDataToString, devuelve un objeto String que contiene información sobre un lápiz determinado.
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;
}
}
Plataformas
Windows Vista, Windows XP SP2, Windows Server 2003
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Información de versión
.NET Framework
Compatible con: 3.0