Stroke.GetPacketValuesByProperty (Método) (Guid)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve los datos para una propiedad de paquete especificada para todos los paquetes en el objeto Stroke.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Function GetPacketValuesByProperty ( _
    id As Guid _
) As Integer()
'Uso
Dim instance As Stroke
Dim id As Guid
Dim returnValue As Integer()

returnValue = instance.GetPacketValuesByProperty(id)

public int[] GetPacketValuesByProperty(
    Guid id
)

public:
array<int>^ GetPacketValuesByProperty(
    Guid id
)

public int[] GetPacketValuesByProperty(
    Guid id
)

public function GetPacketValuesByProperty(
    id : Guid
) : int[]

Parámetros

id
Tipo: System.Guid
Identificador Guid del objeto PacketProperty que se usa para seleccionar qué datos de paquete se van a recuperar.

Valor devuelto

Tipo: array<System.Int32[]
Devuelve una matriz de enteros de 32 bits firmados que especifica el valor del objeto PacketProperty solicitado para cada punto solicitado desde el objeto Stroke.

Comentarios

Puede ser que una propiedad de paquete concreta no esté disponible en un objeto Stroke determinado. Un Tablet PC puede tener más de una tableta para la entrada de datos del usuario. La colección Tablets contiene una lista de todas las tabletas asociada a Tablet PC. Use el método IsPacketPropertySupported para determinar si una propiedad de paquete concreta es compatible con un objeto Tablet específico o con todas las tabletas disponibles. Use, asimismo, las propiedades InkCollector.DesiredPacketDescription, InkOverlay.DesiredPacketDescription o InkPicture.DesiredPacketDescription para controlar qué propiedades de paquete se van a recopilar en los nuevos trazos.

Ejemplos

En este ejemplo, cada objeto Stroke seleccionado de un objeto InkOverlay se modifica para que el paquete NormalPressure siempre aumente o permanezca constante a lo largo de los puntos del trazo.

Con el método GetPacketValuesByProperty, se obtienen los valores de paquete NormalPressure para el objeto Stroke y se ordenan en orden ascendente. A continuación, los valores ordenados se vuelven a aplicar al trazo con el método SetPacketValuesByProperty.

Try
    For Each S As Stroke In mInkOverlay.Selection
        ' get the NormalPressure values
        Dim npValues() As Integer = S.GetPacketValuesByProperty(PacketProperty.NormalPressure)
        ' sort them
        Array.Sort(npValues)
        ' set the NormalPressure values
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, npValues)
    Next
Catch ex As ArgumentException
    ' This exception will be raised if PacketProperty.NormalPressure is not supported
    ' This will be the case if creating strokes with a mouse
End Try

try
{
    foreach (Stroke S in mInkOverlay.Selection)
    {
        // get the NormalPressure values
        int[] npValues = S.GetPacketValuesByProperty(PacketProperty.NormalPressure);
        // sort them
        Array.Sort(npValues);
        // set the NormalPressure values
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, npValues);
    }
}
catch (ArgumentException)
{
    // This exception will be raised if PacketProperty.NormalPressure is not supported
    // This will be the case if creating strokes with a mouse
}

Plataformas

Windows Vista

.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.