Dynamic-Renderer 플러그 인
동적 렌더러 플러그 인은 RealTimeStylus 개체에서 처리되는 태블릿 펜 데이터를 실시간으로 표시하는 개체입니다. 나중에 양식 새로 고침과 같은 이벤트의 경우 동적 렌더러 플러그 인 또는 잉크 수집기 플러그 인이 잉크를 다시 그릴 수 있습니다.
DynamicRenderer 개체
RealTimeStylus 개체는 IStylusSyncPlugin 인터페이스를 구현합니다. DynamicRenderer 개체는 잉크를 그릴 때 실시간으로 렌더링합니다. DynamicRenderer 개체를 사용하는 동안 Refresh 메서드가 호출되면 DynamicRenderer 개체는 현재 수집 중인 스트로크를 다시 그립니다. DynamicRenderer 개체의 Enabled 속성은 처음에 FALSE로 설정됩니다.
참고
관리 코드의 Paint 이벤트 처리기 내에서 DynamicRenderer 개체의 Refresh 메서드를 호출할 때 DynamicRenderer 개체의 ClipRectangle 속성을 PaintEventArgs 개체의 ClipRectangle 속성으로 설정합니다.
DynamicRenderer 개체는 잉크 데이터를 일시적으로 캐시할 수 있습니다. 관리 코드에서 이 기능을 사용하려면 EnableDataCache 속성을 TRUE로 설정합니다. DynamicRenderer 개체가 IStylusSyncPlugin.StylusUp 메서드에 대한 호출을 받으면 스트로크 데이터를 캐시하고 스트로크에 대한 StylusUpData 개체에 대한 응답으로 사용자 지정 스타일러스 데이터를 Input 큐에 추가합니다. CustomStylusData 개체의 CustomDataId 속성은 DynamicRendererCachedDataGuid 값으로 설정되고 CustomStylusData 개체의 Data 속성에는 DynamicRendererCachedData 개체가 포함됩니다. 스트로크가 수집되고 정적으로 렌더링될 수 있으면 DynamicRenderer 개체의 ReleaseCachedData 메서드를 호출합니다. DynamicRenderer 개체를 사용하는 동안 Refresh 메서드가 호출되면 DynamicRenderer 개체는 캐시된 모든 스트로크를 다시 그립니다. DataCacheEnabled 속성이 false로 설정되면 캐시된 스트로크 데이터가 삭제됩니다.
다음 다이어그램에서는 DynamicRenderer 개체의 DataCacheEnabled 속성이 설정되면 DynamicRenderer 개체가 태블릿 펜 데이터에 데이터를 추가하는 방법을 보여 줍니다.
이 다이어그램에서 원 문자 "SD"는 StylusDown 개체를 나타내고 문자가 "P"인 원은 RealTimeStylus 개체의 출력 큐에 이미 추가되었으며 아직 비동기 플러그 인 컬렉션으로 전송되지 않은 Packets 개체를 나타냅니다. 원 문자 "SU"는 RealTimeStylus 개체가 현재 처리 중인 StylusUp 개체를 나타냅니다. 동기 플러그 인 컬렉션으로 전송된 다음 출력 큐에 배치됩니다. "DR"이라는 문자가 지정된 원은 "SU"와 연결된 스타일러스 업 알림에 대한 응답으로 DynamicRenderer 플러그 인이 입력 큐에 추가한 사용자 지정 스타일러스 데이터를 나타냅니다. 그런 다음 "DR"이라는 문자가 지정된 사용자 지정 스타일러스 데이터가 동기 플러그 인에 전달된 다음, 다음 태블릿 펜 데이터가 처리되기 전에 출력 큐에 전달됩니다. 빈 원은 이후 태블릿 펜 데이터가 추가되는 출력 큐의 위치를 나타냅니다. 또한 다이어그램에는 잉크 수집 플러그 인이 스트로크를 처리한 후 캐시된 스트로크 데이터를 해제하기 위해 DynamicRenderer 개체의 ReleaseCachedData 메서드를 호출하는 잉크 수집기 플러그 인이 표시됩니다.
특별 고려 사항
다음 목록에서는 DynamicRenderer 개체를 사용할 때 고려해야 할 다른 사항에 대해 설명합니다.
둘 이상의 RealTimeStylus 개체에 DynamicRenderer 개체를 연결하면 안 됩니다. DynamicRenderer 개체가 연결된 두 개의 RealTimeStylus 개체가 활성화되면 다음이 발생합니다.
- DynamicRenderer 개체는 RealTimeStylusEnabled 메서드에 대한 두 번째 호출에 대한 응답으로 예외를 throw합니다.
- 사용하도록 설정된 두 번째 RealTimeStylus 개체는 Error 개체를 생성하고 플러그 인 컬렉션의 나머지 플러그 인에 오류에 대해 알릴 수 있습니다.
- DynamicRenderer 개체는 태블릿 펜 데이터 렌더링을 중지합니다.
RealTimeStylus 개체는 Guid 매개 변수를 DynamicRendererCachedDataGuid GUID(Globally Unique Identifier)로 설정하여 AddCustomStylusDataToQueue 메서드를 호출할 때 예외를 throw합니다.
DynamicRenderer 개체는 COM(구성 요소 개체 모델) 래퍼로 구현되며 IStylusSyncPlugin 인터페이스 메서드를 직접 호출할 수 없습니다. COM 작업 및 RealTimeStylus 개체에 대한 자세한 내용은 StylusInput API에 대한 구현 정보를 참조하세요.
사용자 지정 렌더링
StylusDown, Packets 및 StylusUp 알림을 구독하는 동기 플러그 인을 만들어 고유한 동적 렌더러 플러그 인을 만들 수 있습니다. 그러면 플러그 인이 그려질 때 스트로크를 렌더링할 수 있습니다. 예를 들어 자유 형식 선택 상자 또는 선택 상자를 사용하는 선택 도구를 구현하는 한 가지 방법이 될 수 있습니다.