InkOverlay 클래스

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

투명 컨트롤 뒤에 InkOverlay 컨트롤(예: WS EX _ _ TRANSPARENT 속성이 설정된 GroupBox)을 만들면 InkOverlay에서 잉크를 수집할 수 없습니다.

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

이벤트

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

이벤트 Description
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 사용자 인터페이스, 잘라내기 및 붙여넣기 프로시저 또는 선택 속성에 대한 변경을 통해 현재 선택 영역의 위치가 변경되는 경우에 발생합니다.
SelectionResized 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 현재 선택 영역의 크기가 변경된 경우에 발생합니다.
SelectionResizing 사용자 인터페이스, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성을 변경하여 현재 선택 영역의 크기를 변경하려고 할 때 발생합니다.
스트로크 사용자가 태블릿에서 새 스트로크 그리기를 완료할 때 발생합니다.
StrokesDeleted Ink 속성에서 스트로크가 삭제된 후에 발생합니다.
StrokesDeleting Ink 속성에서 스트로크가 삭제되기 전에 발생합니다.
SystemGesture 시스템 제스처가 인식될 때 발생합니다.
TabletAdded IInkTablet가 시스템에 추가되면 발생합니다.
TabletRemoved 태블릿이 시스템에서 제거될 때 발생합니다.

인터페이스

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

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

메서드

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

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

속성

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

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

MFC 구현 참고 사항

InkOverlay 개체를 CView 개체에 연결한 경우 _ 다음 예제와 같이 WM 소멸 메시지에 응답 하 여 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 개체는 메모 작성 및 기본 scribbling에 적합 합니다. 이 개체의 기본 용도는 잉크를 잉크로 표시 하는 것입니다.

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

MouseDown, MouseMove, MouseUpMouseWheel 이벤트는 x 좌표 및 y 좌표를 픽셀 단위로 반환 하 고, 잉크 공간에 연결 된 HIMETRIC 단위는 반환 하지 않습니다. 이러한 이벤트는 펜으로 인식 되지 않는 응용 프로그램의 마우스 이벤트를 대체 하기 때문 이며, 이러한 응용 프로그램은 픽셀만을 인식 합니다.

주의

Inkoverlay 개체의 AttachMode 속성을 infront로 설정 하는 경우 양식이 실행 되는 스레드에서 inkoverlay 개체를 만듭니다. 다른 스레드에서 InkOverlay 개체가 만들어지고 해당 AttachMode 속성이 infront로 설정 된 경우 응용 프로그램이 응답 하지 않을 수 있습니다.

참고

InkOverlay 개체는 비 UI 스레드에서 안전 하 게 릴리스할 수 없습니다.

응용 프로그램의 성능을 향상 시키려면 InkOverlay 개체가 더 이상 필요 하지 않은 경우 삭제 합니다.

InkOverlay 개체를 CView 개체에 연결한 경우 _ 다음 예제와 같이 WM 소멸 메시지에 응답 하 여 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 버전 [ 데스크톱 앱에만 해당]
지원되는 최소 서버
지원되는 버전 없음
header
Msinkaut (Msinkaut도 필요 _ 합니다. c)
라이브러리
InkObj.dll

참고 항목

InkCollector 클래스

InkPicture 컨트롤 참조

InkEdit 컨트롤 참조