テキストエディタやワープロソフトのように自由に文字を表示したり入力し、 またキーボードやマウスを使って表示済みテキストを編集できる非常に高機能な ウィジェットです。

　指定した行数／桁数の領域をウィンドウ内に確保し、その領域の中にプログラムから文字を表示できるほか、操作者がキーボードやマウスを使って自由に文字を入力したり編集することができます。
　また文字の修飾についても、フォントの指定、色付け、アンダーライン、取り消し線、網掛け、左右寄せなど豊富な機能を利用でき、簡単なワープロソフトのような機能を持っています。
　またメニューバーやポップアップメニューと併用すれば、テキストエディタのような使い勝手にすることができます。

注：以下の解説では「テキストウィジェット」よりも、「テキストボックス」という言い方を多く使っています（特に処理単語名で）。理由は、単に「テキスト」と言うとウィジェットへ付与された文字列を連想してしまうからです。

■テキストボックスのＩＤ取得と配置
       プログラム例：
　親となるウィンドウＩＤ、行数、桁数を指定することでテキストウィジェットのＩＤを取得して準備をおこないます。
　他のウィジェットと同様に引き続き有効化と配置が必要です。テキストウィジェットは配置に関するパラメータを設定するケースは少ないため、上記のようにＩＤを取得してすぐに 「有効化して配置」 するのが楽です。
　なお「有効化して配置」を使った場合は、自動的に”並べ配置”となるため、他の配置手段を適用したい場合には「有効化して配置」は使わず、そちらの手順に従ってください。
　　（詳しくは その他の配置手段（座標配置と格子配置） を参照ください）

■スクロールバーを付ける場合
　先の「テキストボックスのＩＤを取得」単独での設置の場合はスクロールバーは付きません。そのため表示域からあふれる長いテキストを表示した場合はキー操作だけのスクロールとなり操作性が悪いため、スクロールバーを付与するこちらの方式を勧めます。
　スクロールバーを付けるには、「フレーム収容のテキストボックスのＩＤを取得」 と 「フレーム収容のテキストボックスを有効化」をコンビネーションで使います（さらに別途配置が必要です）。

　　　注：横スクロールは本バージョンではサポートしません

       プログラム例：
　本機能を使うと，テキストボックスとスクロールバーは合体して１つのフレームに収容され、このフレームを配置することで描画されます。フレームの配置には並べ配置のほか、他の配置手段も使えます。
　　　（他の配置手段については、その他の配置手段（座標配置と格子配置） を参照ください）

■デフォルトフォント
　テキストウィジェット内に表示される文字のフォントは、既に 「フォント」−「フォントマクロ」 で解説した「TkFixedFont」というフォントマクロが使われます。以下のような解説でした。
　もしテキストボックス全体にフォントを指定したいなら、以下の方法でおこなってください。
       プログラム例：
　そうではなく、テキストウィジェットの中の一部の文字のフォントを変更したいなら（文字の表示前・表示後どちらであっても）後ほど解説する フォントの設定 の項を参考してタグを使ってください。

■メニューバーとの併用
　メニューバーと併用することもできます。最初にメニューバーを設置し、その後にテキストボックスを設置します。メニューバーについては メニューバー を参考にしてください。



　以下に示す「テキスト表示」など、テキスト表示系の処理単語を使い、テキストボックスに文字列を表示したり改行することができます。感覚としてはコンソールへの文字表示（「表示」や「改行」など）と似ています。

■サンプルプログラム１ （text-edit）
　キャレットや表示位置などテキスト中の位置を操作するカーソルの概念、およびそこへの文字・文字列の表示機能を以下のサンプルプログラムにまとめてあります。この先の解説はこのサンプルを併せて動かしながら確認してください。

■テキスト表示など
       プログラム例：
　現在の”テキスト表示位置”に文字や数値を表示したり改行します。コンソールアプリケーションでの「表示」「数値表示」や「改行」などに相当しますが、出力先のテキストボックスを指定する点が特徴です。
　これらの表示系単語を使って表示すると、”テキスト表示位置”は自動的にその文字のぶんだけ先に進むため、次々とテキスト表示系単語を実行することができます。（テキスト表示位置についてはこの先で詳しく説明します）
　「テキスト表示」に与えるべき文字列が複数行に渡る場合ですが、ソースプログラム中に固定値として記入するとき、改行を示す記号はコンソール系のアプリケーションと同様に、
のように、ソース中に「＆改行＆」を入れることで改行コードを含めたり、「続」によって文字列定数の継続を行うこともできます。
　（「続」を使って文字列定数を複数行に分割して書くのはあくまでソースを読みやすくするためであり必須ではありません。コンパイラはこれを連結して１つの文字列定数として扱います）

