リッチ エディット

  • [アーティクル]

このセクションには、リッチ エディット コントロールで使用されるプログラミング要素に関する情報が含まれています。 豊富な編集コントロールを使用すると、ユーザーはテキストの入力、編集、印刷、保存を行います。 テキストには文字と段落の書式設定を割り当てることができ、埋め込みコンポーネント オブジェクト モデル (COM) オブジェクトを含めることができます。

リッチ エディット コントロールは、複数行の エディット コントロールで使用されるほぼすべてのメッセージと通知コードをサポートしているため、既に編集コントロールを使用しているアプリケーションは、リッチ エディット コントロールを使用するように簡単に変更できます。

概要

トピック 内容
リッチ エディット コントロールについて このセクションでは、高度な編集コントロールについて説明します。
リッチ エディット コントロールの使用 このセクションには、リッチ エディット コントロールを作成して使用する方法を示すトピックが含まれています。

機能

トピック 内容
AutoCorrectProc AutoCorrectProc 関数は、EM_SETAUTOCORRECTPROC メッセージで使用されるアプリケーション定義のコールバック関数です。
EditStreamCallback EditStreamCallback 関数は、EM_STREAMINメッセージとEM_STREAMOUT メッセージで使用されるアプリケーション定義のコールバック関数です。 これは、豊富な編集コントロールにデータのストリームを転送するために使用されます。
EditWordBreakProcEx EditWordBreakProcEx 関数は、EM_SETWORDBREAKPROCEX メッセージで使用されるアプリケーション定義のコールバック関数です。 指定したテキスト内の文字の単語区切りまたは文字クラスおよび単語区切りフラグの文字インデックスを決定します。
HyphenateProc HyphenateProc 関数は、EM_SETHYPHENATEINFO メッセージで使用されるアプリケーション定義のコールバック関数です。 Microsoft Rich Edit コントロールでハイフネーションを実行する方法を決定します。

インターフェイス

トピック 内容
IRichEditOle IRichEditOle インターフェイスは、リッチ エディット コントロールの COM 機能を公開します。 インターフェイスは、 EM_GETOLEINTERFACE メッセージを送信することで取得できます。
IRichEditOleCallback IRichEditOleCallback インターフェイスは、クライアントから OLE 関連の情報を取得するためにリッチ テキスト編集コントロールによって使用されます。 リッチ エディット コントロール クライアントは、このインターフェイスを実装し、 EM_SETOLECALLBACK メッセージを使用してコントロールに割り当てる役割を担います。

メッセージ

