ITablet::CreateContext 메서드
지정된 태블릿 디바이스를 설명하는 컨텍스트 개체를 만듭니다.
구문
HRESULT CreateContext(
[in] HWND hWnd,
[in] RECT *prcInput,
[in] DWORD dwOptions,
[in] TABLET_CONTEXT_SETTINGS *pTCS,
[in] CONTEXT_ENABLE_TYPE cet,
[out] ITabletContext **ppCtx,
[in, out] TABLET_CONTEXT_ID *pTcid,
[in, out] PACKET_DESCRIPTION **ppPD,
[in] ITabletEventSink *pSink
);
매개 변수
-
hWnd [in]
-
태블릿 컨텍스트가 연결될 창입니다.
-
prcInput [in]
-
[in, unique]
잉크 입력 사각형입니다.
-
dwOptions [in]
-
태블릿 컨텍스트 옵션을 설정하는 플래그입니다.
-
pTCS [in]
-
[in, unique]
만들 태블릿 컨텍스트에 대한 자세한 정보입니다.
-
cet [in]
-
창으로 전송되는 컨텍스트 메시지를 사용하거나 사용하지 않도록 설정하는 값입니다.
-
ppCtx [out]
-
새로 만든 태블릿 컨텍스트에 대한 포인터입니다.
-
pTcid [in, out]
-
태블릿을 고유하게 식별하는 값입니다.
-
ppPD [in, out]
-
각 패킷에 포함된 데이터에 대한 정보에 대한 포인터입니다.
-
pSink [in]
-
알림 메시지를 보낼 ITabletEventSink 개체입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
성공. |
|
지정되지 않은 오류가 발생했습니다. |
설명
일반적으로 애플리케이션은 ITablet::GetDefaultContextSettings 메서드에서 기본값을 가져오고, 필요에 맞게 값을 수정한 다음, 수정된 설정 구조를 ITablet::CreateContext 메서드에 전달합니다.
참고
ITablet::CreateContext 메서드를 호출할 때 ITabletEventSink 인터페이스를 구현해야 합니다.
dwOptions 매개 변수는 컨텍스트 옵션을 설명하는 비트 플래그 집합입니다. 다음 표에서는 이러한 플래그에 대해 설명합니다.
| 플래그 이름 | 값 | Description |
|---|---|---|
| TCXO_MARGIN |
0x00000001 |
태블릿의 입력 컨텍스트에 여백이 있도록 지정합니다. 여백은 지정된 입력 영역 외부의 영역으로, 이벤트는 입력 영역의 가장자리에 매핑됩니다. 이 기능을 사용하면 컨텍스트의 가장자리에서 지점을 더 쉽게 입력할 수 있습니다. |
| TCXO_PREHOOK |
0x00000002 |
Prehook는 일반 컨텍스트 및 사후 작업 전에 패킷을 가져옵니다. 생성 순서대로 패킷을 가져옵니다. |
| TCXO_CURSOR_STATE |
0x00000004 |
TC는 커서가 있는 경우에도 패킷을 반환합니다. 기본적으로 TC는 커서가 다운된 경우에만 패킷을 반환합니다. |
| TCXO_NO_CURSOR_DOWN |
0x00000008 |
커서가 다운된 경우 TC는 패킷을 반환하지 않습니다. |
| TCXO_NON_INTEGRATED |
0x00000010 |
컨텍스트는 통합되지 않습니다. |
| TCXO_POSTHOOK |
0x00000020 |
포스트후크는 일반 태블릿 컨텍스트 이후와 시스템 컨텍스트 이전의 패킷을 가져옵니다. 생성의 역순으로 패킷을 가져옵니다. |
| TCXO_DONT_SHOW_CURSOR |
0x00000080 |
TC는 커서 위치를 설정하지 않습니다. |
| TCXO_DONT_VALIDATE_TCS |
0x00000100 |
TC는 디바이스의 지원되는 속성에 대해 태블릿 컨텍스트 설정에 전달된 GUID의 유효성을 검사하지 않습니다. |
| TCXO_ALLOW_FLICKS |
0x00000400 |
TC는 플릭 검색이 수행되도록 허용하고(기본적으로 시스템 컨텍스트에서만 허용됨) 클라이언트는 SE_FLICK 이벤트를 가져옵니다. |
| TCXO_ALLOW_FEEDBACK_TAPS |
0x00000800 |
TC는 펜 피드백을 표시할 수 있도록 허용합니다. 기본적으로 시스템 컨텍스트에서만 허용됩니다. |
| TCXO_ALLOW_FEEDBACK_BARREL |
0x00001000 |
TC는 펜 피드백을 표시할 수 있도록 허용합니다. 기본적으로 시스템 컨텍스트에서만 허용됩니다. |
| TCXO_ALL |
TCXO_MARGIN | TCXO_PREHOOK | TCXO_CURSOR_STATE | TCXO_NO_CURSOR_DOWN | TCXO_NON_INTEGRATED | TCXO_POSTHOOK | TCXO_DONT_SHOW_CURSOR | TCXO_DONT_VALIDATE_TCS |
정의된 모든 태블릿 컨텍스트 옵션입니다. |
| TCXO_HOOK |
TCXO_PREHOOK | TCXO_POSTHOOK |
후크 전 기능과 후크 후크 기능을 결합합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 라이브러리 |
|