■複数のテキストボックスへ表示を行う
　メインウィンドウにテキストボックスが複数ある場合、あるいは、メインウィンドウだけでなく子ウィンドウにもテキストボックスがある場合の注意について述べます。
　１つのテキストボックスに対して文字を表示したあと、別のテキストボックスにも文字を表示すると、フォーカスが後のテキストボックスに移動してしまいます。たとえばキャレットが前のテキストボックスから消えてしまいます。
　これが不都合な場合には、別のテキストボックスへ一連の文字を表示したあと、元のテキストボックスに対して「フォーカスを当て」ることでフォーカスを戻してください。
　なお、この対処のためのフォーカス当てはウィンドウに対してではなく、テキストウィジェットに対しておこなってください。（理由は 選択状態の挙動について補足 で解説しています）



　テキストボックス内の特定の文字位置を指し示したり、取得することがあります。

■文字位置列（概念）
　まず「文字位置」という概念があります。
　それを表す文字列形式のデータを（GUIエンジン特有の形式で）「文字位置列」と呼ぶことにします。単に「位置」では整数のように見えてしまうからです。

　行、桁を指し示す位置として「文字位置列」という言い方をします。形式は以下の通りですが、数値であったりシンボル名であったりまちまちです。

注：以下の具体値はGUIエンジン特有の内部形式であり、ユーザが使う場合はより抽象化された日本語を使うため覚えていただく必要はありません。参考程度とお考えください。

　たとえば、GUIエンジンのネイティブな表現で "1.0" となるところ、Mindのソースコードでは抽象的に「テキスト先頭位置」と書くことができます。（もちろん、あえてネイティブな表記を書くこともできます）

■キャレット位置とテキスト表示位置

■抽象的なキャレット位置
　以下の単語群でキャレットに関連する抽象的な位置を指示できます。

■テキスト先頭・末尾位置の参照
　テキスト全体の先頭あるいは末尾の位置を得る単語があります。        プログラム例：

■キャレットを移動
       プログラム例：
　指定した文字位置にキャレットを移動させます。

注：テキストウィジェットを開いて何かテキストを表示しただけではキャレットは現れません。次のいずれかでキャレットが現れます。
−−−−−−−−−−−−−−−−−−−−
・テキスト域でマウス左クリック
・テキスト域にフォーカスを与える
・処理単語 「キャレットを移動」 を実行
・処理単語 「指定位置が見えるようにする」 または
　「指定位置が１行目に見えるようにする」 を実行
−−−−−−−−−−−−−−−−−−−−

■表示位置を設定
       プログラム例：（キャレットのある行の左端に「ABC」を挿入）
　「テキスト表示」, 「テキスト改行」などテキスト表示系の処理単語を使ってテキストウィジェットへの文字列表示を行う際、それに先だって「どの位置に表示するか」を指定する機能です。
　テキストウィジェットを生成した直後の表示位置はテキストボックス先頭です。
　表示位置を特に指定しない場合は前回にテキスト表示した次の位置から表示が行われます。

■行と桁を文字位置列に変換
　たとえば、３行５桁目をテキスト表示位置に設定したい時、
と書くことはできません。「３」や「５」は整数値なので、本ライブラリが規定する "文字位置列" 形式ではないためです。この変換をおこなう処理単語です。
       プログラム例： （３行５桁目に「ABC」を挿入します）
       同上： （同じことをするのに作業用文字列実体を明示する）
　本処理単語は生成した文字位置列をライブラリ内部の文字列実体変数に格納し、そこを指す文字列情報をスタックに返します。その仕組み上、２度続けて本単語を呼び出すと後の実行で前の文字列を破壊してしまうので、もし最初に取得した文字列を消費しないまま次の単語呼び出しをするような場合は、作業用の文字列実体変数を明示する呼び出し方法を使うか、あるいは得られた文字位置列を別獲得した文字列実体変数に退避するようにしてください。
　作業用に、あるいは退避用に文字列実体を確保する際、その実体長さは「文字位置列長さ」という定数が使えます。（上記プログラム例の後者がそのようにしています）

■文字位置列を行と桁に変換
　先と逆で、文字位置列データを整数としての行位置と桁位置の２つの整数値として返す機能です。        プログラム例：

■文字位置から具体値を得る
       プログラム例：
