リッチ エディット
このセクションには、リッチ エディット コントロールで使用されるプログラミング要素に関する情報が含まれています。 リッチ エディット コントロールを使用すると、ユーザーはテキストの入力、編集、印刷、保存を行います。 テキストには文字と段落の書式を割り当てることができ、埋め込みコンポーネント オブジェクト モデル (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 文字を受け取るのに十分な大きさである必要があります。 |
定数
話題 | 内容 |
---|---|
リッチ エディット コントロールのイベント マスク フラグ を する | イベント マスクは、リッチ エディット コントロールが親ウィンドウに送信する通知コードを指定します。 |
リッチ エディット コントロール スタイル を する | リッチ エディット コントロールに固有のウィンドウ スタイルについて説明します。 |