InkPicture 컨트롤 참조
InkPicture 컨트롤은 애플리케이션에 이미지를 배치하고 사용자가 그 위에 잉크를 추가할 수 있도록 하는 기능을 제공합니다. 잉크가 텍스트로 인식되지 않고 대신 잉크로 저장되는 시나리오를 위한 것입니다.
InkPicture 컨트롤은 C++에서 CoCreateInstance 메서드를 호출하여 인스턴스화할 수 있습니다.
참고
InkPicture 컨트롤은 스크립팅에 안전하지 않은 것으로 표시되지 않습니다. InkPicture 컨트롤은 HTML 또는 ASP.NET 페이지에서 사용하면 안 됩니다.
투명 컨트롤 뒤에 InkPicture 컨트롤을 만들면(예: WS_EX_TRANSPARENT 속성이 설정된 GroupBox) InkPicture에서 잉크를 수집할 수 없습니다.
멤버
| 열거형 | 설명 |
|---|---|
| InkPictureSizeMode | InkPicture 컨트롤 내에서 배경 그림이 작동하는 방식을 지정하는 값을 정의합니다. |
| 이벤트 | Description |
|---|---|
| ChangeUICues | 더 이상 사용되지 않습니다. |
| 클릭 | 사용자가 InkPicture 컨트롤을 클릭할 때 발생합니다. |
| CursorButtonDown 이벤트 |
InkCollector 컨트롤이 다운된 IInkCursorButton 개체를 검색할 때 발생합니다. |
| CursorButtonUp 이벤트 | InkPicture 컨트롤이 위쪽에 있는 IInkCursorButton 을 검색할 때 발생합니다. |
| CursorDown 이벤트 | 커서 팁이 디지털화 태블릿 표면에 연결할 때 발생합니다. |
| CursorInRange 이벤트 | 커서가 태블릿 컨텍스트의 물리적 검색 범위(근접)에 들어갈 때 발생합니다. |
| CursorOutOfRange 이벤트 | 커서가 태블릿 컨텍스트의 물리적 검색 범위(근접)를 벗어나면 발생합니다. |
| DblClick | InkPicture 컨트롤을 두 번 클릭하면 발생합니다. 이 이벤트 메서드는 _IInkPictureEvents 인터페이스에 정의되어 있습니다. _IInkPictureEvents 인터페이스는 DISPID_IPEDblClick 식별자를 사용하여 IDispatch 인터페이스를 구현합니다. |
| 제스처 이벤트 | 애플리케이션 제스처가 인식될 때 발생합니다. |
| KeyDown 이벤트 [InkPicture Control] | InkPicture 컨트롤에 포커스가 있는 동안 키를 누르고 아래쪽 위치에 있을 때 발생합니다. |
| KeyPress 이벤트[InkPicture Control] | InkPicture 컨트롤에 포커스가 있는 동안 키를 누를 때 발생합니다. |
| KeyUp 이벤트 [InkPicture 컨트롤] | InkPicture 컨트롤에 포커스가 있는 동안 키가 해제될 때 발생합니다. |
| MouseDown 이벤트 [InkPicture Control] | 마우스 포인터가 InkPicture 컨트롤 위에 있고 마우스 단추를 누를 때 발생합니다. |
| Mouseenter | 마우스 포인터가 InkPicture 컨트롤에 들어갈 때 발생합니다. |
| MouseHover | 마우스 포인터가 InkPicture 컨트롤을 가리키면 발생합니다. |
| Mouseleave | 마우스 포인터가 InkPicture 컨트롤을 떠날 때 발생합니다. |
| MouseMove 이벤트 [InkPicture Control] | 마우스 포인터를 InkPicture 컨트롤 위로 이동할 때 발생합니다. |
| MouseUp 이벤트 [InkPicture 컨트롤] | 마우스 포인터가 InkPicture 컨트롤 위에 있고 마우스 단추가 놓일 때 발생합니다. |
| Mousewheel | InkPicture 컨트롤에 포커스가 있는 동안 마우스 휠이 움직일 때 발생합니다. |
| NewInAirPackets 이벤트 | 대기 패킷이 보이면 발생합니다. |
| NewPackets 이벤트 | InkPicture 컨트롤이 패킷을 받을 때 발생합니다. |
| 그린 | InkPicture 컨트롤이 자체 다시 그리기를 완료할 때 발생합니다. |
| 그리기 | InkPicture 컨트롤이 자체를 다시 그리기 전에 발생합니다. |
| 크기 조정 | InkPicture 컨트롤의 크기를 조정할 때 발생합니다. |
| SelectionChanged | 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 InkPicture 컨트롤 내에서 텍스트 선택이 변경된 경우에 발생합니다. |
| SelectionChanging | 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 InkPicture 컨트롤 내에서 텍스트 선택을 변경하려고 할 때 발생합니다. |
| SelectionMoved | 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 현재 선택 영역의 위치가 변경된 경우에 발생합니다. |
| SelectionMoving 이벤트 [InkPicture Control] | 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 현재 선택 영역의 위치가 변경되려고 할 때 발생합니다. |
| SelectionResized | 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 현재 선택 영역의 크기가 변경된 경우에 발생합니다. |
| SelectionResizing | 사용자 인터페이스 변경, 잘라내기 및 붙여넣기 프로시저 또는 Selection 속성과 같이 현재 선택 영역의 크기가 변경하려고 할 때 발생합니다. |
| SizeChanged | InkPicture 컨트롤의 크기가 조정된 후, 특히 Width 또는 Height 속성 값이 변경된 후에 발생합니다. |
| SizeModeChanged | InkPicture 컨트롤의 SizeMode 속성이 변경된 후에 발생합니다. |
| StyleChanged | 구현되지 않았습니다. |
| 스트로크 | 사용자가 모든 태블릿에서 새 스트로크를 그릴 때 발생합니다. |
| StrokesDeleted |
IInkStrokeDisp 개체가 Ink 속성에서 삭제된 후에 발생합니다. |
| StrokesDeleting |
Ink 속성에서 IInkStrokeDisp 개체를 삭제하기 전에 발생합니다. |
| SystemColorsChanged | 시스템 색이 변경된 후에 발생합니다. |
| SystemGesture | 시스템 제스처가 인식될 때 발생합니다. |
| TabletAdded 이벤트 | 태블릿이 시스템에 추가되면 발생합니다. |
| TabletRemoved 이벤트 | 태블릿이 시스템에서 제거될 때 발생합니다. |
| 메서드 | 설명 |
|---|---|
| GetEventInterest 메서드 | InkPicture 컨트롤이 특정 이벤트에 관심이 있는지 여부를 나타내는 값을 반환합니다. |
| GetGestureStatus | InkPicture 컨트롤이 특정 애플리케이션 제스처에 관심이 있는지 여부를 나타내는 값을 반환합니다. |
| GetWindowInputRectangle 메서드 | 잉크가 그려지는 창 사각형을 픽셀 단위로 반환합니다. |
| HitTestSelection | 선택 영역(있는 경우)이 적중 테스트 중에 적중된 부분을 지정하는 SelectionHitResult 열거형의 멤버를 반환합니다. |
| SetAllTabletsMode 메서드 | InkPicture 컨트롤이 태블릿 PC에 연결된 모든 태블릿에서 잉크를 수집할 수 있도록 합니다. |
| SetEventInterest 메서드 | InkPicture 컨트롤이 지정된 이벤트에 관심이 있는지 여부를 나타내는 값을 설정합니다. |
| SetFocus | 포커스를 InkPicture 컨트롤로 이동합니다. |
| SetGestureStatus 메서드 | 지정된 애플리케이션 제스처에서 InkPicture 개체의 관심사를 설정합니다. |
| SetSingleTabletIntegratedMode 메서드 | 태블릿 PC에 연결된 하나의 태블릿에서만 잉크를 수집하도록 InkPicture 컨트롤을 설정합니다. 다른 태블릿의 잉크는 무시됩니다. |
| SetWindowInputRectangle 메서드 | 잉크가 그려지는 창 좌표로 설정할 창 사각형을 지정합니다. |
| ShowWhatsThis | 32비트 Microsoft Windows 운영 체제의 도움말에서 제공하는 "What's This" 팝업을 사용하여 도움말 파일에 선택한 항목을 표시합니다(디자인 타임에만 해당). |
| ZOrder | 컨트롤을 그래픽 수준(디자인 타임에만 해당) 내 z 순서의 앞뒤에 배치합니다. |
| 속성 | Description |
|---|---|
| AutoRedraw 속성 | 창이 무효화될 때 InkPicture 컨트롤이 다시 칠할지 여부를 지정하는 값을 가져오거나 설정합니다(InkPicture와 연결된 창이 WM_PAINT 메시지를 받을 때 현재 InkDisp 개체가 InkPicture 컨트롤과 연결된 InkDisp 개체가 자동으로 다시 그려지는지 여부). |
| BackColor | InkPicture 컨트롤의 배경색을 가져오거나 설정합니다. 기본 배경색은 시스템 창 배경색이며 일반적으로 흰색입니다. |
| CollectingInk 속성 | InkPicture 컨트롤이 잉크를 수집하는지 여부를 지정하는 값을 가져옵니다(런타임에만 해당). |
| CollectionMode | 잉크, 제스처 또는 잉크 및 제스처가 사용자가 쓸 때 인식되는지 여부를 결정하는 컬렉션 모드를 가져오거나 설정합니다. |
| 커서 속성 | InkPicture 컨트롤의 수동 입력 영역에서 사용할 수 있는 IInkCursors 컬렉션을 가져옵니다. |
| CustomStrokes | 잉크와 함께 유지할 IInkCustomStrokes 컬렉션을 가져옵니다(디자인 타임에만 해당). |
| DefaultDrawingAttributes 속성 | 잉크를 그리거나 표시할 때 사용할 기본 InkDrawingAttributes 컬렉션을 가져오거나 설정합니다(런타임에만 해당). |
| DesiredPacketDescription 속성 | InkPicture 컨트롤의 패킷 설명을 가져오거나 설정합니다(런타임에만 해당). |
| DynamicRendering 속성 | InkPicture 컨트롤이 수집될 때 잉크를 동적으로 렌더링하는지 여부를 지정하는 값을 가져오거나 설정합니다. |
| EditingMode | InkPicture 컨트롤이 잉크 모드, 삭제 모드 또는 선택/편집 모드에 있는지 여부를 지정하는 값을 가져오거나 설정합니다. |
| 사용 | InkPicture 컨트롤이 사용자 생성 이벤트에 응답할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다. 참고: 이 속성은 InkEnabled 속성과 동일합니다. |
| EraserMode | 잉크가 스트로크 또는 포인트별로 지워지는지 여부를 지정하는 값을 가져오거나 설정합니다. |
| EraserWidth | 지우개 펜 팁의 너비를 지정하는 값을 가져오거나 설정합니다. |
| Hwnd | InkPicture 컨트롤이 바인딩된 창 핸들을 가져옵니다. (런타임에만 해당) |
| 잉크 | InkPicture 컨트롤과 연결된 InkDisp 개체를 가져오거나 설정합니다(런타임에만 해당). |
| InkEnabled | InkPicture 컨트롤이 펜 입력(대기 패킷, 범위 이벤트의 커서 등)을 수집하는지 여부를 지정하는 값을 가져오거나 설정합니다. |
| MarginX 속성 | 화면 좌표에서 창 사각형 주위의 x축 여백을 가져오거나 설정합니다. |
| Marginy 속성 | 화면 좌표에서 창 사각형 주위의 y축 여백을 가져오거나 설정합니다. |
| MouseIcon 속성 | 현재 사용자 지정 마우스 아이콘을 가져오거나 설정합니다. |
| MousePointer 속성 | 마우스가 InkPicture 컨트롤의 특정 부분에 있을 때 나타나는 마우스 포인터의 유형을 나타내는 값을 가져오거나 설정합니다. |
| 그림 | InkPicture 컨트롤에 표시할 그래픽 파일을 가져옵니다. |
| 렌더러 속성 | InkPicture 컨트롤에서 잉크를 그리는 데 사용되는 InkRenderer 개체를 가져오거나 설정합니다(런타임에만 해당). |
| 선택 영역 | InkPicture 컨트롤 내에서 현재 선택된 InkStrokes 컬렉션을 가져옵니다(런타임에만 해당). |
| SizeMode | 컨트롤이 이미지 배치 및 크기 조정을 처리하는 방법을 가져오거나 설정합니다. |
| SupportHighContrastInk 속성 | 시스템이 고대비 모드에 있을 때 잉크가 한 색으로 렌더링되는지 여부를 지정하는 값을 가져옵니다. Color = COLOR_WINDOWTEXT(GetSystemMetrics 호출에서). |
| SupportHighContrastSelectionUI | 시스템이 고대비 모드일 때 모든 선택 사용자 인터페이스(선택 경계 상자 및 선택 핸들)가 고대비로 그려지는지 여부를 지정하는 값을 가져오거나 설정합니다. |
| Tablet 속성 | InkPicture 컨트롤이 현재 입력을 수집하는 데 사용하는 IInkTablet 개체를 가져옵니다. |
설명
InkPicture 컨트롤의 런타임 사용자 인터페이스는 불투명 잉크를 포함하는 불투명 배경(단일 색, 그림 배경 또는 둘 다)이 있는 창입니다.
InkPicture 컨트롤을 사용하여 Microsoft Windows 2000, Windows Server 2003, Windows XP Tablet PC Edition 이외의 모든 Windows XP 버전 및 모든 버전의 Windows Vista에서 잉크를 렌더링할 수 있습니다. 그러나 다음 조건에서만 잉크를 입력하거나, 제스처를 수락하거나, 필기를 인식할 수 있습니다.
- Windows Vista 또는 XP Tablet PC Edition 2005가 설치된 경우 잉크를 입력하고 인식할 수 있습니다.
- 제스처도 인식할 수 있습니다.
- 인식기가 있는 한 이전 버전의 Windows를 실행하는 컴퓨터에서 필기가 시작된 경우 필기를 텍스트로 인식할 수 있습니다.
Windows XP Tablet PC Edition 2005 이외의 Windows XP 버전인 Windows 2000, Windows Server 2003을 사용하는 경우 InkPicture 컨트롤의 주변 속성에 값을 할당한 다음 잉크를 복사하여 다른 애플리케이션에 붙여넣을 수 있습니다. 그러나 InkEnabled 속성의 값은 항상 FALSE입니다.
지속형 InkDisp 개체는 Windows Vista 및 XP의 모든 버전과 Windows XP 태블릿 PC 버전 SDK(소프트웨어 개발 키트)만 설치된 시스템에서 로드하고 표시할 수 있습니다. Windows Vista 또는 Windows XP Tablet PC Edition 2005가 설치된 경우에만 InkDisp 개체를 텍스트(인식)로 변환할 수 있습니다.
이 컨트롤에 대한 작업이 성공하지 못하면 법적 HRESULT가 반환됩니다. 오류 조건이 발생하면 반환된 HRESULT를 오류에 대해 검사.
잉크 컨트롤에 대한 자세한 내용은 잉크를 참조 하세요.
특정 이벤트를 발생시키는 스레드에 대한 자세한 내용은 이벤트가 발생할 수 있는 스레드를 참조하세요.
애플리케이션의 성능을 향상시키려면 더 이상 필요하지 않은 경우 InkPicture 컨트롤을 수동으로 삭제합니다.
참고
InkPicture 컨트롤이 투명으로 설정된 GroupBox 와 같은 다른 컨트롤로 오버레이되는 경우 InkPicture는 잉크를 수집하지 않습니다. InkPicture는 Z 순서에서 최상위 컨트롤이거나 GroupBox의 자식이어야 합니다.
COM 구현
이 개체는 IInkPicture COM 인터페이스를 구현합니다.