Metodo Stroke.GetPacketValuesByProperty (Guid)

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce i dati per una proprietà del pacchetto specificata per tutti i pacchetti nell'oggetto Stroke.

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

Sintassi

'Dichiarazione
Public Function GetPacketValuesByProperty ( _
    id As Guid _
) As Integer()
'Utilizzo
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[]

Parametri

id
Tipo: System.Guid
Identificatore Guid tratto dall'oggetto PacketProperty utilizzato per selezionare quali dati del pacchetto vengono recuperati.

Valore restituito

Tipo: array<System.Int32[]
Restituisce una matrice di valori integer con segno a 32 bit che specifica il valore dell'oggetto PacketProperty richiesto per ogni punto richiesto dall'oggetto Stroke.

Note

In un oggetto Stroke particolare, potrebbe non essere disponibile una proprietà del pacchetto specifica. Un Tablet PC può disporre di più di una tavoletta per l'input dell'utente. L'insieme Tablets contiene un elenco di tutte le tavolette associate al Tablet PC. Utilizzare il metodo IsPacketPropertySupported per determinare se una particolare proprietà del pacchetto è supportata da un oggetto Tablet specifico o da tutte le tavolette disponibili. Inoltre, utilizzare le proprietà InkCollector.DesiredPacketDescription, InkOverlay.DesiredPacketDescription o InkPicture.DesiredPacketDescription per controllare quali proprietà del pacchetto vengono raccolte nei nuovi tratti.

Esempi

In questo esempio, ogni oggetto Stroke selezionato di un oggetto InkOverlay viene modificato in modo che il pacchetto NormalPressure aumenti sempre o rimanga costante in tutti i punti del tratto.

Tramite il metodo GetPacketValuesByProperty si ottengono e vengono elencati in ordine crescente i valori del pacchetto NormalPressure per l'oggetto Stroke. I valori ordinati vengono quindi riapplicati al tratto tramite il metodo 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
}

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.