RealTimeStylus.GetTabletPropertyDescriptionCollection 메서드

아티클
11/04/2008

업데이트: 2007년 11월

지정된 태블릿 컨텍스트 식별자에 연결된 TabletPropertyDescriptionCollection 컬렉션을 반환합니다.

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

구문

‘선언
Public Function GetTabletPropertyDescriptionCollection ( _
    tabletContextId As Integer _
) As TabletPropertyDescriptionCollection
‘사용 방법
Dim instance As RealTimeStylus
Dim tabletContextId As Integer
Dim returnValue As TabletPropertyDescriptionCollection

returnValue = instance.GetTabletPropertyDescriptionCollection(tabletContextId)

public TabletPropertyDescriptionCollection GetTabletPropertyDescriptionCollection(
    int tabletContextId
)

public:
TabletPropertyDescriptionCollection^ GetTabletPropertyDescriptionCollection(
    int tabletContextId
)

public TabletPropertyDescriptionCollection GetTabletPropertyDescriptionCollection(
    int tabletContextId
)

public function GetTabletPropertyDescriptionCollection(
    tabletContextId : int
) : TabletPropertyDescriptionCollection

매개 변수

tabletContextId
형식: System.Int32
패킷 속성 설명을 가져올 Tablet 개체의 태블릿 컨텍스트 식별자입니다.

반환 값

형식: Microsoft.Ink.TabletPropertyDescriptionCollection
지정된 태블릿 컨텍스트 식별자에 연결된 TabletPropertyDescriptionCollection 컬렉션입니다.

설명

RealTimeStylus가 비활성화되거나 삭제된 경우 이 메서드는 예외를 throw합니다.

예제

이 C# 예제는 IStylusAsyncPlugin 인터페이스의 TabletAdded 메서드 구현에서 가져온 코드 조각입니다. IStylusAsyncPlugin 인터페이스를 구현하는 폼에는 TextBox 개체인 theTextBox가 들어 있습니다. TabletAdded 메서드는 추가된 태블릿에 대한 정보를 표시하고, GetTabletContextIdFromTablet 메서드를 호출하여 태블릿의 컨텍스트 식별자를 가져오고, GetTabletPropertyDescriptionCollection 메서드를 호출하여 태블릿에서 지원되는 패킷 속성의 목록을 가져옵니다.

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;

// ...

// Called when a tablet is added while the RealTimeStylus is enabled.
public void TabletAdded(RealTimeStylus sender, TabletAddedData data)
{
    // Display information about the tablet that was added.
    int theContextId =
        this.thePrimaryRealTimeStylus.GetTabletContextIdFromTablet(data.Tablet);

    this.theTextBox.Text = string.Format(
        "Tablet added, Name = {0}, ContextId={1}, available packet properties:"
        + Environment.NewLine, data.Tablet.Name, theContextId);

    TabletPropertyDescriptionCollection theTabletProperties =
        this.thePrimaryRealTimeStylus.GetTabletPropertyDescriptionCollection(theContextId);

    foreach(TabletPropertyDescription theTabletPropertyDescription in theTabletProperties)
    {
        // ...
    }
}