Stroke.GetPacketValuesByProperty 方法 (Guid)

發行項
10/29/2008

傳回 Stroke 物件中所有封包所指定 packet 屬性的資料。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public Function GetPacketValuesByProperty ( _
    id As Guid _
) As Integer()
'用途
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[]

參數

id
型別：System.Guid
PacketProperty 物件中的 Guid 識別項，這個物件用來選取要擷取哪些封包資料。

傳回值

型別：array<System.Int32[]
傳回帶正負號的 32 位元整數的陣列，這個陣列針對向 Stroke 物件要求的每個點指定所要求 PacketProperty 物件的值。

備註

特定封包屬性可能無法用於特定 Stroke 物件。Tablet PC 可能有一個以上的使用者輸入手寫板。Tablets 集合包含 Tablet PC 中所有附加的手寫板清單。使用 IsPacketPropertySupported 方法可判斷特殊封包屬性是由特定 Tablet 物件或是所有可用的 Tablet 支援。此外，使用 InkCollector.DesiredPacketDescription、InkOverlay.DesiredPacketDescription 或 InkPicture.DesiredPacketDescription 屬性，控制在新筆劃上收集哪些封包屬性。

範例

在這個範例中，InkOverlay 物件的每個已選取 Stroke 物件都會經過修改，讓 NormalPressure 封包在筆劃各點中固定增加或保持為常數。

若使用 GetPacketValuesByProperty 方法，則會取得 Stroke 物件的 NormalPressure 封包值，並且依遞增順序排序。然後會使用 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
}