RealTimeStylus.GetDesiredPacketDescription 메서드

업데이트: 2007년 11월

RealTimeStylus 개체에서 관심도를 설정한 태블릿 컨텍스트에서 수집된 패킷을 나타내는 값 배열을 반환합니다.

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

구문

‘선언
Public Function GetDesiredPacketDescription As Guid()
‘사용 방법
Dim instance As RealTimeStylus
Dim returnValue As Guid()

returnValue = instance.GetDesiredPacketDescription()

public Guid[] GetDesiredPacketDescription()

public:
array<Guid>^ GetDesiredPacketDescription()

public Guid[] GetDesiredPacketDescription()

public function GetDesiredPacketDescription() : Guid[]

반환 값

형식: array<System.Guid[]
RealTimeStylus 개체에서 관심도를 설정한 패킷 속성의 GUID(Globally Unique Identifier)를 반환합니다.

설명

이 메서드를 사용하면 RealTimeStylus 개체에서 관심도를 설정한 패킷 속성의 배열을 가져올 수 있습니다. 패킷 속성은 GUID의 배열로 표현됩니다. PacketProperty 개체는 표준 패킷 속성 GUID를 정의하지만 다른 GUID도 사용할 수 있습니다.

RealTimeStylus 개체가 태블릿에서 잉크를 수집할 때 RealTimeStylus 개체는 GetDesiredPacketDescription 메서드의 반환 값에 나타난 대로 관심도가 설정되어 있으며 잉크를 수집하는 태블릿에서 지원되는 패킷 속성에 대한 패킷 데이터만 반환합니다. RealTimeStylus 개체에서 잉크 데이터를 처리하는 방법에 대한 자세한 내용은 Ink-Collection Plug-ins을를 참조하십시오.

RealTimeStylus 개체가 비활성화된 동안에만 SetDesiredPacketDescription 메서드를 호출할 수 있습니다. 그러나 SetDesiredPacketDescription 메서드를 호출한 결과는 GetDesiredPacketDescription 메서드의 반환 값에 즉시 반영됩니다.

다음 목록에서는 RealTimeStylus 개체에서 패킷 속성 GUID를 정렬하는 방법을 보여 줍니다.

GetDesiredPacketDescription 메서드는 배열의 처음 두 위치에 항상 PacketProperty.X 및 PacketProperty.Y GUID를 반환하며, 이전에 SetDesiredPacketDescription 메서드를 호출할 때 이러한 GUID가 지정되었는지 여부는 관계가 없습니다.
SetDesiredPacketDescription 메서드를 호출할 때 PacketProperty.PacketStatus GUID가 지정된 경우 GetDesiredPacketDescription 메서드는 PacketProperty.PacketStatus GUID를 항상 배열의 마지막 위치에 반환합니다.
SetDesiredPacketDescription 메서드를 호출할 때 두 번 이상 지정된 GUID가 있더라도 GetDesiredPacketDescription 메서드에서 반환하는 배열에는 각 GUID가 한 번씩만 나타납니다.
기본적으로 GetDesiredPacketDescription 메서드는 PacketProperty.X, PacketProperty.Y 및 PacketProperty.NormalPressure GUID를 반환합니다.

예를 들어 (a, b, a, PacketStatus, b, c, d)를 사용하여 SetDesiredPacketDescription 메서드를 호출하면 GetDesiredPacketDescription 메서드는 (X, Y, a, b, c, d, PacketStatus)를 반환합니다.

예제

이 C# 예제는 메뉴 항목의 Click 이벤트 처리기에서 가져온 코드 조각입니다. 메뉴는 TextBox 개체인 theTextBox가 정의된 폼의 일부입니다. 이벤트 처리기는 RealTimeStylus 개체의 GetDesiredPacketDescription 메서드를 호출합니다.

using Microsoft.Ink;
using Microsoft.StylusInput;
using Microsoft.StylusInput.PluginData;

// ...

// Declare the RealTimeStylus objects, the GestureRecognizer plugin,
// and the DynamicRenderer plug-in.
private Microsoft.StylusInput.RealTimeStylus thePrimaryRealTimeStylus = null;
private Microsoft.StylusInput.RealTimeStylus theSecondaryRealTimeStylus = null;
private Microsoft.StylusInput.GestureRecognizer theGestureRecognizer = null;
private Microsoft.StylusInput.DynamicRenderer theDynamicRenderer = null;

// ...

// The GetDesiredPacketDescription menu item's ClickEventHandler
private void theMenuItemGetDesiredPacketDescription_Click(object sender,
    System.EventArgs e)
{
    this.theTextBox.Text = "DesiredPacketDescription = " + Environment.NewLine;
    foreach (Guid theGuid in this.thePrimaryRealTimeStylus.GetDesiredPacketDescription())
    {
        this.theTextBox.Text += string.Format("  {0}" + Environment.NewLine,
            this.GetPacketPropertyNameFromGuid(theGuid));
    }
}