InkOverlay 클래스

  • 아티클

사용자가 잉크에서 인식을 수행하는 데 관심이 없지만 잉크의 크기, 모양, 색 및 위치에 관심이 있는 주석 시나리오에 유용한 개체를 나타냅니다.

투명 컨트롤 뒤에 InkOverlay 컨트롤을 만들면(예: WS_EX_TRANSPARENT 속성이 설정된 GroupBox) InkOverlay 가 잉크를 수집하지 못하게 됩니다.

InkOverlay 에는 다음과 같은 유형의 멤버가 있습니다.

이벤트

InkOverlay 클래스에는 이러한 이벤트가 있습니다.

이벤트 설명
CursorButtonDown InkOverlay가 다운된 커서 단추를 검색할 때 발생합니다.
CursorButtonUp InkOverlay가 위쪽에 있는 커서 단추를 검색할 때 발생합니다.
CursorDown 커서 팁이 디지털화 태블릿 표면에 닿을 때 발생합니다.
CursorInRange 커서가 태블릿 컨텍스트의 물리적 검색 범위(근접)에 들어갈 때 발생합니다.
CursorOutOfRange 커서가 태블릿 컨텍스트의 물리적 검색 범위(근접)를 벗어나면 발생합니다.
더블 InkOverlay 개체를 두 번 클릭하면 발생합니다.
제스처 애플리케이션별 제스처가 인식될 때 발생합니다.
MouseDown 마우스 포인터가 InkOverlay 개체 위에 있고 마우스 단추를 누를 때 발생합니다.
MouseMove 마우스 포인터를 InkOverlay 개체 위로 이동할 때 발생합니다.
MouseUp 마우스 포인터가 InkOverlay 개체 위에 있고 마우스 단추를 놓을 때 발생합니다.
Mousewheel InkOverlay 개체에 포커스가 있는 동안 마우스 휠이 움직일 때 발생합니다.
NewInAirPackets 사용자가 태블릿 근처에서 펜을 이동하고 커서가 InkOverlay 개체의 창 내에 있거나 사용자가 InkOverlay 개체 개체의 연결된 창 내에서 마우스를 이동할 때 발생하는 공중 패킷이 표시될 때 발생합니다.
NewPackets InkOverlay 개체가 패킷을 받을 때 발생합니다.
그린 InkOverlay 개체가 자체 다시 그리기를 완료할 때 발생합니다.
그리기 InkOverlay 개체가 자체를 다시 그리기 전에 발생합니다.
SelectionChanged 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 컨트롤 내에서 잉크 선택이 변경된 경우에 발생합니다.
SelectionChanging 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 컨트롤 내의 잉크 선택 영역이 변경하려고 할 때 발생합니다.
SelectionMoved 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 현재 선택 영역의 위치가 변경된 경우에 발생합니다.
SelectionMoving 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 현재 선택 영역의 위치가 변경하려고 할 때 발생합니다.
SelectionResized 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 현재 선택 영역의 크기가 변경된 경우에 발생합니다.
SelectionResizing 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 현재 선택 영역의 크기가 변경하려고 할 때 발생합니다.
스트로크 사용자가 모든 태블릿에서 새 스트로크 그리기를 완료할 때 발생합니다.
StrokesDeleted Ink 속성에서 스트로크가 삭제된 후에 발생합니다.
StrokesDeleting Ink 속성에서 스트로크를 삭제하기 전에 발생합니다.
SystemGesture 시스템 제스처가 인식될 때 발생합니다.
TabletAdded IInkTablet가 시스템에 추가되면 발생합니다.
TabletRemoved 태블릿이 시스템에서 제거될 때 발생합니다.

인터페이스

InkOverlay 클래스는 이러한 인터페이스를 정의합니다.

인터페이스 Description
IInkOverlay 이 개체는 IInkOverlay COM 인터페이스를 구현합니다.

메서드