　たとえば「キャット位置」や「テキスト末尾位置」など抽象名を使って文字位置を指定することがありますが、そられが具体的にどのような位置なのかを知りたいときに使います。
　返される文字位置列は必ず数値を使った形式（例："2.0"）です。

補足：サンプルプログラム "text-edit.exe" のメニュー「その他の操作」に次の２つのボタンがあり具体値を確認できますが、これのボタン処理が「文字位置から具体値を得て」を使っています。

　 　ボタン：「抽象表現のキャレット文字位置の具体値を確認」
　 　ボタン：「抽象表現のテキスト文字位置の具体値を確認」

サンプルプログラム "text-edit.exe" では右クリックで現れるポップアップメニューの中に選択領域を操作する多くの項目（たとえば、「選択域のテキストを参照」など）がありますから解説と併せてお試しください。

　一般的なエディタやワープロと同様に、テキストの一部を選択状態にすることができます。
　テキストの一部をマウスでドラッグした個所が選択状態になり、青色反転になるので選択されていることが分かります。選択する方法としてマウスのドラッグのほか、左クリックしたあと Shiftキーを押しながらカーソル移動キーを操作することでも可能です。
　マウスやキーボードを使ってテキストの一部を選択すること自体のためにMind側でプログラムを組む必要はありません。テキストウィジェットが基本機能としてサポートしているためです。
　Mindで書くのは選択されたテキストに対して何らかのアクションをとる段階・・たとえば選択範囲のテキストを参照したり、文字修飾したり、削除するなど・・からになります。

記： もっと言えば、選択状態でDelキーを押すと選択領域が削除され、あるいは Ctrl-c 打鍵で領域がコピーされますが、これもまたMind側でプログラムを組む必要はなく、テキストウィジェットの基本機能として実現されます。
人による編集機能 にテキストウィジェットの標準機能としてのキー操作が解説されているので参考にしてください。

　選択状態になった文字領域（青地に白抜き文字になった個所）のことを「選択領域」あるいは「選択域」と呼ぶことにします。

■選択域の文字位置を表すシンボル
　選択域の開始／終了の文字位置を表すシンボルがあります。
　これは抽象表現なので選択域の場所を問わず一定で、この値を得たあと退避する必要はありません。ソース中に必要な都度、この定数を記述してください。

注： 選択域終了位置は ”選択範囲の最終文字の位置” ではないので注意してください。正確には、”選択範囲のその次の位置（=Next）” になります。

       プログラム例：
■選択域の文字位置を利用する場合の注意
　先の「選択域開始位置」,「選択域終了位置」を使うには注意が必要です。共に選択域の文字位置を表すシンボルですが、何も選択されていない状態でこのシンボルを使うとGUIエンジン内部でエラーが発生します。
　したがって、「選択域開始位置」,「選択域終了位置」を引用する処理を書くには、必ず事前に”今選択中かどうか”を調べ、選択中でない場合にはすぐリターンするとか、文字列を返す処理単語であれば空列を積んでリターンする・・などの前処理を行ってください。
　”今選択中かどうか”を調べるにはこの先で解説する処理単語 「選択状態？」 が使えます。サンプルプログラム "text-edit" のソースコードでも随所にこの検査を入れています。

■選択領域のテキストを参照するには
　先に解説した 選択域の文字位置を表すシンボルと、処理単語 「指定範囲のテキストを参照」 のコンビネーションで実現できます。
       プログラム例１： （格納先を指定しない、選択状態チェック無し）
       プログラム例２： （格納先を指定しない、選択状態チェック有り）
       プログラム例３： （格納する文字列実体変数を明示、選択状態チェック有り）

■選択状態であるかを知るには
　現在、選択状態であるかを調べて真偽を返します。
■選択状態を解除するには
　GUIエンジン標準の機能として、Ctrl キーを押しながら ¥ キー を操作することによって解除できますが、プログラムで解除することもできます。

注： Escキー打鍵で選択を解除したくなるかも知れませんが、テキストウィジェットの素のままではEscキーでは解除できません。もちろんそのようなバインドを組めば可能です。

　テキストウィジェットはテキストエディタのような機能であり、素の状態で使ったとしても・・つまり単にテキストボックスを生成しただけであっても、ある程度の編集機能が利用できます。このことを知っておけば、キー入力やマウス操作に応答する処理を二重に作ってしまう無駄が避けられます。

■標準で備わっている操作
　テキストウィジェットに標準で備わっている操作を以下に示します。
　概ねエディタなどでよく見かける操作に合致しているはずです。（一部はUNIX系OSのviに似ています）

