Stroke.GetPacketDescriptionPropertyMetrics (Método)

Artículo
10/28/2008

Actualización: noviembre 2007

Devuelve la métrica para un tipo de descripción de paquete determinado.

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

Sintaxis

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

returnValue = instance.GetPacketDescriptionPropertyMetrics(id)

public TabletPropertyMetrics GetPacketDescriptionPropertyMetrics(
    Guid id
)

public:
TabletPropertyMetrics GetPacketDescriptionPropertyMetrics(
    Guid id
)

public TabletPropertyMetrics GetPacketDescriptionPropertyMetrics(
    Guid id
)

public function GetPacketDescriptionPropertyMetrics(
    id : Guid
) : TabletPropertyMetrics

Parámetros

id
Tipo: System.Guid
Guid desde el objeto PacketProperty, que identifica la propiedad para la que se va a obtener la métrica.

Valor devuelto

Tipo: Microsoft.Ink.TabletPropertyMetrics
Devuelve la métrica para un tipo de descripción de paquete determinado.

Ejemplos

En este ejemplo, cada objeto Stroke seleccionado de un objeto InkOverlay se modifica de forma que cada punto de la segunda mitad del trazo contiene el valor de paquete NormalPressure máximo permitido.

Con el método GetPacketValuesByProperty, se obtienen los valores del paquete NormalPressure para la segunda mitad del objeto Stroke. Los valores se establecen, a continuación, en el máximo permitido (que se obtiene a través del método GetPacketDescriptionPropertyMetrics) y se aplican de nuevo al trazo mediante el método 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
}

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.