다음을 통해 공유


Windows.UI.Input.Inking 네임스페이스

Windows Ink 앱에 대한 입력, 처리 및 관리 지원을 제공합니다. 다음 내용이 포함됩니다.

  • 잉크 스트로크 그리기
  • 스트로크 캡처
  • 스트로크 렌더링.
  • 스트로크 선택.
  • 스트로크 삭제.
  • 스트로크 저장 및 로드
  • 필기 인식을 통해 스트로크를 텍스트로 변환합니다.
  • 클립보드에서 스트로크 복사 및 붙여넣기
  • 적중 테스트(또는 스트로크 대상 지정).

클래스

InkDrawingAttributes

InkStroke 그리기와 연결된 속성을 제공합니다.

InkDrawingAttributesPencilProperties

InkCanvas에서 연필 스트로크를 렌더링하기 위한 정적 InkDrawingAttributes 속성 집합을 제공합니다.

InkDrawingAttributes.CreateForPencil을 호출하고InkDrawingAttributes.PencilProperties에 액세스하여 이 클래스의 instance 가져옵니다.

InkInputConfiguration

InkPresenter 개체에서 처리할 수 있는 보조 입력 유형을 관리합니다.

InkInputProcessingConfiguration

InkPresenter 개체에서 입력을 처리하는 방법을 관리합니다.

InkManager

참고

XAML(Extensible Application Markup Language)을 사용하는 유니버설 Windows 앱의 경우 InkManager 대신 InkPresenterInkCanvas 컨트롤을 사용하는 것이 좋습니다.

하나 이상의 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 대신 InkPresenterInkCanvas 컨트롤을 사용하는 것이 좋습니다.

CreateStrokeFromInkPointsSetDefaultDrawingAttributes를 사용하여 InkPresenter에 대한 스트로크를 프로그래밍 방식으로 빌드합니다.

InkStrokeContainer

InkPresenter에서 렌더링한 InkStroke 개체의 컬렉션을 저장하고 관리하는 속성과 메서드를 제공합니다.

스트로크 컨테이너의 잉크 스트로크를 수정하면 InkPresenter와 연결된 그리기 표면에 즉시 렌더링됩니다.

InkStrokeInput

InkPresenter 개체와 연결된 StrokeInput에 대한 속성 및 이벤트를 제공합니다.

InkStrokeRenderingSegment

전체 잉크 스트로크의 단일 세그먼트입니다.

단일 세그먼트는 시작점, 끝점 및 두 개의 Bezier 제어점으로 구성됩니다. 그러나 스트로크를 구성하는 일련의 세그먼트의 경우 이전 세그먼트의 마지막 지점은 현재 세그먼트의 첫 번째 점입니다. 즉, 전체 스트로크를 나타내려면 각 세그먼트의 끝점만 필요합니다.

각 스트로크는 단일 시작점으로 식별된 첫 번째 세그먼트와 끝점 및 두 개의 Bezier 제어점으로 식별된 나머지 모든 세그먼트가 있는 InkStrokeRenderingSegment 개체의 벡터입니다.

InkStrokesCollectedEventArgs

InkCanvas 컨트롤과 연결된 InkPresenterStrokesCollected 이벤트에 대한 이벤트 데이터를 포함합니다.

기본적으로 잉크 스트로크는 대기 시간이 짧은 백그라운드 스레드에서 처리되고 그릴 때 습하게 렌더링됩니다. 스트로크가 완료되면(펜 또는 손가락을 떼거나 마우스 단추를 놓으면) 스트로크가 UI 스레드에서 처리되고 InkCanvas 계층(애플리케이션 콘텐츠 위)에 건조하게 렌더링됩니다. UI 스레드가 사용 중인 경우 스레드를 사용할 수 있게 되면 둘 이상의 잉크 스트로크가 처리(수집)될 수 있습니다.

InkCanvas를 로드하기 전에 ActivateCustomDrying 메서드를 호출하여 이 동작을 재정의할 수 있습니다.

InkStrokesErasedEventArgs

InkCanvas 컨트롤과 연결된 InkPresenterStrokesErased 이벤트에 대한 이벤트 데이터를 포함합니다.

기본적으로 잉크 스트로크 데이터 및 렌더링은 InkCanvas 컨트롤에 의해 전적으로 관리됩니다. 그러나 InkCanvas를 로드하기 전에 ActivateCustomDrying 메서드를 호출하여 이 동작을 재정의할 수 있습니다.

InkSynchronizer

잉크 입력의 동기화를 관리하고 기본 InkCanvas 컨트롤 대신 유니버설 Windows 앱의 Direct2D 디바이스 컨텍스트로 렌더링하는 메서드를 제공합니다. 이렇게 하려면 잉크 입력을 관리하려면 IInkD2DRenderer 개체가 필요합니다( 복합 잉크 샘플 참조).

기본적으로 잉크 입력은 짧은 대기 시간의 백그라운드 스레드에서 처리되고 그릴 때 "젖은" 상태로 렌더링됩니다. 스트로크가 완료되면(펜 또는 손가락을 들거나 마우스 단추를 뗄 때) 스트로크는 UI 스레드에서 처리되고 InkCanvas 계층(응용 프로그램 콘텐츠 위 계층으로, 젖은 잉크를 대체함)에 대해 "건조" 상태로 렌더링됩니다.

ActivateCustomDrying(InkCanvas가 로드되기 전에)를 호출하면 앱은 InkSynchronizer 개체를 만들어 잉크 스트로크가 SurfaceImageSource 또는 VirtualSurfaceImageSource에 대해 건조 상태로 렌더링되는 방식을 사용자 지정합니다. 예를 들어 잉크 스트로크는 별도의 InkCanvas 계층이 아닌 애플리케이션 콘텐츠로 래스터화되고 통합될 수 있습니다.

InkUnprocessedInput

InkCanvas 컨트롤에서 잉크 데이터의 사용자 지정 처리를 위한 속성 및 이벤트를 제공합니다. 데이터는 InkPresenter에서 처리되지 않습니다.

InkInputProcessingConfiguration을 사용하여 전달할 데이터를 UnprocessedInput으로 식별합니다.

PenAndInkSettings

HandwritingView를 사용하는 경우 텍스트 컨트롤에서 잉크를 텍스트 입력으로 수락하고 변환하는 작업과 관련된 사용자 설정에 대한 액세스를 제공합니다.

인터페이스

IInkPointFactory

InkStroke 생성에 사용되는 InkPoint 개체를 생성하는 형식에 대한 구현을 정의합니다.

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의 모양을 식별합니다.

추가 정보