• 通常の文字キーの打鍵で文字がキャレット位置に挿入されます
• カーソル移動キーによりキャレットを上下左右に移動できます
• Home、Endキーを押すとキャレットを行左端・右端に移動できます
• Ctrlキーを押しながらHome、Endキーを押すとキャレットをテキスト先頭、テキスト末尾に移動できます
• 任意の場所で左クリックするとキャレットをそこに移動できます
• 任意の場所でダブルクリックすると、キャレットのある行全体が選択状態になります
• 任意の場所でShiftキーを押しながらカーソル移動キーを押すと、なぞった部分を選択状態にできます
• 任意の場所でShiftキーを押しながらHome、Endキーを押すと、キャレットの行左側、行右側を選択状態にできます
• Ctrlキー押しながら / キーを押すとテキスト全体が選択状態になります
• Ctrlキー押しながら \ キーを押すと選択状態を解除できます
• マウスでドラッグすると、その領域が選択状態になります
  　→その状態でカーソル移動キーを操作すると選択範囲を調整できます
  　→その状態でCtrlキーを押しながら別の個所を左クリックすると
  　　選択を維持したままキャレットを移動できます
• Delキーを押すとキャレット位置の文字を１文字だけ削除できます
  もし選択状態であれば選択域のテキストが削除されます
• Ctrlキーを押しながら k キーを押すとキャレットから右の行後半部を削除できます
• Ctrlキーを押しながら o キーを押すとキャレットから右の行後半部を次行に送り、行後半を空けます
• Ctrlキーを押しながら z キーを押すと直前の編集操作をやり直し（アンドゥ）します（アンドゥ機能を有効化してある場合）
• Ctrlキーを押しながら c キーを押すと選択範囲をコピーします
• Ctrlキーを押しながら x キーを押すと選択範囲を切り抜きます
• Ctrlキーを押しながら v キーを押すとコピーバッファ内容を挿入します

注：Ctrl-c による選択範囲のコピーですが、GUIエンジンの標準はコピー操作をしても選択状態が残りますが、本ライブラリではコピー操作で選択が解除されます

　　　　　　　　
■アンドゥ機能
　テキストボックスを単に生成した状態ではアンドゥ機能は抑制されていますが以下の機能を使うことで有効にできます。
       プログラム例：
　アンドゥ機能が有効になっているとき、Ctrlキーを押しながら z キーを押すと直前の編集操作が元に戻されます（GUIエンジン標準の機能）。デフォルトは無効です。
　アンドゥ機能を有効したとき、GUIエンジンの標準として Ctrl-z でアンドゥが働くので、テキストウィジェットに対して明なバインドをおこなう必要は無いのですが、「Ctrl-z でアンドゥが働く」ことを知らせることは意味があります。もしユーザが作成するアプリにメニューバーがあるなら、「編集」メニューから誘導されるサブメニューに「やり直し」ボタンを設置し、そのボタンに Ctrl-z を（見かけ上）バインドすると良いでしょう。（ 「この番号のメニュー項目にショートカットを表示」 のほうを使います）

記：上記「見かけ上のバインド」については、サンプル "text-edit.exe" が実際そのようにして表示上、バインドされているように見せています。詳しくは 「メニューバー」−「この番号のメニュー項目にショートカットを表示」 を参照ください

■サンプルプログラム
　プログラムによる編集機能は、以下のサンプルプログラムが使っています。併せて動かしながら読み進めてください。

■文字・文字列の表示
　まずテキストボックス中への文字列の表示は、「文字・文字列の表示」−「テキスト表示など」 で解説したテキスト表示系の処理単語でおこなってください。
　テキスト表示系の単語名に「表示」という言葉が使われていますが厳密には挿入です。どこへの挿入かと言えば”テキスト表示位置”への挿入です。キャレット位置ではないので注意が必要です。

       プログラム例：（キャレットのある個所に「ABC」を挿入）
       プログラム例： （３行５桁目に「ABC」を挿入）
　なお、テキスト表示系単語を使って表示した場合、表示位置は自動的にそのぶんだけ先に進むため、再度の「表示位置を設定」は不要で、次々とテキスト表示系単語を実行することができます。
       プログラム例： （３行５桁目に 「ABC」 ・ 改行 ・ 「DEF」を挿入）

■イメージの表示

注：下記で「イメージＩＤ」を指定する個所があります。イメージＩＤの生成方法については別途、「イメージ」−「イメージデータの生成」を参照してください。