トピック 内容
EM_AUTOURLDETECT リッチ エディット コントロールによる URL の自動検出を有効または無効にします。
EM_CANPASTE リッチ エディット コントロールで、指定したクリップボード形式を貼り付けることができるかどうかを指定します。
EM_CANREDO コントロール再実行キューにアクションがあるかどうかを判断します。
EM_DISPLAYBAND EM_FORMATRANGE メッセージを使用してデバイス用に以前に書式設定されたとおりに、リッチ エディット コントロールの内容の一部を表示します。
EM_EXGETSEL リッチ エディット コントロールの選択範囲の開始位置と終了文字位置を取得します。
EM_EXLIMITTEXT ユーザーが入力またはリッチエディット コントロールに貼り付けることができるテキストの量に上限を設定します。
EM_EXLINEFROMCHAR リッチ エディット コントロールに指定した文字を含む行を指定します。
EM_EXSETSEL リッチ エディット コントロール内の文字または COM オブジェクトの範囲を選択します。
EM_FINDTEXT リッチ エディット コントロール内のテキストを検索します。
EM_FINDTEXTEX リッチ エディット コントロール内のテキストを検索します。
EM_FINDTEXTEXW リッチ エディット コントロール内の Unicode テキストを検索します。
EM_FINDTEXTW リッチ エディット コントロール内の Unicode テキストを検索します。
EM_FINDWORDBREAK 指定した文字位置の前後にある次の単語区切りを検索するか、その位置にある文字に関する情報を取得します。
EM_FORMATRANGE 特定のデバイスのリッチ エディット コントロールでテキストの範囲を書式設定します。
EM_GETAUTOURLDETECT リッチ エディット コントロールで自動 URL 検出が有効になっているかどうかを示します。
EM_GETBIDIOPTIONS リッチ エディット コントロールの双方向オプションの現在の状態を示します。
EM_GETCHARFORMAT リッチ エディット コントロールの文字書式を指定します。
EM_GETCTFMODEBIAS リッチ エディット コントロールの Text Services Framework (TSF) モードのバイアス値を取得します。
EM_GETCTFOPENSTATUS TSF キーボードが開いているか閉じているかを判別します。
EM_GETEDITSTYLE 現在の編集スタイル フラグを取得します。
EM_GETEVENTMASK リッチ エディット コントロールのイベント マスクを取得します。 イベント マスクは、コントロールが親ウィンドウに送信する通知コードを指定します。
EM_GETHYPHENATEINFO リッチ エディット コントロールのハイフネーションに関する情報を取得します。
EM_GETIMECOLOR 入力メソッド エディター (IME) コンポジションの色を取得します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
EM_GETIMECOMPMODE リッチ エディット コントロールの現在の IME モードを取得します。
EM_GETIMECOMPTEXT IME コンポジション テキストを取得します。
EM_GETIMEMODEBIAS リッチ エディット コントロールの IME モード バイアスを取得します。
EM_GETIMEOPTIONS 現在の IME オプションを取得します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
EM_GETIMEPROPERTY 現在の入力ロケールに関連付けられている IME のプロパティと機能を取得します。
EM_GETLANGOPTIONS IME およびアジア言語のサポートに関する豊富な編集コントロールのオプション設定を取得します。
EM_GETOLEINTERFACE クライアントがリッチ エディット コントロールの COM 機能にアクセスするために使用できる IRichEditOle オブジェクトを取得します。
EM_GETOPTIONS 豊富な編集コントロール オプションを取得します。
EM_GETPAGEROTATE 非推奨になりました。 リッチ エディット コントロールのテキスト レイアウトを取得します。
EM_GETPARAFORMAT リッチ エディット コントロールの現在の選択範囲の段落書式を取得します。
EM_GETPUNCTUATION リッチ エディット コントロールの現在の句読点文字を取得します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
EM_GETREDONAME リッチ エディット コントロールの再実行キュー内の次のアクションの種類 (存在する場合) を取得します。
EM_GETSCROLLPOS 編集コントロールの現在のスクロール位置を取得します。
EM_GETSELTEXT リッチ エディット コントロールで現在選択されているテキストを取得します。
EM_GETTEXTEX 必要な特定のコード ベースのリッチ エディット コントロールからすべてのテキストを取得します。
EM_GETTEXTLENGTHEX さまざまな方法でテキストの長さを計算します。 通常は、コントロールからテキストを受け取るバッファーを作成する前に呼び出されます。
EM_GETTEXTMODE リッチ エディット コントロールの現在のテキスト モードと元に戻すレベルを取得します。
EM_GETTEXTRANGE リッチ エディット コントロールから指定した文字範囲を取得します。
EM_GETTYPOGRAPHYOPTIONS リッチ エディット コントロールの文字体裁オプションの現在の状態を取得します。
EM_GETUNDONAME Microsoft Rich Edit 2.0 以降: 次の元に戻す操作の種類 (ある場合) を取得します。
Microsoft Rich Edit 1.0: このメッセージはサポートされていません。
EM_GETWORDBREAKPROCEX 現在登録されている拡張単語区切りプロシージャのアドレスを取得します。
EM_GETWORDWRAPMODE リッチ エディット コントロールの現在の折り返しオプションと単語区切りオプションを取得します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
EM_GETZOOM 現在のズーム比 (常に 1/64 ~ 64) を取得します。
EM_HIDESELECTION リッチ エディット コントロールで選択範囲を非表示または表示します。
EM_ISIME 現在の入力ロケールが東アジアのロケールかどうかを判断します。
EM_PASTESPECIAL リッチ エディット コントロールに特定のクリップボード形式を貼り付けます。
EM_RECONVERSION [IME の再変換] ダイアログ ボックスを呼び出します。
EM_REDO コントロールの再実行キューで次のアクションをやり直します。
EM_REQUESTRESIZE リッチ エディット コントロールに EN_REQUESTRESIZE通知コード を親ウィンドウに送信するように強制します。
EM_SELECTIONTYPE リッチ エディット コントロールの選択の種類を決定します。
EM_SETBIDIOPTIONS リッチ エディット コントロールの双方向オプションの現在の状態を設定します。
EM_SETBKGNDCOLOR リッチ エディット コントロールの背景色を設定します。
EM_SETCHARFORMAT リッチ エディット コントロールの文字書式を設定します。
EM_SETCTFMODEBIAS リッチ エディット コントロールの TSF モード バイアスを設定します。
EM_SETCTFOPENSTATUS TSF キーボードを開くか閉じます。
EM_SETEDITSTYLE 現在の編集スタイル フラグを設定します。
EM_SETEVENTMASK リッチ エディット コントロールのイベント マスクを設定します。 イベント マスクは、コントロールが親ウィンドウに送信する通知コードを指定します。
EM_SETFONTSIZE 選択したテキストのフォント サイズを設定します。
EM_SETHYPHENATEINFO リッチ エディット コントロールでハイフネーションを実行する方法を設定します。
EM_SETIMECOLOR IME コンポジションの色を設定します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
EM_SETIMEMODEBIAS リッチ エディット コントロールの IME モード バイアスを設定します。
EM_SETIMEOPTIONS IME オプションを設定します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
EM_SETLANGOPTIONS 豊富な編集コントロールで IME とアジア言語のサポートのオプションを設定します。
EM_SETOLECALLBACK リッチエディット コントロールに、OLE 関連のリソースと情報をクライアントから取得するためにコントロールが使用する IRichEditOleCallback オブジェクトを提供します。
EM_SETOPTIONS リッチ エディット コントロールのオプションを設定します。
EM_SETPAGEROTATE 非推奨になりました。 リッチ エディット コントロールのテキスト レイアウトを設定します。
EM_SETPALETTE リッチ エディットで表示ウィンドウに使用されるパレットを変更します。
EM_SETPARAFORMAT リッチ エディット コントロールの現在の選択範囲の段落書式を設定します。
EM_SETPUNCTUATION リッチ エディット コントロールの句読点文字を設定します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
EM_SETSCROLLPOS 特定のポイントまでスクロールするようにリッチ エディット コントロールに指示します。
EM_SETTARGETDEVICE リッチ エディット コントロールで "表示される内容" (WYSIWYG) の書式設定に使用されるターゲット デバイスと行幅を設定します。
EM_SETTEXTEX WM_SETTEXTとEM_REPLACESELの機能を組み合わせ、コード ページを使用してテキストを設定し、リッチ テキストまたはプレーン テキストを使用する機能を追加します。
EM_SETTEXTMODE リッチ エディット コントロールのテキスト モードまたは元に戻すレベルを設定します。 コントロールにテキストが含まれている場合、メッセージは失敗します。
EM_SETTYPOGRAPHYOPTIONS リッチ エディット コントロールの文字体裁オプションの現在の状態を設定します。
EM_SETUNDOLIMIT 元に戻すキューに格納できるアクションの最大数を設定します。
EM_SETWORDBREAKPROCEX 拡張単語区切りプロシージャを設定します。
EM_SETWORDWRAPMODE リッチ エディット コントロールの単語折り返しオプションと改行オプションを設定します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
EM_SETZOOM ズーム率を 1/64 から 64 の間の任意の場所に設定します。
EM_SHOWSCROLLBAR [テキスト ホスト] ウィンドウのスクロール バーの 1 つを表示または非表示にします。
EM_STOPGROUPTYPING コントロールが現在の元に戻す操作に追加の入力アクションを収集するのを停止します。 コントロールは、次の入力操作 (ある場合) を元に戻すキューの新しいアクションに格納します。
EM_STREAMIN リッチ エディット コントロールの内容を、アプリケーション定義の EditStreamCallback コールバック関数によって提供されるデータストリームに置き換えます。
EM_STREAMOUT リッチ エディット コントロールの内容をアプリケーション定義 の EditStreamCallback コールバック関数に渡します。 コールバック関数は、データのストリームを、選択したファイルまたはその他の場所に書き込むことができます。

