Windows.UI.Input.Inking 네임스페이스
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Windows Ink 앱에 대한 입력, 처리 및 관리 지원을 제공합니다. 다음 내용이 포함됩니다.
- 잉크 스트로크 그리기
- 스트로크 캡처
- 스트로크 렌더링.
- 스트로크 선택.
- 스트로크 삭제.
- 스트로크 저장 및 로드
- 필기 인식을 통해 스트로크를 텍스트로 변환합니다.
- 클립보드에서 스트로크 복사 및 붙여넣기
- 적중 테스트(또는 스트로크 대상 지정).
클래스
| InkDrawingAttributes |
InkStroke 그리기와 연결된 속성을 제공합니다. |
| InkDrawingAttributesPencilProperties |
InkCanvas에서 연필 스트로크를 렌더링하기 위한 정적 InkDrawingAttributes 속성 집합을 제공합니다. InkDrawingAttributes.CreateForPencil을 호출하고InkDrawingAttributes.PencilProperties에 액세스하여 이 클래스의 instance 가져옵니다. |
| InkInputConfiguration |
InkPresenter 개체에서 처리할 수 있는 보조 입력 유형을 관리합니다. |
| InkInputProcessingConfiguration |
InkPresenter 개체에서 입력을 처리하는 방법을 관리합니다. |
| InkManager |
참고 XAML(Extensible Application Markup Language)을 사용하는 유니버설 Windows 앱의 경우 InkManager 대신 InkPresenter 및 InkCanvas 컨트롤을 사용하는 것이 좋습니다. 하나 이상의 InkStroke 개체의 입력, 조작 및 처리(필기 인식 포함)를 관리합니다. |
| InkModelerAttributes |
InkPresenter 개체에서 처리할 수 있는 잉크 모델러 특성 유형을 관리합니다. |
| InkPoint |
InkStroke 생성에 사용되는 단일 지점에 대한 원시 입력 데이터를 제공합니다. |
| InkPresenter |
InkCanvas 컨트롤에 대한 잉크 입력(표준 및 수정)의 입력, 처리 및 렌더링을 관리하기 위한 속성, 메서드 및 이벤트를 제공합니다. |
| InkPresenterProtractor |
InkCanvas에서 반투명 오버레이로 표시되는 호와 곡선을 그리기 위한 프로트라터 형식의 시각적 스텐실을 나타냅니다. 스텐실은 잉크 스트로크가 렌더링되는 방식을 변환합니다.
InkPresenterRuler는 프로그래밍 방식으로 그리고 사용자가 조작할 수 있습니다. 또한 InkCanvas를 사용하여 크기를 조정하고 변환합니다. |
| InkPresenterRuler |
InkCanvas에 반투명 오버레이로 표시되는 직선 그리기를 위한 직선 규칙 형식의 시각적 스텐실을 나타냅니다. 스텐실은 잉크 스트로크가 렌더링되는 방식을 변환합니다.
InkPresenterRuler는 프로그래밍 방식으로 그리고 사용자가 조작할 수 있습니다. 또한 InkCanvas를 사용하여 크기를 조정하고 변환합니다. |
| InkRecognitionResult |
InkStroke 필기 인식 데이터를 관리하는 속성 및 메서드를 제공합니다. 인식 결과는 InkRecognizer에서 검색된 각 단어에 대해 생성됩니다. |
| InkRecognizer |
필기 인식의 모든 측면을 관리합니다. |
| InkRecognizerContainer |
필기 인식에 사용되는 하나 이상의 InkRecognizer 개체를 관리하는 속성과 메서드를 제공합니다. 시스템에서 인식 엔진을 사용할 수 없는 경우 InkRecognizerContainer는 null입니다. |
| InkStroke |
스트로크의 최종 렌더링에 사용되는 베지어 곡선 매개 변수를 포함하는 단일 잉크 스트로크입니다. |
| InkStrokeBuilder |
원시 포인터 입력에서 스트로크를 빌드합니다. 참고 XAML(Extensible Application Markup Language)을 사용하는 유니버설 Windows 앱의 경우 InkManager 대신 InkPresenter 및 InkCanvas 컨트롤을 사용하는 것이 좋습니다. CreateStrokeFromInkPoints 및 SetDefaultDrawingAttributes를 사용하여 InkPresenter에 대한 스트로크를 프로그래밍 방식으로 빌드합니다. |
| InkStrokeContainer |
InkPresenter에서 렌더링한 InkStroke 개체의 컬렉션을 저장하고 관리하는 속성과 메서드를 제공합니다. 스트로크 컨테이너의 잉크 스트로크를 수정하면 InkPresenter와 연결된 그리기 표면에 즉시 렌더링됩니다. |
| InkStrokeInput |
InkPresenter 개체와 연결된 StrokeInput에 대한 속성 및 이벤트를 제공합니다. |
| InkStrokeRenderingSegment |
전체 잉크 스트로크의 단일 세그먼트입니다. 단일 세그먼트는 시작점, 끝점 및 두 개의 Bezier 제어점으로 구성됩니다. 그러나 스트로크를 구성하는 일련의 세그먼트의 경우 이전 세그먼트의 마지막 지점은 현재 세그먼트의 첫 번째 점입니다. 즉, 전체 스트로크를 나타내려면 각 세그먼트의 끝점만 필요합니다. 각 스트로크는 단일 시작점으로 식별된 첫 번째 세그먼트와 끝점 및 두 개의 Bezier 제어점으로 식별된 나머지 모든 세그먼트가 있는 InkStrokeRenderingSegment 개체의 벡터입니다. |
| InkStrokesCollectedEventArgs |
InkCanvas 컨트롤과 연결된 InkPresenter의 StrokesCollected 이벤트에 대한 이벤트 데이터를 포함합니다. 기본적으로 잉크 스트로크는 대기 시간이 짧은 백그라운드 스레드에서 처리되고 그릴 때 습하게 렌더링됩니다. 스트로크가 완료되면(펜 또는 손가락을 떼거나 마우스 단추를 놓으면) 스트로크가 UI 스레드에서 처리되고 InkCanvas 계층(애플리케이션 콘텐츠 위)에 건조하게 렌더링됩니다. UI 스레드가 사용 중인 경우 스레드를 사용할 수 있게 되면 둘 이상의 잉크 스트로크가 처리(수집)될 수 있습니다. InkCanvas를 로드하기 전에 ActivateCustomDrying 메서드를 호출하여 이 동작을 재정의할 수 있습니다. |
| InkStrokesErasedEventArgs |
InkCanvas 컨트롤과 연결된 InkPresenter의 StrokesErased 이벤트에 대한 이벤트 데이터를 포함합니다. 기본적으로 잉크 스트로크 데이터 및 렌더링은 InkCanvas 컨트롤에 의해 전적으로 관리됩니다. 그러나 InkCanvas를 로드하기 전에 ActivateCustomDrying 메서드를 호출하여 이 동작을 재정의할 수 있습니다. |
| InkSynchronizer |
잉크 입력의 동기화를 관리하고 기본 InkCanvas 컨트롤 대신 유니버설 Windows 앱의 Direct2D 디바이스 컨텍스트로 렌더링하는 메서드를 제공합니다. 이렇게 하려면 잉크 입력을 관리하려면 IInkD2DRenderer 개체가 필요합니다( 복합 잉크 샘플 참조). 기본적으로 잉크 입력은 짧은 대기 시간의 백그라운드 스레드에서 처리되고 그릴 때 "젖은" 상태로 렌더링됩니다. 스트로크가 완료되면(펜 또는 손가락을 들거나 마우스 단추를 뗄 때) 스트로크는 UI 스레드에서 처리되고 InkCanvas 계층(응용 프로그램 콘텐츠 위 계층으로, 젖은 잉크를 대체함)에 대해 "건조" 상태로 렌더링됩니다. ActivateCustomDrying(InkCanvas가 로드되기 전에)를 호출하면 앱은 InkSynchronizer 개체를 만들어 잉크 스트로크가 SurfaceImageSource 또는 VirtualSurfaceImageSource에 대해 건조 상태로 렌더링되는 방식을 사용자 지정합니다. 예를 들어 잉크 스트로크는 별도의 InkCanvas 계층이 아닌 애플리케이션 콘텐츠로 래스터화되고 통합될 수 있습니다. |
| InkUnprocessedInput |
InkCanvas 컨트롤에서 잉크 데이터의 사용자 지정 처리를 위한 속성 및 이벤트를 제공합니다. 데이터는 InkPresenter에서 처리되지 않습니다. InkInputProcessingConfiguration을 사용하여 전달할 데이터를 UnprocessedInput으로 식별합니다. |
| PenAndInkSettings |
HandwritingView를 사용하는 경우 텍스트 컨트롤에서 잉크를 텍스트 입력으로 수락하고 변환하는 작업과 관련된 사용자 설정에 대한 액세스를 제공합니다. |
인터페이스
| IInkPointFactory | |
| IInkPresenterRulerFactory |
InkPresenter 생성에 사용되는 InkPresenterRuler 개체를 생성하는 형식에 대한 구현을 정의합니다. |
| IInkPresenterStencil |
InkCanvas에 반투명 오버레이로 표시되는 시각적 스텐실을 나타냅니다. 스텐실은 잉크 스트로크가 렌더링되는 방식을 변환합니다.
스텐실은 프로그래밍 방식으로 조작할 수 있으며 사용자가 조작할 수 있습니다. 또한 InkCanvas를 사용하여 크기를 조정하고 변환합니다. |
| IInkRecognizerContainer |
하나 이상의 InkRecognizer 개체를 나타냅니다. |
| IInkStrokeContainer |
InkPresenter에서 렌더링한 InkStroke 개체 컬렉션의 관리자를 나타냅니다. 스트로크 컨테이너의 잉크 스트로크를 수정하면 InkPresenter와 연결된 그리기 표면에 즉시 렌더링됩니다. |
열거형
| HandwritingLineHeight |
텍스트 컨트롤에서 텍스트 입력에 잉크를 사용할 때 사용할 수 있는 필기 공간을 지정합니다( HandwritingView를 사용하는 경우). |
| InkDrawingAttributesKind |
InkStroke와 연결된 InkDrawingAttributes의 형식을 지정합니다. |
| InkHighContrastAdjustment |
InkPresenter 개체가 시스템이 고대비 모드일 때 연결된 InkCanvas 컨트롤에서 입력(표준 및 수정)을 처리하는 방법을 지정합니다. |
| InkInputProcessingMode |
InkPresenter 개체가 연결된 InkCanvas 컨트롤의 입력을 해석하는 방법을 지정합니다. 기본적으로 입력은 표준 잉크 또는 지우기 스트로크로 처리되거나 사용자 지정 처리를 위해 UnprocessedInput 으로 앱에 전달될 수 있습니다. |
| InkInputRightDragAction |
InkPresenter 개체가 펜 배럴 단추, 펜 지우개 팁, 마우스 오른쪽 단추 또는 이와 유사한 에서 보조 입력을 처리하는 방법을 지정합니다. 기본적으로 이 보조 입력은 기본 입력으로 처리되고 InkStroke 로 렌더링됩니다(설명 참조). |
| InkManipulationMode |
잉크 입력 모드를 지정합니다. |
| InkPersistenceFormat |
잉크 입력을 저장하기 위한 형식을 지정합니다. |
| InkPresenterPredefinedConfiguration |
하나 이상의 접점의 수동 입력 동작을 지정합니다. SetPredefinedConfiguration과 함께 사용됩니다. |
| InkPresenterStencilKind |
InkCanvas에 표시할 수 있는 스텐실 유형을 지정합니다. |
| InkRecognitionTarget |
필기 인식에 포함할 스트로크를 나타냅니다. |
| PenHandedness |
설정 - 디바이스 - 펜 & Windows Ink> ->> 사용자가 작성한 손 선택에서 사용자가 지정한 대로 기본 설정 쓰기 손을 식별합니다. |
| PenTipShape |
PenTip의 모양을 식별합니다. |