RealTimeStylus.GetTabletFromTabletContextId 메서드

아티클
11/04/2008

업데이트: 2007년 11월

지정된 태블릿 컨텍스트 식별자에 연결된 Tablet 개체를 반환합니다.

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

구문

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

returnValue = instance.GetTabletFromTabletContextId(tabletContextId)

public Tablet GetTabletFromTabletContextId(
    int tabletContextId
)

public:
Tablet^ GetTabletFromTabletContextId(
    int tabletContextId
)

public Tablet GetTabletFromTabletContextId(
    int tabletContextId
)

public function GetTabletFromTabletContextId(
    tabletContextId : int
) : Tablet

매개 변수

tabletContextId
형식: System.Int32
연결된 Tablet 개체를 가져올 태블릿 컨텍스트 식별자입니다.

반환 값

형식: Microsoft.Ink.Tablet
지정된 태블릿 컨텍스트 식별자에 연결된 Tablet 개체입니다.

설명

참고

태블릿 컨텍스트 식별자는 RealTimeStylus 개체별로 고유하지만 동일한 Tablet 개체에 대한 컨텍스트 식별자가 두 RealTimeStylus 개체에서 서로 다를 수 있습니다. 또한 태블릿 컨텍스트 식별자는 RealTimeStylus 개체가 활성화된 동안에만 유효합니다. RealTimeStylus 개체를 비활성화한 후 다시 활성화하면 각 Tablet 개체의 태블릿 컨텍스트 식별자 값이 RealTimeStylus 개체가 처음 활성화된 시점과 비교하여 달라질 수 있습니다.

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

참고

특정 메시지 처리기 내에서 이 함수를 호출하면 재진입이 발생하여 예기치 않은 결과가 나타납니다. WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT, WM_SYSKEYDOWN(Alt+Tab 또는 Alt+Esc 키 조합을 처리하는 경우) 메시지 중 하나를 처리할 때는 재진입 호출이 발생하지 않도록 주의해야 합니다. wParam이 SC_HOTKEY 또는 SC_TASKLIST로 설정된 경우에는 WM_SYSCOMMAND도 여기에 해당합니다. . 이는 단일 스레드 아파트 모델 응용 프로그램에 적용되는 문제입니다.

예제

이 C# 예제는 IStylusAsyncPlugin 인터페이스의 RealTimeStylusEnabled 메서드 구현에서 가져온 코드 조각입니다. IStylusAsyncPlugin 인터페이스를 구현하는 폼에는 TextBox 개체인 theTextBox가 들어 있습니다. RealTimeStylusEnabled 메서드는 RealTimeStylus 개체가 활성화된 시점에서 사용 가능한 태블릿 관련 정보를 표시합니다.

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 the RealTimeStylus is enabled, or when the plug-in is added to
// a RealTimeStylus that is already enabled.
public void RealTimeStylusEnabled(RealTimeStylus sender,
    RealTimeStylusEnabledData data)
{
    // Display the list of available tablets.
    this.theTextBox.Text = string.Format(
        "RealTimeStylus enabled ({0} tablets attached):" + Environment.NewLine,
        data.Count);
    foreach (int theContextId in data)
    {
        Tablet theTablet =
            this.thePrimaryRealTimeStylus.GetTabletFromTabletContextId(theContextId);

        this.theTextBox.Text += string.Format(
            "  ContextId = {0}, Tablet.Name = {1}" + Environment.NewLine,
            theContextId, theTablet.Name);

        this.theTextBox.Text += "   Available packet properties:" + Environment.NewLine;

        foreach(TabletPropertyDescription theTabletPropertyDescription in
            this.thePrimaryRealTimeStylus.GetTabletPropertyDescriptionCollection(theContextId))
        {
            this.theTextBox.Text += string.Format("    {0}" + Environment.NewLine,
                this.GetPacketPropertyNameFromGuid(theTabletPropertyDescription.PacketPropertyId));
        }
    }
}