通知

トピック 内容
EN_ALIGNLTR 段落の方向が左から右に変更されたことをリッチ エディット コントロールの親ウィンドウに通知します。 リッチ エディット コントロールは、この通知コードを WM_COMMAND メッセージの形式で送信します。
EN_ALIGNRTL 段落の方向が右から左に変更されたことをリッチ エディット コントロールの親ウィンドウに通知します。 リッチ エディット コントロールは、この通知コードを WM_COMMAND メッセージの形式で送信します。
EN_CORRECTTEXT SYV_CORRECT ジェスチャが発生したことをリッチ エディット コントロールの親ウィンドウに通知し、親ウィンドウでテキストの修正を取り消す機会を与えます。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_DRAGDROPDONE ドラッグ アンド ドロップ操作が完了したことをリッチ エディット コントロールの親ウィンドウに通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_DROPFILES ユーザーがコントロールにファイルをドロップしようとしていることをリッチ エディット コントロールの親ウィンドウに通知します。 リッチ エディット コントロールは、WM_DROPFILES メッセージを受信すると 、この 通知コードをWM_NOTIFY メッセージの 形式で送信します。
EN_IMECHANGE IME 変換の状態が変更されたことをリッチ エディット コントロールの親に通知します。 このメッセージは、オペレーティング システムのアジア言語バージョン でのみ 使用できます。 リッチ エディット コントロールは、この通知コードを WM_COMMAND メッセージの形式で送信します。
EN_LINK ユーザーがマウスをクリックしたとき、またはマウス ポインターがCFE_LINK効果を持つテキストの上にある場合に、リッチ エディット コントロールの親ウィンドウに通知します。 コントロールの親ウィンドウは、 WM_NOTIFY メッセージを介してこの通知コードを受け取ります。
EN_LOWFIRTF リッチ エディット コントロールの親ウィンドウに、サポートされていないリッチ テキスト形式 (RTF) キーワードが受信されたことを通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_MSGFILTER リッチ エディット コントロールの親ウィンドウに、コントロール内のキーボードまたはマウス イベントを通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_OBJECTPOSITIONS コントロールがオブジェクトを読み取るときに、リッチ エディット コントロールの親ウィンドウに通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_OLEOPFAILED COM オブジェクトに対するユーザー 操作が失敗したことをリッチ エディット コントロールの親ウィンドウに通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_PROTECTED リッチ エディット コントロールの親ウィンドウに、ユーザーが保護されたテキスト範囲を変更するアクションを実行していることを通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_REQUESTRESIZE リッチ エディット コントロールの親ウィンドウに、コントロールの内容がコントロールのウィンドウ サイズより小さいか大きいことを通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_SAVECLIPBOARD リッチ エディット コントロールの親ウィンドウに、コントロールが閉じられ、クリップボードに情報が含まれていることを通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_SELCHANGE 現在の選択範囲が変更されたことをリッチ エディット コントロールの親ウィンドウに通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
EN_STOPNOUNDO コントロールが元に戻す状態を維持するのに十分なメモリを割り当てることができないアクションが発生したことを、リッチ エディット コントロールの親ウィンドウに通知します。 リッチ エディット コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。