　テキストウィジェット内にイメージを表示させることができます。
       プログラム例１： （３行３桁目にイメージを表示）
       プログラム例２：
　最初に「イメージをロード」によりイメージＩＤを得て、そのＩＤを使って「イメージをテキスト表示」を行ないます。

〇表示される位置は文字列の表示の時と同様にテキスト表示位置です。必要に応じて「表示位置を設定」により事前に表示位置を指定してください。

〇揃え指定にある「下辺揃え」は前後の文字ラインの下辺にイメージの下辺を揃える意味になります。

〇パディングはイメージの周囲に空白を作るものです。不要なら０を指定してください

〇ビットマップはファイル経由での指定であればイメージと同様に使えます。ただし標準ビットマップ（ビットマップを名前で指定するタイプ）は表示できません。

■指定範囲のテキストを削除
       プログラム例１： （キャレット位置にある１文字を削除する）
       プログラム例２： （キャレット位置から行末までの文字列を削除する）
       プログラム例３： （キャレット位置から行末までの文字群を改行コードを含めて削除する）
　上のプログラム例２では「キャレット行末位置」を使っています。文字通りの意味ですが、これは厳密には "キャレットのある行の末尾文字位置＋１" で、結局のところ、改行コードの位置を表すことになります。その改行コードの位置をNextとするような指定なので、末尾文字までになります。

       プログラム例４： （キャレットの位置からテキスト末尾まですべて削除）
　上の例では「テキスト末尾位置」を使っています。「テキスト末尾位置」とは、テキスト全体の末尾文字の次の位置（そこには最終行の行末コードが有るか、または何も無いかのいずれか）を示します。

       プログラム例５： （キャレットのある行のすべての文字を削除）
       プログラム例６： （キャレットのある行自体を削除）
　上の２例の違いをよくご覧ください。前者ではキャレットのある行内のすべて の文字を削除するのに比べ、後者ではキャレットのある行自体を削除します。

■指定範囲のテキストを参照

注： 本単語「指定範囲のテキストを参照」とよく似たものに、単なる「テキストを参照」という語もあります。そちらはラベルやボタンなどの汎用ウィジェット向けです。混同しないようご注意ください。

       プログラム例１： （キャレットのある１行分のテキストを得る）
       プログラム例２： （同上、格納する文字列実体変数を明示）
　指定する文字範囲のテキスト内容を参照します。
　GUIエンジン内部での行末コードは LF の１文字ですが本ライブラリでWindows標準の行末コード CR/LF の2文字に置換してから返します。
　上のプログラム例１，２は、キャレットのある１行分のテキストを得るものです。行末コードは含みません。もし行末コード込みで得たいのなら、
　　　　　　キャレット行頭位置から
　　　　　　キャレット次行位置までを
としてください。（終了位置はNext位置なのでそのようになります）。 　本処理単語は、読み出したテキスト内容をライブラリ内部の文字列実体変数「テキスト参照文字列」に格納し、そこを指す文字列情報をスタックに返します。
　その仕組み上、２度続けて本単語を呼び出すと後の実行で前の文字列を破壊してしまうので（たとえ文字列情報変数を別にしたとしても）最初に取得したデータを消費しないまま次の単語呼び出しする場合は次のいずれかの対応を行ってください。

　　　A: データを得る都度、別々の文字列実体変数に退避する

　　　B: 格納先の実体変数を明示するような呼び出しをおこなう
　　　　　（上記構文の後者）

■書き換え禁止
　テキストボックス内を編集不可（書き換え禁止）にすることができます。        プログラム例：
　アプリの操作者がテキストウィジェットの内容を編集できないように（文字の挿入や削除などを禁止）します。読んでもらうだけの情報表示に使うと良いでしょう。
　書き換え禁止にするとキャレットが消え、キー入力が効かないことが分かります。 許可にすれば再び現れます。 　さらに、書き換え禁止にすると操作者のみならずプログラムからであっても文字列表示や削除ほか、すべての編集操作ができなくなります。もし「プログラムから表示する時を除き、常時書き込み禁止」にしたい場合は、プログラムからの表示の都度、禁止を解除してください。

補足：サンプルプログラム "text-edit.exe" で「その他の操作」メニューの中に書き換え禁止・許可を試すためのボタンがあります。

■書き換え禁止を参照
　書き換え禁止状態であるかを参照するには処理単語「状態を参照」を使います。構文など詳細は 「ウィジェットの属性指定」−「ウィジェットの状態を参照」 を参照願います。        プログラム例：