InkOverlay 클래스에는 이러한 메서드가 있습니다.

메서드 설명
Draw InkOverlay 개체 내에서 잉크를 다시 그릴 사각형을 설정합니다.
GetEventInterest 특정 InkOverlay 개체 이벤트의 현재 상태를 반환합니다. 즉, 이벤트가 수신 대기 중인지 또는 사용되는지 여부를 반환합니다.
GetGestureStatus InkOverlay 개체가 특정 제스처에 관심이 있는지 여부를 반환합니다.
GetWindowInputRectangle 잉크가 그려지는 창 사각형을 픽셀 단위로 검색합니다.
HitTestSelection 적중 테스트 중에 선택한 부분이 적중되었는지 확인합니다.
SetAllTabletsMode 이 모드를 사용하면 InkOverlay 개체가 태블릿 PC에 연결된 모든 태블릿에서 잉크를 수집할 수 있습니다.
SetEventInterest 특정 이벤트를 수신 대기할지 또는 사용해야 하는지를 설정합니다.
SetGestureStatus 알려진 제스처에서 InkOverlay 개체의 관심사를 설정합니다.
SetSingleTabletIntegratedMode 이 모드를 사용하면 InkOverlay 개체가 하나의 태블릿에서만 잉크를 수집할 수 있습니다. 다른 태블릿의 잉크는 InkOverlay 개체에서 무시됩니다.
SetWindowInputRectangle 그리는 잉크를 창에 매핑하는 데 사용할 창 사각형을 픽셀 단위로 설정합니다.

속성

InkOverlay 클래스에는 이러한 속성이 있습니다.

속성 액세스 유형 설명
AttachMode
 읽기/쓰기
 InkOverlay 개체가 알려진 창 뒤에 또는 앞에 연결되어 있는지 여부를 지정하는 값을 가져오거나 설정합니다.
AutoRedraw
 읽기/쓰기
 창이 무효화될 때 InkOverlay 가 잉크를 다시 칠할지 여부를 지정하는 값을 가져오거나 설정합니다.
CollectingInk
 읽기 전용
 InkOverlay 개체에서 현재 잉크를 그릴지 여부를 지정하는 값을 가져옵니다.
CollectionMode
 읽기/쓰기
 잉크, 제스처 또는 둘 다 사용자가 쓰는 것으로 인식되는지 여부를 결정하는 컬렉션 모드를 가져오거나 설정합니다.
커서
 읽기 전용
 수동 입력 영역에서 사용할 수 있는 커서 컬렉션을 가져옵니다.
DefaultDrawingAttributes
 읽기/쓰기
 잉크를 그리거나 표시할 때 사용되는 그리기 특성을 지정하는 기본 InkDrawingAttributes 개체를 가져오거나 설정합니다.
DesiredPacketDescription
 읽기/쓰기
 InkOverlay 개체에 그려진 잉크와 연결된 패킷의 측면에 대한 관심을 가져오거나 설정합니다.
DynamicRendering
 읽기/쓰기
 잉크가 그려질 때 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다.
EditingMode
 읽기/쓰기
 InkOverlay가 잉크 모드, 삭제 모드 또는 선택/편집 모드에 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
사용
 읽기/쓰기
 InkOverlay 개체가 펜 입력을 수집하는지 여부를 지정하는 값을 가져오거나 설정합니다.
EraserMode
 읽기/쓰기
 잉크가 스트로크 또는 지점별로 지워지는지 여부를 나타내는 값을 가져오거나 설정합니다.
EraserWidth
 읽기/쓰기
 지우개 펜 팁의 너비를 지정하는 값을 가져오거나 설정합니다.
Handle
 읽기/쓰기
 InkOverlay 개체가 연결된 창의 핸들을 가져오거나 설정합니다.
잉크
 읽기/쓰기
 InkOverlay 개체와 연결된 InkDisp 개체를 가져오거나 설정합니다.