構造体

トピック 内容
BIDIOPTIONS リッチ エディット コントロールに関する双方向情報が含まれています。 この構造体は、コントロールの双方向情報を取得および設定するために、 EM_GETBIDIOPTIONS メッセージと EM_SETBIDIOPTIONS メッセージによって使用されます。
CHARFORMAT リッチ エディット コントロールの文字書式に関する情報が含まれています。
CHARFORMAT2 リッチ エディット コントロールの文字書式に関する情報が含まれています。 CHARFORMAT2 は、 CHARFORMAT 構造体の Microsoft Rich Edit 2.0 拡張機能です。 Microsoft Rich Edit 2.0 では、 EM_GETCHARFORMAT メッセージと EM_SETCHARFORMAT メッセージでいずれかの構造を使用できます。
CHARRANGE リッチ エディット コントロールの文字範囲を指定します。
COMPCOLOR コンポジション文字列の色の設定が含まれます。
EDITSTREAM EM_STREAMINまたは EM_STREAMOUT メッセージ内のリッチ エディット コントロールにアプリケーションが渡す情報 が 含まれます。 リッチ エディット コントロールでは、この情報を使用して、データのストリームをコントロールに転送したり、コントロールの外に転送したりします。
ENCORRECTTEXT 修正する選択したテキストに関する情報が含まれます。
ENDROPFILES EN_DROPFILES通知コードに関連付けられている情報 が 含まれます。 リッチ エディット コントロールは、 WM_DROPFILES メッセージを受信したときにこの通知コードを送信します。
ENLINK リッチ エディット コントロールからの EN_LINK 通知コードに関する情報が含まれます。
ENLOWFIRTF リッチ エディット コントロールでサポートされていない RTF キーワードに関する情報が含まれています。
ENOLEOPFAILED 失敗した操作に関する情報が含まれます。
ENPROTECTED EN_PROTECTED通知コードに関連付けられている情報 が 含まれます。 リッチ エディット コントロールは、ユーザーが保護されたテキストを編集しようとしたときにこの通知を送信します。
ENSAVECLIPBOARD クリップボード上のオブジェクトとテキストに関する情報が含まれます。
FINDTEXT リッチ エディット コントロールの検索操作に関する情報が含まれます。 この構造体は、EM_FINDTEXT メッセージと共 に 使用されます。
FINDTEXTEX リッチ エディット コントロールで検索するテキストに関する情報が含まれます。 この構造体は、 EM_FINDTEXTEX メッセージと共に使用されます。
FORMATRANGE リッチ エディット コントロールが特定のデバイスの出力の書式設定に使用する情報を格納します。 この構造体は、EM_FORMATRANGE メッセージと共 に 使用されます。
GETTEXTEX リッチ エディット コントロールからテキストを取得する操作に関する情報が含まれます。 この構造体は、EM_GETTEXTEX メッセージの wParam に渡されます。
GETTEXTLENGTHEX リッチ エディット コントロールのテキスト長の計算方法に関する情報が含まれます。 この構造体は、EM_GETTEXTLENGTHEX メッセージの wParam に渡されます。
HYPHENATEINFO リッチ エディット コントロールのハイフネーションに関する情報が含まれます。
HYPHRESULT リッチ エディット コントロールのハイフネーションの結果に関する情報が含まれます。
IMECOMPTEXT リッチ エディット コントロールのコンポジション テキストに関する情報が含まれます。
MSGFILTER キーボードまたはマウス イベントに関する情報が含まれます。 リッチ エディット コントロールは、この構造を EN_MSGFILTER 通知コードの一部として親ウィンドウに送信し、親がメッセージを変更したり、処理されないようにしたりできます。
OBJECTPOSITIONS オブジェクトの位置情報を格納します。
PARAFORMAT リッチ エディット コントロールの段落書式属性に関する情報が含まれています。 この構造体は、メッセージの EM_GETPARAFORMAT と EM_SETPARAFORMAT で使用されます。
PARAFORMAT2 リッチ エディット コントロールの段落書式属性に関する情報が含まれています。
句読点 リッチ エディット コントロールで使用される句読点に関する情報が含まれます。
REOBJECT オブジェクトに関する情報を格納します。
REPASTESPECIAL 貼り付けたオブジェクトの表示の側面が、オブジェクトの内容またはオブジェクトを表すアイコンに基づいている必要があるかどうかを示す情報が含まれます。
REQRESIZE リッチ エディット コントロールの要求されたサイズを格納します。 リッチ エディット コントロールは、この構造体をEN_REQUESTRESIZE通知コードの一部として親ウィンドウ に 送信します。
SELCHANGE EN_SELCHANGE通知コードに関連付けられている情報 が 含まれます。 リッチ エディット コントロールは、現在の選択内容が変更されたときに、その親ウィンドウにこの通知を送信します。
SETTEXTEX テキストの設定で使用するコード ページ (存在する場合)、テキストがコントロール内のすべてのテキストを置き換えるかどうか、または選択範囲だけを置き換えるかどうか、および元に戻す状態を保持するかどうかを指定します。
TEXTRANGE リッチ エディット コントロールからテキストの範囲を受け取ります。 この構造体は、 EM_GETTEXTRANGE メッセージによって入力されます。 lpstrText メンバーが指すバッファーは、すべての文字と終端の null 文字を受け取るのに十分な大きさである必要があります。

定数

トピック 内容
リッチ エディット コントロールのイベント マスク フラグ イベント マスクは、リッチ エディット コントロールが親ウィンドウに送信する通知コードを指定します。
リッチ エディット コントロール のスタイル リッチ エディット コントロールに固有のウィンドウ スタイルについて説明します。