RealTimeStylus.GetTabletContextIdFromTablet 메서드

아티클
11/04/2008

업데이트: 2007년 11월

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

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

구문

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

returnValue = instance.GetTabletContextIdFromTablet(tablet)

public int GetTabletContextIdFromTablet(
    Tablet tablet
)

public:
int GetTabletContextIdFromTablet(
    Tablet^ tablet
)

public int GetTabletContextIdFromTablet(
    Tablet tablet
)

public function GetTabletContextIdFromTablet(
    tablet : Tablet
) : int

매개 변수

tablet
형식: Microsoft.Ink.Tablet
Tablet 개체입니다.

반환 값

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

설명

참고

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

RealTimeStylus가 비활성화 또는 삭제되었거나 tablet 매개 변수가 null(Visual Basic의 경우 Nothing)이면 이 메서드에서 예외를 throw합니다.

참고

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

예제

이 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)
    {
        // ...
    }
}