■テキストの特定の場所が見えるようにする
　テキストボックスのビューの中に特定の文字場所が見えるように自動スクロールする機能が２種類あります。
　たとえば、プログラムからテキストボックスに大量のテキストを表示させた後に、末尾部分がテキストボックス内に見えるように調整する、あるいは、何らかのキーを打鍵（たとえば Ctrl-Home）することでテキスト先頭部から改めて表示しキャレットも１行目に行く・・といった用途に利用できます。

記： 上記はあえて説明のために書きましたが、実は Ctrl-Home 打鍵によってビューをテキストの先頭に戻すのはテキストウィジェットの標準機能なのでプログラムを組む必要はありません

　前者は指定位置がビューのどこかに見えれば可というものであり、後者は指定位置が必ず テキストボックスの１行目から表示されるようにします。

補足：サンプルプログラム "text-edit.exe" で主メニュー「文字位置を設定」の中に「指定位置が見えるようにする」および「指定位置が１行目に見えるようにする」というボタンがあるので操作してみてください。（あらかじめ同メニューグループ内の「以下の試験のため大サイズのサンプル文に取り換え」というボタンを実行しておいてください）

注：　文字位置の指定について注意があります。
サンプルプログラム "text-edit.exe" で「指定位置が・・に見えるようにする」の試験では、大サイズのサンプル文を表示してからおこなうことを前提としています。
大サイズのサンプル文は全サイズだけでなく１行も長いため、テキストボックス内で折り畳み表示されていますが、折り畳まった長い行が１行として数えられます。したがって、本試験のため指定した行番号は、かならずしもテキストボックスの表示を上から数えた視覚的な行位置には合致しません。

　マウスやキー操作によるコピー＆ペーストは、プログラムからでも行うことができます。

■クリップボードのクリア

■クリップボードへの追加
　指定した文字列をクリップボードに追加します（格納ではなく追加です）。
　一般的な「コピー」操作に相当するプログラム処理は、次のプログラム例のようにクリアと追加のコンビネーションとして実現してださい。（クリアしたあと、追加を繰り返せば累積を記憶することもできます）
       プログラム例：

■クリップボードの参照
　現在のクリップボードの内容を得ます。
　よく使われる「ペースト」操作に相当するプログラム処理は、「クリップボードを参照」と「テキスト表示」系単語のコンビネーションとして実施してください。
　本処理単語は読み出したテキスト内容をライブラリ内部の文字列実体変数「クリップボード参照文字列」に格納し、そこを指す文字列情報をスタックに返します。
　その仕組み上、２度続けて本単語を呼び出すと後の実行で前の文字列を破壊してしまうので最初に取得したデータを消費しないまま次の単語呼び出しする場合は次のいずれかの対応を行ってください。

　　　A: データを得る都度、別々の文字列実体変数に退避する

　　　B: 格納先の実体変数を明示するような呼び出しをおこなう
　　　　　（上記構文の後者）

■クリップボードを使うサンプルプログラム
　"text-edit.src" をお読みいただき、また実行してみてください。サンプルプログラムでのクリップボードの操作はメニューバー「編集」の下のほうの項目にあります。



　ここまでの解説により、テキストウィジェットをエディタのように使うための基本的な機能を学習しました。
　このセクションでは、各種文字修飾など、テキストウィジェットをワープロソフトのように使うための解説をおこないます。
　テキストボックス中の文字の修飾は「テキストタグ」と呼ぶタグを使うことでおこないます。（タグにはほかに、キャンバスウィジェットで使う「図形タグ」と呼ぶものもあります）

■タグを使うサンプルプログラム
　このセクションで解説するタグ機能は以下のサンプルプログラムで実際に確認できます。この先の解説はサンプルを併せて動かしながら確認してください。

■テキストタグを使う理由
　テキストの文字修飾をおこなうのに、文字に対して直接修飾を施すのではなく、まずタグを作成し、そのタグに対して各種属性を付与し、そのあと必要とするテキスト個所にタグを適用・・という手順になります。
　たとえばテキスト中の複数個所（例えば見出しなど）について同じフォントを設定する場合、それぞれの個所にフォント指定を行うのは煩雑で処理時間もかかります。
　一方、まずタグに対してフォント指定を行い、そのタグを複数個所のテキストに適用するほうがフォント指定が１回で済むだけでなく、後になって修飾を変更する場合もその１個所のタグ設定を修正するだけて済みます。

