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
}