リッチ エディット

  • [アーティクル]

このセクションでは、リッチ エディット コントロールで使用されるプログラミング要素について説明します。 リッチ エディット コントロールを使用すると、ユーザーはテキストの入力、編集、印刷、保存ができます。 テキストには、文字と段落の書式を割り当てることができ、埋め込み Component Object Model (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 Input Method Editor (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 現在登録されている拡張 word-break プロシージャのアドレスを取得します。
EM_GETWORDWRAPMODE リッチ エディット コントロールの現在の word wrap オプションと word-break オプションを取得します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
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 リッチ エディット コントロールの「what you see is what you get" (WYSIWYG)」書式設定に使用される対象デバイスと行幅を設定します。
EM_SETTEXTEX WM_SETTEXT と EM_REPLACESEL 機能を組み合わせて、コード ページを使用してテキストを設定し、リッチ テキストまたはプレーン テキストのいずれかを使用する機能を追加します。
EM_SETTEXTMODE リッチ エディット コントロールのテキスト モードまたは元に戻すレベルを設定します。 コントロールにテキストが含まれている場合、メッセージは失敗します。
EM_SETTYPOGRAPHYOPTIONS リッチ エディット コントロールの文字体裁オプションの現在の状態を設定します。
EM_SETUNDOLIMIT 元に戻すキューに格納できるアクションの最大数を設定します。
EM_SETWORDBREAKPROCEX 拡張 word-break プロシージャを設定します。
EM_SETWORDWRAPMODE リッチ エディット コントロールの word-wrapping と word-breaking オプションを設定します。 このメッセージは、オペレーティング システムのアジア言語バージョンでのみ使用できます。
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 リッチ エディット コントロールの親ウィンドウに、サポートされていない Rich Text Format (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 リッチ エディット コントロールの段落書式属性に関する情報が含まれます。
PUNCTUATION リッチ エディット コントロールで使用される句読点に関する情報が含まれます。
REOBJECT オブジェクトに関する情報が含まれます。
REPASTESPECIAL 貼り付けたオブジェクトの特徴が、オブジェクトの内容に基づいているか、オブジェクトを表すアイコンに基づいているかを識別する情報が含まれます。
REQRESIZE リッチ エディット コントロールの要求されたサイズが含まれます。 リッチ エディット コントロールは、この構造体を EN_REQUESTRESIZE 通知コードの一部として親ウィンドウに送信します。
SELCHANGE EN_SELCHANGE 通知コードに関連付けられている情報が含まれます。 リッチ エディット コントロールは、現在の選択範囲が変更されたときに、その親ウィンドウにこの通知を送信します。
SETTEXTEX テキストの設定に使用するコード ページ (ある場合)、コントロール内のすべてのテキストを置き換えるかどうか、または選択範囲だけを置き換えるかどうか、および元に戻す状態を保持するかどうかを指定します。
TEXTRANGE リッチ エディット コントロールからテキストの範囲を受け取ります。 この構造体は、EM_GETTEXTRANGE メッセージによって埋められます。 lpstrText メンバーが指すバッファーは、すべての文字と終端の null 文字を受け取るのに十分な大きさである必要があります。

定数

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