■テキストタグの生成と有効化
       プログラム例：
　テキストウィジェットのＩＤを指定し、テキストタグのＩＤを取得します。
　このＩＤは後に各種属性設定をおこなったり、タグをテキストの一部に付与するのに使われます。
　属性設定が終った後、タグの有効化をおこなうとタグが使えるようになります。

記： 属性付与による実際の見え方の効果はサンプル
　　 "text-tag-complex.exe" を動かして確認して
　　 ください。

　　（１）「タグ操作」−「以下の試験の前に多くのタグを定義」
　　（２）「タグ操作」−「各種タグを使い分けてテキスト表示」

■テキストまたはタグに対する属性設定
　この先、テキストに属性を指定する方法を解説しますが、幾つかの処理単語で、属性設定に使うＩＤとして テキストウィジェット または テキストタグ のいずれも可・・というものがあります。このため、そのような処理単語の文法解説ではＩＤの指定を以下のように記述することにします。
　　　　　＜WidgIDorタグ＞
　上記のように書いた部分には、テキストウィジェットＩＤ または テキストタグＩＤ の、どちらも指定可能であることを意味します。（たとえば「テキスト行間を設定」がそうです）

■色の設定
       プログラム例：
　タグに対して文字色または背景色を設定できます。
　色の指定方法については既に、「ウィジェットの属性指定」−「ウィジェットの文字色と背景色」 にて解説しているので詳細はそちらを参照してください。

■フォントの設定
       プログラム例：
　タグにフォントを設定します。
　フォントの指定方法については既に、「２６　フォント」−「フォントの設定」 にて解説しているので詳細はそちらを参照ください。

■網掛け
　網掛けの設定をおこないます。正確には、網掛けするビットマップパターンを設定します。多く使われるのは「gray25」など、GUIエンジンに標準で備わっている網掛け用のビットマップ名です。

記：網掛けパターンとしてビットマップ名を指定します。詳しくは 「ウィジェットの属性指定」−「ビットマップの埋め込み」 にて解説しているので参照してください。

記：網掛けを使うサンプルプログラムとして samplew\text-tag-complex.exe をご覧ください。

　なお、「網掛けを設定」単独で網掛けになるわけではないため注意が必要です。
　上記例のように併せて「背景色を設定」が必須です。「指定した背景色を使った網掛けパターン」により網掛けをおこなうことになります。
　（多くの場合背景色は白であるため網も白になり「網掛けを設定」しただけでは見えません）
       プログラム例：

■取り消し線
　取り消し線の属性をタグに与えます。
       プログラム例：

■ベースライン
　文字のベースライン（底辺）の位置を指定ピクセルだけ上に持ち上げます。
　サンプルプログラム "text-tag-complex.exe" のメニュー 「タグ操作」 − 「以下の試験の前に多くのタグを定義」 を選んだあと、「各種タグを使い分けてテキスト表示」を押すと、さまざまな文字修飾が現れますが、そのうち「ベースラインを変更しています」の表示部が適用例です。

■字下げ
　字下げ量をピクセル数で指定します。
　長い行は先頭行と、その先の折り畳み行とで区別して字下げが行われ、それぞれについて指定できます。同じで良いなら２つとも同じ値を指定してください。
　「字下げ」という言葉から文字単位のように感じてしまいますが、ピクセル単位なので注意が必要です。
　サンプルプログラム "text-tag-complex.exe" のメニュー 「タグ操作」 − 「以下の試験の前に多くのタグを定義」 を選んだあと、「タグを使い字下げをテスト」 を押すと字下げの効果を確認できます。

■右側余白
　長い行は折りたたんで表示されますが、そのときの右側余白を指定できます。デフォルトは余白無しです。

■テキスト揃え
　文字の揃え方については既に、「ウィジェットの属性指定」−「ウィジェット中の文字の揃え方」 にて解説しているので詳細はそちらを参照してください。

■行間
       プログラム例：
　行間を指定します。
　デフォルトの行間と異なる値にしたい場合に使います。
　テキストウィジェットに対して（全テキストに適用）だけでなくテキストタグに対しても適用できます。

■複数の属性の付与
　たとえば文字色とフォントを共に設定したい場合、次の２つの方法があります。 　上記いずれも可能です。Ａは冗長ではありますが、テキストからのタグの取り除きを独立しておこなえる利点があります。
　サンプルプログラム "text-tag-complex.exe" で次の操作をおこなうと、２つのタグを使うケースを確認できます。
　上記操作によると、まず（１）で２個所のテキストに色が付けられ、（２）で２個所目のフォントが大きくなります。２個所目については都合、２つのタグが使われることになります。最後に（３）でフォントタグのみ除去して文字の大きさを元に戻しています。



