Stroke.SetPacketValuesByProperty メソッド (Guid, array<Int32[])

[アーティクル]
10/28/2008

Stroke オブジェクト内のすべてのパケットの指定されたパケットプロパティのデータを設定します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Function SetPacketValuesByProperty ( _
    id As Guid, _
    packetValues As Integer() _
) As Integer
'使用
Dim instance As Stroke
Dim id As Guid
Dim packetValues As Integer()
Dim returnValue As Integer

returnValue = instance.SetPacketValuesByProperty(id, _
    packetValues)

public int SetPacketValuesByProperty(
    Guid id,
    int[] packetValues
)

public:
int SetPacketValuesByProperty(
    Guid id, 
    array<int>^ packetValues
)

public int SetPacketValuesByProperty(
    Guid id,
    int[] packetValues
)

public function SetPacketValuesByProperty(
    id : Guid, 
    packetValues : int[]
) : int

パラメータ

id
型 : System.Guid
設定するパケットデータの選択に使用される PacketProperty オブジェクトの Guid 識別子。PacketDescription プロパティを使用して、この Stroke オブジェクトの定義されたプロパティを確認します。

packetValues
型 : array<System.Int32[]
パケットデータ値の配列。このメソッドは、配列内の値のいずれかが、プロパティの最小値または最大値を超えた場合は失敗します。プロパティ内の値の範囲を確認するには、GetPacketDescriptionPropertyMetrics メソッドを呼び出します。

戻り値

型 : System.Int32
設定されたパケットの実際の数を返します。

解説

すべてのパケットが変更されます。

packetValues 配列が不正な長さの場合、このメソッドは例外をスローします。

例

この例では、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
}