InkPresenter.ActivateCustomDrying 메서드

  • 참조

정의

네임스페이스:
Windows.UI.Input.Inking
편집

앱에서 잉크 입력 렌더링을 완벽하게 제어해야 했음을 나타냅니다.

기본적으로 잉크 입력은 짧은 대기 시간의 백그라운드 스레드에서 처리되고 그릴 때 "젖은" 상태로 렌더링됩니다. 스트로크가 완료되면(펜 또는 손가락을 떼거나 마우스 단추를 놓으면) 스트로크가 UI 스레드에서 처리되고 렌더링 계층(애플리케이션 콘텐츠 위에 있고 젖은 잉크를 대체함)에 "건조"하게 렌더링됩니다.

InkPresenter 호스팅 모델

InkCanvas

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

InkDesktopHost(Windows 10 버전 1511 이상)

Win32 앱은 DirectComposition 시각적 트리를 사용하여 InkDesktopHost에서InkPresenter를 호스트할 수 있습니다.

이렇게 하려면 잉크 입력을 관리하려면 IInkD2DRenderer 개체가 필요합니다( 복합 잉크 샘플 참조).

CoreInkPresenterHost(Windows 10 Fall Creators Update 이상)

사용자 고유의 Windows 에서 InkPresenter 를 호스트 합니다.Ui. 연결된 InkCanvas 컨트롤이 없는 컴퍼지션 트리입니다.

public:
 virtual InkSynchronizer ^ ActivateCustomDrying() = ActivateCustomDrying;
InkSynchronizer ActivateCustomDrying();
public InkSynchronizer ActivateCustomDrying();
function activateCustomDrying()
Public Function ActivateCustomDrying () As InkSynchronizer

반환

InkSynchronizer

사용자 지정 잉크 스트로크 렌더링에 사용되는 개체입니다.

설명

오류 코드

E_ILLEGAL_METHOD_CALL(0x8000000E)

InkCanvas가 로드된 후 ActivateCustomDrying이 호출되면 throw됩니다.

InkCanvas를 로드하기 전에 이 메서드를 호출해야 합니다.

사용자 지정 건조 및 InkToolbar
기본적으로 잉크 입력은 짧은 대기 시간의 백그라운드 스레드에서 처리되고 그릴 때 "젖은" 상태로 렌더링됩니다. 스트로크가 완료되면(펜 또는 손가락을 들거나 마우스 단추를 뗄 때) 스트로크는 UI 스레드에서 처리되고 InkCanvas 계층(응용 프로그램 콘텐츠 위 계층으로, 젖은 잉크를 대체함)에 대해 "건조" 상태로 렌더링됩니다. 잉크 플랫폼을 사용하여 이 동작을 재정의하고 잉크 입력의 사용자 지정 건조를 수행하여 수동 입력 환경을 완전히 사용자 지정할 수 있습니다.

앱이 사용자 지정 건조 구현을 사용하여 InkPresenter 의 기본 잉크 렌더링 동작을 재정의하는 경우 렌더링된 잉크 스트로크는 더 이상 InkToolbar에서 사용할 수 없으며 InkToolbar 의 기본 제공 지우기 명령은 예상대로 작동하지 않습니다. 지우기 기능을 제공하려면 모든 포인터 이벤트를 처리하고, 각 스트로크에 대해 적중 횟수 테스트를 수행하고, 기본 제공 "모든 잉크 지우기" 명령을 재정의해야 합니다.

사용자 지정 건조에 대한 자세한 내용은 UWP 앱의 펜 상호 작용 및 Windows Ink 참조하세요.

적용 대상

추가 정보