MarginX
 읽기/쓰기
 x축을 따라 픽셀 단위로 여백을 가져오거나 설정합니다.
Marginy
 읽기/쓰기
 y축을 따라 픽셀 단위로 여백을 가져오거나 설정합니다.
MouseIcon
 읽기/쓰기
 현재 사용자 지정 마우스 아이콘을 가져오거나 설정합니다.
MousePointer
 읽기/쓰기
 마우스가 개체의 특정 부분에 있을 때 나타나는 마우스 포인터의 형식을 나타내는 값을 가져오거나 설정합니다.
렌더러
 읽기/쓰기
 잉크를 그리는 데 사용되는 InkRenderer 개체를 가져오거나 설정합니다.
선택 영역
 읽기/쓰기
 InkOverlay 컨트롤 내에서 현재 선택된 InkStrokes 컬렉션을 가져오거나 설정합니다.
SupportHighContrastInk
 읽기/쓰기
 시스템이 고대비 모드일 때 잉크가 하나의 색으로 렌더링되는지 여부를 지정하는 값을 가져오거나 설정합니다.
SupportHighContrastSelectionUI
 읽기/쓰기
 시스템이 고대비 모드일 때 모든 선택 UI가 고대비로 그려지는지 여부를 지정하는 값을 가져오거나 설정합니다.
태블릿
 읽기 전용
 InkOverlay 개체가 현재 입력을 수집하는 데 사용하는 태블릿 디바이스를 가져옵니다.

MFC 구현 정보

InkOverlay 개체를 CView 개체에 연결한 경우 다음 예제와 같이 WM_DESTROY 메시지에 대한 응답으로 InkOverlay 개체를 해제합니다.

BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
    if(WM_DESTROY == msg)
        m_spInkOverlay.Release();
    return CView::OnWndMsg(msg, wp, lp, pLR);
}

설명

이 개체는 C++에서 CoCreateInstance 메서드를 호출하여 인스턴스화할 수 있습니다.

InkOverlay 개체는 메모 작성 및 기본 낙서에 적합합니다. 이 개체의 기본 용도는 잉크를 잉크로 표시하는 것입니다.

일반적으로 이 개체의 런타임 사용자 인터페이스는 불투명 잉크가 있는 투명한 창입니다.

MouseDown, MouseMove, MouseUp 및 MouseWheel 이벤트는 잉크 공간과 연결된 HIMETRIC 단위가 아니라 x 좌표 및 y 좌표를 픽셀 단위로 반환합니다. 이러한 이벤트는 펜을 인식하지 못하는 애플리케이션의 마우스 이벤트를 대체하고 이러한 애플리케이션은 픽셀만 이해하기 때문입니다.

주의

InkOverlay 개체의 AttachMode 속성을 InFront로 설정하는 경우 폼이 실행 중인 스레드에서 InkOverlay 개체를 만듭니다. InkOverlay 개체가 다른 스레드에서 만들어지고 AttachMode 속성이 InFront로 설정된 경우 애플리케이션이 응답을 중지할 수 있습니다.

참고

InkOverlay 개체는 UI가 아닌 스레드에서 안전하게 해제할 수 없습니다.

애플리케이션의 성능을 향상시키려면 더 이상 필요하지 않은 경우 InkOverlay 개체를 삭제합니다.

InkOverlay 개체를 CView 개체에 연결한 경우 다음 예제와 같이 WM_DESTROY 메시지에 대한 응답으로 InkOverlay 개체를 해제합니다.

BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
    if(WM_DESTROY == msg)
        m_spInkOverlay.Release();
    return CView::OnWndMsg(msg, wp, lp, pLR);
}

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버
 지원되는 버전 없음
헤더
Msinkaut.h(Msinkaut_i.c도 필요)
라이브러리
InkObj.dll

추가 정보

InkCollector 클래스

InkPicture 컨트롤 참조

InkEdit 컨트롤 참조