TabletPropertyMetrics, structure

Article
11/05/2008

Mise à jour : November 2007

Définit la plage et la résolution d'une propriété de paquet.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Structure TabletPropertyMetrics
'Utilisation
Dim instance As TabletPropertyMetrics

public struct TabletPropertyMetrics

public value class TabletPropertyMetrics

public final class TabletPropertyMetrics extends ValueType

JScript prend en charge l'utilisation de structures mais pas la déclaration de nouvelles structures.

Notes

Lorsque vous appelez la méthode Tablet.GetPropertyMetrics ou Stroke.GetPacketDescriptionPropertyMetrics, vous créez une structure TabletPropertyMetrics.

Exemples

Dans cet exemple, chaque objet Stroke sélectionné d'un objet InkOverlay est modifié afin que chaque point de la seconde moitié du trait contienne la valeur de paquet NormalPressure maximale autorisée.

Les valeurs de paquet NormalPressure pour la seconde moitié de l'objet Stroke sont obtenues à l'aide de la méthode GetPacketValuesByProperty. Les valeurs sont ensuite définies sur le maximum autorisé (tel qu'obtenu par la méthode GetPacketDescriptionPropertyMetrics) et sont réappliquées au trait à l'aide de la méthode SetPacketValuesByProperty.

Try
    For Each S As Stroke In mInkOverlay.Selection
        ' get the PacketProperty.NormalPressure metrics for the stroke
        Dim metrics As TabletPropertyMetrics = S.GetPacketDescriptionPropertyMetrics(PacketProperty.NormalPressure)
        ' get the starting point
        Dim startPt As Integer = S.PacketCount / 2
        ' get the NormalPressure values starting at startPt
        Dim npValues() As Integer = S.GetPacketValuesByProperty(PacketProperty.NormalPressure, startPt)
        ' set the NormalPressure values to max
        For k As Integer = 0 To npValues.Length - 1
            npValues(k) = metrics.Maximum
        Next
        ' set the NormalPressure values starting at startPt
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, startPt, 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 PacketProperty.NormalPressure metrics for the stroke
        TabletPropertyMetrics metrics = S.GetPacketDescriptionPropertyMetrics(PacketProperty.NormalPressure);
        // get the starting point
        int startPt = S.PacketCount / 2;
        // get the NormalPressure values starting at startPt
        int[] npValues = S.GetPacketValuesByProperty(PacketProperty.NormalPressure, startPt);
        // set the NormalPressure values to max
        for (int k = 0; k < npValues.Length; k++)
        {
            npValues[k] = metrics.Maximum;
        }
        // set the NormalPressure values starting at startPt
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, startPt, 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
}

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.