Stroke.SetPacketValuesByProperty 메서드 (Guid, array<Int32[])

아티클
10/28/2008

업데이트: 2007년 11월

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 식별자입니다. 이 Stroke 개체에 정의된 속성을 확인하려면 PacketDescription 속성을 사용합니다.

packetValues
형식: array<System.Int32[]
패킷 데이터 값의 배열입니다. 배열에 속성의 최소값이나 최대값에서 벗어나는 값이 하나라도 있으면 메서드가 실패합니다. 속성의 값 범위를 확인하려면 GetPacketDescriptionPropertyMetrics 메서드를 호출합니다.

반환 값

형식: System.Int32
실제로 설정된 패킷 수를 반환합니다.

설명

모든 패킷이 수정됩니다.

packetValues 배열의 길이가 잘못된 경우 이 메서드는 예외를 throw합니다.

예제

이 예제에서는 NormalPressure 패킷이 항상 스트로크의 점 전체에서 증가하거나 일정하게 유지되도록 InkOverlay 개체의 선택된 각 Stroke 개체를 수정합니다.

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
}