Metodo Stroke.GetPacketDescriptionPropertyMetrics

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce la metrica per un tipo di descrizione del pacchetto specifico.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Function GetPacketDescriptionPropertyMetrics ( _
    id As Guid _
) As TabletPropertyMetrics
'Utilizzo
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

Parametri

id
Tipo: System.Guid
Guid tratto dall'oggetto PacketProperty che identifica la proprietà per cui ottenere la metrica.

Valore restituito

Tipo: Microsoft.Ink.TabletPropertyMetrics
Restituisce la metrica per un tipo di descrizione del pacchetto specifico.

Esempi

In questo esempio, ogni oggetto Stroke selezionato di un oggetto InkOverlay viene modificato in modo che ogni punto della seconda metà del tratto contenga il valore massimo consentito del pacchetto NormalPressure.

Tramite il metodo GetPacketValuesByProperty si ottengono i valori del pacchetto NormalPressure per la seconda metà dell'oggetto Stroke. I valori vengono quindi impostati sul valore massimo consentito (ottenuto tramite il metodo GetPacketDescriptionPropertyMetrics) e riapplicati al tratto tramite il metodo 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
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.