InkEdit メッセージ (Win32 のみ)
InkEdit コントロールは、RichEdit コントロールのスーパー クラスです。 すべての RichEdit メッセージは、ほとんどの場合、直接渡され、RichEdit とまったく同じ効果を持ちます。 これは、イベント通知メッセージにも適用されます。
これらのメッセージを送信するには、次のパラメーターを使用して SendMessage 関数を呼び出します。
| C++ |
|---|
|
Message
InkEdit コントロールの親ウィンドウは、WM_NOTIFY メッセージを介してイベント通知メッセージを受信します。
LRESULT CALLBACK WindowProc(
HWND hWnd, // handle to window
UINT uMsg, // WM_NOTIFY
WPARAM wParam, // InkEdit control identifier
LPARAM lParam // see documentation for notification messages
);
| メッセージの取得/設定 | 説明 |
|---|---|
| EM_GETINKMODE |
InkEdit コントロールの手描き入力モードを取得します。 パラメーター: このメッセージにはパラメーターがありません。 wParam と lParam は 0 である必要があります。 戻り値: このメッセージは、 InkMode 列挙で定義されている値の 1 つを返します。この値は、インク コレクションを無効にするか、インクを収集するか、インクとジェスチャを収集するかを指定します。 |
| EM_SETINKMODE |
InkEdit コントロールのインク モードを設定します。 パラメーター: WparamInkMode 列挙の値の 1 つを指定します。インク コレクションを無効にするか、インクを収集するか、インクとジェスチャを収集するかを指定します。 Lparamこのパラメーターは使用されません。0 にする必要があります。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外を返します。 解説: これは、EM_GETSTATUSがIES_Idleを返す場合にのみ使用する必要があります。 |
| EM_GETINKINSERTMODE |
InkEdit コントロールのインク挿入モードを取得します。 パラメーター: このメッセージにはパラメーターがありません。 wParam と lParam は 0 である必要があります。 戻り値: このメッセージは、 InkInsertMode 列挙の値の 1 つを返します。これは、インクをテキストとしてコントロールに挿入するか、インクとして挿入するかを指定します。 |
| EM_SETINKINSERTMODE |
InkEdit コントロールのインク挿入モードを設定します。 このメッセージを送信しても、Microsoft Windows XP Tablet PC Edition 以外にインストールされているオペレーティング システムで使用しても影響はありません。 パラメーター: WparamInkInsertMode 列挙の値の 1 つを指定します。これは、インクをテキストとしてコントロールに挿入するか、インクとして挿入するかを指定します。 Lparamこのパラメーターは使用されません。0 にする必要があります。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外を返します。 |
| EM_GETDRAWATTR |
InkEdit コントロールの現在の描画属性を取得します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 Lparam現在の InkDrawingAttributes オブジェクトを受け取るポインター ( IInkDrawingAttributes **pDrawAttr) を 指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外を返します。 |
| EM_SETDRAWATTR |
今後のインク コレクションに使用する描画属性を設定します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 LparamInkDrawingAttributes オブジェクトへのポインター (IInkDrawingAttributes *pDrawAttr) を指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外を返します。 |
| EM_GETRECOTIMEOUT |
InkEdit コントロールの認識タイムアウトをミリ秒単位で取得します。 パラメーター: このメッセージにはパラメーターがありません。 wParam と lParam は 0 である必要があります。 戻り値: このメッセージは、認識タイムアウトをミリ秒単位で返します。 |
| EM_SETRECOTIMEOUT |
InkEdit コントロールの認識タイムアウトをミリ秒単位で設定します。 パラメーター: Wparam認識タイムアウトをミリ秒単位で指定します。 Lparamこのパラメーターは使用されません。0 にする必要があります。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外を返します。 |
| EM_GETGESTURESTATUS |
InkEdit コントロールのジェスチャの状態を取得します。 パラメーター: WparamInkApplicationGesture 列挙で定義されているジェスチャの種類を指定します。 Lparamこのパラメーターは使用されません。0 にする必要があります。 戻り値: このメッセージは、InkEdit コントロールがジェスチャをサブスクライブする場合は TRUE 、 InkEdit コントロールがジェスチャをサブスクライブしない場合は FALSE を返します。 |
| EM_SETGESTURESTATUS |
InkEdit コントロールのジェスチャの状態を設定します。 パラメーター: WparamInkApplicationGesture 列挙で定義されているジェスチャの種類を指定します。 Lparamジェスチャのサブスクライブが有効な場合は TRUE 、ジェスチャのリッスンが有効になっていない場合は FALSE を指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外を返します。 解説: これは、EM_GETSTATUSがIES_Idleを返す場合にのみ使用する必要があります。 |
| EM_GETRECOGNIZER |
InkEdit コントロールが使用する認識エンジンを取得します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 LparamInkEdit コントロールが使用する IInkRecognizer オブジェクトを受け取る IInkRecognizer* へのポインターを指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外を返します。 |
| EM_SETRECOGNIZER |
InkEdit コントロールが使用する認識エンジンを設定します。
InkEdit コントロールに Factoid を使用する場合は、このメッセージの送信後に再適用する必要があります。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 LparamInkEdit コントロールが後で使用するために使用する IInkRecognizer オブジェクトを設定する IInkRecognizer* へのポインターを指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外を返します。 解説: これは、EM_GETSTATUSがIES_Idleを返す場合にのみ使用する必要があります。 |
| EM_GETFACTOID |
認識に使用する Factoid を取得します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 Lparamファクト型文字列を受け取る BSTR へのポインターを指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 |
| EM_SETFACTOID |
認識に使用する Factoid を設定します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 Lparamfactoid 文字列を含む BSTR を指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 解説: これは、EM_GETSTATUSがIES_Idleを返す場合にのみ使用する必要があります。 |
| EM_GETSELINK |
選択範囲内のインクを取得します。 このメッセージからアクセスする前に、インクを認識する必要があります。 最初に認識されない場合、EM_GETSELINKは常に 0 の InkDisp オブジェクトを返します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 Lparam現在の選択範囲内で InkDisp オブジェクトを受け取る安全な配列を受け取る VARIANT へのポインターを指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 |
| EM_SETSELINK |
選択範囲内のインクを設定します。 このメッセージを送信しても、Windows XP Tablet PC Edition 以外のオペレーティング システムがインストールされている場合は影響を受けません。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 Lparam現在の選択範囲を置き換える InkDisp オブジェクトの安全な配列を持つ VARIANT へのポインターを指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 |
| EM_GETSELINKDISPLAYMODE |
InkDisplayMode 列挙のいずれかの値を使用して、選択した範囲内のインクの現在の外観を返します。 パラメーター: このメッセージにはパラメーターがありません。 wParam と lParam は 0 である必要があります。 戻り値: このメッセージは 、InkDisplayMode 列挙 (IDM_Text または IDM_Ink) のいずれかの値を返します。これは、コントロールでの選択範囲の表示方法を指定します。 |
| EM_SETSELINKDISPLAYMODE |
InkDisplayMode 列挙のいずれかの値を使用して、選択した範囲内のインクの外観を設定します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 LparamInkDisplayMode 列挙で定義されているように、選択した範囲でのインクの表示方法を指定します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 このメッセージを送信しても、Windows XP Tablet PC Edition 以外のオペレーティング システムがインストールされている場合は影響を受けません。 |
| EM_GETSTATUS |
InkEdit コントロールの状態を取得します。 パラメーター: このメッセージにはパラメーターがありません。 wParam と lParam は 0 である必要があります。 戻り値: このメッセージは InkEditStatus 列挙のいずれかの値を返します。この列挙は、コントロールがアイドル状態であるか、インクを収集しているか、インクを認識しているかを指定します。 |
| EM_RECOGNIZE |
認識を強制します。 パラメーター: このメッセージにはパラメーターがありません。 wParam と lParam は 0 である必要があります。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 |
| EM_GETMOUSEICON |
マウス アイコンを取得します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 Lparam現在の MouseIcon HICON で入力される HICON* ポインターを指定します。 この HICON には、HICON または NULL 値を指定できます。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 |
| EM_SETMOUSEICON |
マウス アイコンを設定します。 パラメーター: WparamInkEdit コントロールが HICON ハンドルを所有する必要がある場合は TRUE 、 InkEdit コントロールが HICON ハンドルを所有しない場合は FALSE に設定されるブール値を指定します。 InkEdit コントロールが HICON を所有している場合、HICON は適切に処理され、破棄されます。 それ以外の場合、呼び出し元は HICON を所有し、その削除を担当します。 Lparam新しい HICON 値を指定します。 NULL を使用して値をクリアします。 既定値は NULL です。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 |
| EM_GETMOUSEPOINTER |
マウス ポインターを取得します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 Lparam現在の MousePointer 値が入力された InkMousePointer * ポインターが含まれます。 これは InkCollector::get_MousePointer プロパティと同じように動作します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 |
| EM_SETMOUSEPOINTER |
マウス ポインターを設定します。 パラメーター: Wparamこのパラメーターは使用されません。0 にする必要があります。 LparamInkMousePointer 列挙で定義されている新しい MousePointer 値を格納します。 これは InkCollector::p ut_MousePointer プロパティと同じように動作します。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外の値を返します。 |
| EM_GETUSEMOUSEFORINPUT |
マウス入力がペン入力として扱われるかどうかの状態を取得します。 パラメーター: このメッセージにはパラメーターがありません。 wParam と lParam は 0 である必要があります。 戻り値: このメッセージは 、FALSE の 場合は 0、 TRUE の場合は 1 を返します。 |
| EM_SETUSEMOUSEFORINPUT |
マウス入力をペン入力として扱うかどうかの状態を設定します。 パラメーター: Wparamマウス入力をペン入力として扱うかどうかを決定するブール値を指定します。 Lparamこのパラメーターは使用されません。0 にする必要があります。 戻り値: このメッセージは、成功した場合は 0、エラーが発生した場合は 0 以外を返します。 解説: これは、EM_GETSTATUSがIES_Idleを返す場合にのみ使用する必要があります。 |
| イベント通知メッセージ | 説明 |
|---|---|
| IECN_STROKE |
IInkStrokeDisp が作成されたことを InkEdit コントロールの親ウィンドウに通知します。 これは、次のパラメーターを含むWM_NOTIFY メッセージで送信されます。 パラメーター: Wparamメッセージを送信したコントロールの識別子を指定します。 LparamIEC_STROKEINFO構造体へのポインターを指定します。 戻り値: クライアントは、ストロークを受け入れるには 0 を返し、ストロークを取り消すには 1 を返します。 |
| IECN_GESTURE |
ジェスチャが認識されたことを InkEdit コントロールの親ウィンドウに通知します。 これは、次のパラメーターを含むWM_NOTIFY メッセージで送信されます。 パラメーター: Wparamメッセージを送信したコントロールの識別子を指定します。 LparamIEC_GESTUREINFO構造体へのポインターを指定します。 戻り値: クライアントはジェスチャを受け入れるために 0 を返し、ジェスチャを取り消すには 1 を返します。 |
| IECN_RECOGNITIONRESULT |
認識が発生したことを InkEdit コントロールの親ウィンドウに通知します。 これは、次のパラメーターを含むWM_NOTIFY メッセージで送信されます。 パラメーター: Wparamメッセージを送信したコントロールの識別子を指定します。 LparamIEC_RECOGNITIONRESULTINFO構造体へのポインターを指定します。 戻り値: メッセージを処理すると、クライアントは 0 を返します。 |