InkSynchronizer.BeginDry メソッド

定義

既定の InkCanvas コントロールではなく、アプリの Direct2D デバイス コンテキストへのインク入力のカスタム "ドライ" を開始します。 これには、インク入力を管理するために IInkD2DRenderer オブジェクトが必要です ( 「複雑なインクサンプル」を参照してください)。

既定では、手書き入力は低待機時間のバックグラウンド スレッドで処理され、描画と同時に "ウェット" レンダリングが行われます。 ストロークが完了すると (ペンまたは指が画面を離れるか、マウスのボタンが離されると)、UI スレッドでストロークが処理されて、InkCanvas レイヤーへの "ドライ" レンダリングが行われます (アプリケーション コンテンツの上にレンダリングされてウェット インクが置き換えられます)。

ActivateCustomDrying を (InkCanvas が読み込まれる前に) 呼び出すと、SurfaceImageSource または VirtualSurfaceImageSource へのインク ストロークのドライ レンダリングの方法をカスタマイズするための InkSynchronizer オブジェクトが作成されます。 たとえば、インク ストロークをラスタライズしてアプリケーション コンテンツに (別の InkCanvas レイヤーとしてではなく) 統合することができます。

public:
 virtual IVectorView<InkStroke ^> ^ BeginDry() = BeginDry;
IVectorView<InkStroke> BeginDry();
public IReadOnlyList<InkStroke> BeginDry();
function beginDry()
Public Function BeginDry () As IReadOnlyList(Of InkStroke)

戻り値

IInkD2DRenderer オブジェクトに渡す "ウェット" インク ストロークのコレクション。

注釈

エラー コード

E_ILLEGAL_METHOD_CALL (0x8000000E)

EndDry が呼び出される前に、 BeginDry が再度呼び出された場合にスローされます。

適用対象

こちらもご覧ください