Stroke.GetPacketValuesByProperty 메서드 (Guid, Int32)

아티클
11/04/2008

업데이트: 2007년 11월

Stroke 개체의 패킷 하나에 대한 지정된 패킷 속성 데이터를 반환합니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public Function GetPacketValuesByProperty ( _
    id As Guid, _
    index As Integer _
) As Integer()
‘사용 방법
Dim instance As Stroke
Dim id As Guid
Dim index As Integer
Dim returnValue As Integer()

returnValue = instance.GetPacketValuesByProperty(id, _
    index)

public int[] GetPacketValuesByProperty(
    Guid id,
    int index
)

public:
array<int>^ GetPacketValuesByProperty(
    Guid id, 
    int index
)

public int[] GetPacketValuesByProperty(
    Guid id,
    int index
)

public function GetPacketValuesByProperty(
    id : Guid, 
    index : int
) : int[]

매개 변수

id
형식: System.Guid
검색할 패킷 데이터를 선택하는 데 사용되는 PacketProperty 개체의 Guid 식별자입니다.

index
형식: System.Int32
Stroke 개체 내에서 패킷에 대해 0부터 시작하는 인덱스의 시작점입니다.

반환 값

형식: array<System.Int32[]
Stroke 개체의 요청된 각 점에 대한 요청된 PacketProperty 개체의 값을 나타내는 부호 있는 32비트 정수 배열을 반환합니다.

설명

Stroke 개체에 따라 특정 패킷 속성을 사용할 수 없을 수도 있습니다. Tablet PC에 사용자가 입력하는 태블릿이 둘 이상 있을 수 있습니다. Tablets 컬렉션에는 Tablet PC에 연결된 모든 태블릿의 목록이 들어 있습니다. 해당 패킷 속성이 특정 Tablet 개체에서 지원되는지 또는 사용 가능한 모든 태블릿에서 지원되는지 확인하려면 IsPacketPropertySupported 메서드를 사용합니다. 또한 InkCollector.DesiredPacketDescription, InkOverlay.DesiredPacketDescription 또는 InkPicture.DesiredPacketDescription 속성을 사용하여 새 스트로크에서 수집할 패킷 속성을 제어합니다.

예제

이 예제에서는 InkOverlay 개체의 선택된 Stroke 개체를 각각 수정하여 스트로크의 뒤쪽 절반에 있는 각 점에 허용되는 최대 NormalPressure 패킷 값을 포함시킵니다.

GetPacketValuesByProperty 메서드를 사용하여 Stroke 개체의 뒤쪽 절반에 대한 NormalPressure 패킷 값을 가져옵니다. 그런 다음 GetPacketDescriptionPropertyMetrics 메서드를 통해 가져온 허용되는 최대값으로 설정하고 SetPacketValuesByProperty 메서드를 사용하여 스트로크에 값을 다시 적용합니다.

Try
    For Each S As Stroke In mInkOverlay.Selection
        ' get the PacketProperty.NormalPressure metrics for the stroke
        Dim metrics As TabletPropertyMetrics = S.GetPacketDescriptionPropertyMetrics(PacketProperty.NormalPressure)
        ' get the starting point
        Dim startPt As Integer = S.PacketCount / 2
        ' get the NormalPressure values starting at startPt
        Dim npValues() As Integer = S.GetPacketValuesByProperty(PacketProperty.NormalPressure, startPt)
        ' set the NormalPressure values to max
        For k As Integer = 0 To npValues.Length - 1
            npValues(k) = metrics.Maximum
        Next
        ' set the NormalPressure values starting at startPt
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, startPt, 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 PacketProperty.NormalPressure metrics for the stroke
        TabletPropertyMetrics metrics = S.GetPacketDescriptionPropertyMetrics(PacketProperty.NormalPressure);
        // get the starting point
        int startPt = S.PacketCount / 2;
        // get the NormalPressure values starting at startPt
        int[] npValues = S.GetPacketValuesByProperty(PacketProperty.NormalPressure, startPt);
        // set the NormalPressure values to max
        for (int k = 0; k < npValues.Length; k++)
        {
            npValues[k] = metrics.Maximum;
        }
        // set the NormalPressure values starting at startPt
        S.SetPacketValuesByProperty(PacketProperty.NormalPressure, startPt, 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
}