　作成したタグをテキスト（すべてまたは一部）に適用させるのに２通りの方法 があります。 　まずサンプルプログラム "text-tag-complex.exe" で次の操作をおこなってみてください。

　　　● 「タグ操作」 − 「タグを使い色を付ける」を実行し、
　　　　次いで 「タグを使いフォントを変更」 から始まる
　　　　４つの項目を順次実行してみてください

　　　　→この４種は、既に表示されたテキストに対して、後付け
　　　　　タグを適用する方法で色を付けています

　　　● 「タグ操作」 − 「以下の試験の前に多くのタグを定義」
　　　　から始まる５つの項目を順次実行してみてください

　　　　→この５種はあらかじめ設置したタグを付与しながら
　　　　　テキスト表示をおこなうものです

■タグを付けてのテキスト表示
       プログラム例：
　文法で示した単語群はそれぞれ、素の文字列表示であるところの 「テキスト表示」、 「一行テキスト表示」 、 「テキスト改行」 のタグ付与版です。
　タグを付与しながら表示するため、後からタグを取り外すことは向いていません。

■タグを付与
       プログラム例：
　指定するタグを既存のテキスト範囲（開始位置から終了位置）に付与します。位置は整数ではなく文字列なので注意が必要です（詳しくは 「文字位置列」 の項を参照してください）。
　終了位置は ”末尾文字の位置” ではないので注意してください。正確には、
　　　”末尾文字のその次の位置（=Next）” 　になります。

■タグを取り除く
       プログラム例：
　指定するタグを既存のテキスト範囲（開始位置から終了位置）から取り除きます。

■タグの削除
       プログラム例：
　指定するタグをテキストウィジェットの全領域から取り除き、その後タグ自体も抹消します。
　タグを削除した後は、変数に記憶していたタグＩＤはもはや無効になっているため使わないでください。

■タグ付与領域内での文字挿入
　既にタグを使った表示をおこなったテキスト領域の内部にキーボードから、あるいはプログラムから文字を挿入した時、その挿入文字にはその周辺にあるタグが自動的に付与されます。

■タグ付与領域より前での編集操作
　既にタグを使った表示をおこなったテキスト領域より前の部分で文字の挿入あるいは削除などを行って文字の増減があった時、その先でタグを付与していたテキスト領域は自動的にそのタグ位置が調整されタグ付与状況には影響を与えません。

■タグ付与領域でのコピー、ペースト
　タグ付与領域でのコピー、ペーストなどの操作をおこなっても、タグ情報はコピー、ペーストには含まれず、純粋に文字だけのコピー、ペーストになります。



　ポップアップメニューはテキストウィジェット専用というわけではなく、他にキャンバスウィジェットでも使われますが、このセクションではテキストウィジェットでの利用について解説します。
　まず、実際にどのように動作するかをサンプルプログラム "text-edit.exe" を操作して確認しておいてください。テキストボックス内で 右クリック すると ポップアップメニュー が出現します。
　ポップアップメニュー関係のソースコード記述は、同プログラムの副ソースファイルである "text-subsource-popupmenu.src" にほとんどが書かれています。ご覧になると分かりますが、プログラムの書き方は メニューバー でのそれと良く似ています。

■ポップアップメニューを準備
       プログラム例：
　ポップアップメニューを出すための準備をおこないます。メニューバーの時と違って有効化をおこなう必要はありません。
　引数として親ウィジェットを指示しますが、この親ウィジェットの中で右クリックしたときにポップアップが開くことになります。通常はテキストウィジェットのＩＤを与えます。

■ポップアップメニューに項目を追加
　既に、「メニューバー」 − 「メニュー項目の追加」 で解説したボタンや区切り線などのメニュー項目追加がそのまま使えます。以下では参考のためボタンの追加例を書きますが詳しくはそちらをお読み願います。
       プログラム例：
　追加されるボタンなどの項目はポップアップメニューの上から下に向かって並びます。
　ボタンの場合、押された時に起動すべき処理単語の実行情報をその引数と共に指定する仕様もまたメニューバーと同じです。

■ポップアップメニューのイベント処理
　メニュー項目としてのボタンが押された時のイベント発生などもメニューバーとまったく同じです。
       プログラム例：

• 
• 　　　　　　　　　　　　　　　　
• 　　

---