MATLAB Function Reference

Text Properties

ユーザは、つぎの2つの方法を使って、グラフィックオブジェクトのプロパティを設定したり、引用できます。

• Property Editor は、会話型のツー ルで、オブジェクトのプロパティ値を設定したり、変更したりできます。
• コマンドsetとget は、プロパティの値を設定したり、引用したりします。

プロパティのデフォルト値を変更するには、 デフォルトプロパテ ィ値の設定を参照してください。

Text Property 詳細s
この節では、プロパティ名とそれに設定できる値について説明します。中括弧{}は、デフォルト値です。

コールバックルーチンの割り込み。コールバックルーチンの割込み。BusyActionプロパティを使って、実行中のコールバックルーチンに割込みを行うイベントの取り扱い方法をコントロールすることができます。実行中のコールバックルーチンがあれば、続いて呼び込まれるコールバックルーチンは、常にそれを中断しようとします。コールバックを実行中のオブジェクトのInterruptibleプロパティがon(デフォルト)に設定されていれば、イベントキューが処理されるつぎの点で割込みが起こります。Interruptibleプロパティがoffならば、(実行中のコールバックをもつオブジェクトの)BusyActionプロパティは、MATLABがイベントを処理する方法を指定します。つぎのような選択があります。

• cancel - 2番目のコールバックルーチンを実行しようとするイベントをキャンセル
• queue - カレントのコールバックルーチンが終了するまで、2番目のコールバックルーチンの実行をさせるイベントを待機させる。

ボタンを押したときのコールバックルーチン。ポインタが Text オブジェクト上にあるときに、マウスボタンを押すと実行されるコールバックルーチン。このルーチンは、有効なMATLAB 表現、または、 M-ファイル名を文字列として定義してください。式はMATLAB ワークスペースで実行します。

空行列です。Text オブジェクトは、子オブジェクトをもちません。

クリッピングモード。 Clippingが onのとき、MATLAB は Axes の外側にあるText を表示しません。

テキストカラー。Text のカラーを指定する3 要素の RGB ベクトル、または、MATLAB の既定のカラーの名前。Colorのデフォルトの値は白です。カラーの指定の詳細は、リファレンスページのColorSpec を参照してください。

オブジェクト作成時に実行されるコールバックルーチン。このプロパティは、MATLAB が Text オブジェクトを作成するときに、実行するコールバックルーチンを定義します。このプロパティは、Text に対するデフォルト値として定義しなければなりません。たとえば、ステートメント

set(0,'DefaultTextCreateFcn',...
    'set(gcf,''Pointer'',''crosshair'')')

Text を削除するときのコールバックルーチン。Text オブジェクトを削除する(deleteの実行や、AxesやFigure を消去する)とき、実行するコールバックルーチン。MATLABは、オブジェクトのプロパティを壊す前に、このルーチンを実行するので、これらの値はコールバックルーチンに対して利用可能です。

編集モードの切り替え。このプロパティをデフォルトのoffに設定すると、対話的にテキスト文字列を編集できません(たとえば、String プロパティをテキストに変更しなければなりません)。このプロパティを onとすると、MATLAB は、テキスト文字列の始めに挿入カーソルを移動して、編集可能にします。新しいテキスト文字列を適用するためには、

• ESC キーを押します。
• 任意の Figure ウインドウ内をクリックします(カレント Figureを含む)。
• Editing プロパティをoffにします。

消去モード。 このプロパティは、Textオブジェクトの描画や消去のために MATLAB が使用する技法を制御します。消去モードは、連続的に動きを表現するアニメーションの作成に有効で、アニメーションの性能を改良したり希望する効果を得るためには、個々のオブジェクトを再描画する方法を制御する必要があります。

• normal -- すべてのオブジェクトが正しく再描画されることを保証するために必要な3次元解析を行い、表示範囲を描画します。このモードは、最も正確に図を表示することができますが、非常に時間のかかるものです。他のモードは、かなり時間の短縮にはなりますが、完全な図を再描画することはできず、精度は悪くなります。
• none -- -Textは、移動したり、壊されても消去されません。EraseMode noneを使って消去された後、オブジェクトがスクリーン上にまだ表示されていても、MATLAB は、この情報をもっていないので、プリント出力することはできません。
• xor -- Textの下側のスクリーンの各ピクセルのインデックスとの排他的論理和により表示されたり、消去されたりします。Textを消去したとき、Text の下のオブジェクトには影響を与えません。しかし、Textが、xor モードで書かれている場合は、そのカラーは、Textの下側のスクリーンのカラーに依存し、Axes のバックグランドColorのとき、または、 Figure のバックグランドのColor上でのみのみ正しく着色されます。
• background -- バックグランドColorで描画することや、または、AxesのColorがnoneで設定されている場合、FigureのバックグランドColorで、Text を消去します。これは、消去した Text の下のオブジェクトに影響を与えますが、Textは常に適切に着色されています。

Text の位置とサイズ。Text 文字列のサイズと位置を指定する4 要素の参照のみのベクトル

[left,bottom,width,height]

キャラクタの傾斜。 MATLABは、このプロパティを使ってユーザのシステムで使用可能なフォントの型を選択します。一般的に、このプロパティをitalics や oblique に設定すると、傾斜したフォントに設定されます。

フォントファミリ。Text オブジェクトに使うフォント名を指定する文字列。適切に表示したり印刷したりするためには、このプロパティはユーザのシステムがサポートするフォントでなければなりません。デフォルトのフォントは、MSP ゴシックです。

固定幅のフォントの指定

任意の位置に良く見えるように、固定幅のフォントを使いたい場合、FontNameを文字列FixedWidthに設定する必要があります。

set(text_handle,'FontName','FixedWidth')

このパラメータ値は、固定幅のフォントの名前をハードコードするために必要な処理をエルミネーションします。これは、ASCIIキャラクタコーディング(日本語)を使用しないシステム上で、適切にテキストを表示できません。固定幅のフォントを使用するために記述されたMATLABアプリケーションは、FontName を FixedWidthに設定し、エンドユーザの環境の中に正しく設定されたルートのFixedWidthFontNameプロパティを使います。

エンドユーザは、ルートのFixedWidthFontName プロパティをstartup.mに設定した適切な値に設定することにより、種々の部分や個人の環境に MATLABアプリケーションを採用できます。

ルートFixedWidthFontName プロパティを設定することは、新しいフォントを使用して表示したものをすぐに更新することになります。

フォントサイズ。Text に対して用いるフォントサイズを指定する整数で、FontUnitsプロパティで指定した単位で表わされます。デフォルトのサイズは、9 ポイントです(1 ポイント = ¹/72インチ)。

Text キャラクタの重み。MATLABは、このプロパティを使って、ユーザのシステムで使用可能なフォントの型を選択します。一般的に、このプロパティをbold や demi に設定すると、MATLAB は太字フォントを使います。

フォントのサイズの単位。MATLABは、このプロパティを使って、FontSizeプロパティで使う単位を決定します。Normalizedは、FontSizeを親オブジェクトの Axes の高さの分数として解釈します。Axesをリサイズするとき、MATLAB は、スクリーンの FontSize を修正します。pixels,inches, centimeters, points は、絶対単位です（1ポイント = ¹/72インチ）。

コマンドラインユーザとGUIによるオブジェクトのハンドルへのアクセスの制御。このプロパティは、オブジェクトのハンドルが、その子オブジェクトの親のリスト内で視覚可能であるときに指定します。HandleVisibilityプロパティは、(ダイアログボックスのような)ユーザインタフェースデバイスのみを含んでいるFigure内に、コマンドラインから誤って書き込むことや削除することを防ぐために有効です。

マウスクリックによる選択可能。 HitTest は、Text 上でマウスクリックの結果、Text がカレントのオブジェクト(gcoコマンドとFigureのCurrentObjectプロパティにより出力される)になり得るかどうかを指定します。HiTestがoffならば、Text 上をクリックすると、その下のオブジェクト(このオブジェクトを含むAxesかもしれません)を選択します。

function bd_function
pt = get(gca,'CurrentPoint');
text(pt(1,1),pt(1,2),pt(1,3),...
       '{\fontsize{20}\oplus} The spot to label',...
       'HitTest','off')

load earth
image(X,'ButtonDownFcn','bd_function'); colormap(map)

Text の水平方向の整列。このプロパティは、Text文字列の水平方向の位置を指定します。Position プロパティで指定した点に関して、文字列をどこに配置するかを決定します。 つぎの図は、整列に関するオプションを示すものです。

Tex のコマンドの解釈。 このプロパティは、MATLABが String プロパティのキャラクタを、LaTexのコマンドとして扱う（デフォルト）か、または、そのままのキャラクタとして表示するかを指定します。サポートしているTex のコマンドは String プロパティを参照してください。

コールバックルーチンの中断モード。Interruptibleプロパティは、Text のコールバックルーチンが、続いて呼び込まれるコールバックルーチンによって中断されるかどうかを制御します。Textオブジェクトは、コールバックルーチンを定義する ButtonDownFcn, CreateFcn, DeleteFcnのプロパティをもちます。MATLAB のコールバックルーチンの実行法は、Executionqueue プロパティを参照してください。

Text オブジェクトの親。 Text オブジェクトの親オブジェクトのハンドル番号。Textオブジェクトの親は、Text が表示される Axes です。このプロパティを新しい親オブジェクトのハンドル番号に設定することで、Textオブジェクトを他の Axes へ移動することができます。

Text の位置。2 要素、または、3 要素のベクトル[x y [z]] は、3 次元での Text の位置を指定します。zの値を省略すると、デフォルトで 0 になります。すべての位置は、Unitsプロパティで指定した単位で表されます。初期値は、[0 0 0]です。

Text の方向。このプロパティは、Text 文字列の方向を決定します。回転の角度を指定します（正の角度は反時計回りの方向になります）。

選択されたオブジェクト。このプロパティがon のとき、MATLAB は、 SelectionHighlight もon ならば、オブジェクトの選択状態を示すハンドルを表示します。たとえば、このプロパティを設定するために、ButtonDownFcnを定義すると、ユーザはマウスでオブジェクトを選択することができます。

選択時のオブジェクトの強調。Selectedプロパティが、on のときに、MATLAB は 4 辺と4 隅に選択状態を示すハンドルを描画します。SelectionHighlightが、 off のとき、MATLAB はハンドルを描画しません。

Text の文字列。 このプロパティは、コーテーション付き文字列、または、文字のセル配列、複数行の文字とした paddeed string として指定します。MATLABは、この文字列を指定した位置に表示します。|キャラクタは、Text文字列では、ラインブレークとは解釈されません。そして、Text文字列の一部として表示されます。より詳しくは、"注意事項：" を参照してください。

キャラクタ列	シンボル	キャラクタ列	シンボル	キャラクタ列	シンボル
\alpha		\upsilon		\sim	~
\beta		\phi		\leq
\gamma		\chi		\infty
\delta		\psi		\clubsuit
\epsilon		\omega		\diamondsuit
\zeta		\Gamma		\heartsuit
\eta		\Delta		\spadesuit
\theta		\Theta		\leftrightarrow
\vartheta		\Lambda		\leftarrow
\iota		\Xi		\uparrow
\kappa		\Pi		\rightarrow
\lambda		\Sigma		\downarrow
\mu	µ	\Upsilon		\circ	º
\nu		\Phi		\pm	±
\xi		\Psi		\geq
\pi		\Omega		\propto
\rho		\forall		\partial
\sigma		\exists		\bullet	•
\varsigma		\ni		\div	÷
\tau		\cong		\neq
\equiv		\approx		\aleph
\Im		\Re		\wp
\otimes		\oplus		\oslash
\cap		\cup		\supseteq
\supset		\subseteq		\subset
\int		\in		\o
\rfloor		\lceil		\nabla
\lfloor		\cdot	·	\ldots	...
\perp		\neg	¬	\prime	'
\wedge		\times	x	\0
\rceil		\surd		\mid	|
\vee		\varpi		\copyright	©
\langle		\rangle

• \bf - bold font
• \it - italics font
• \sl - oblique font (ほとんど使用しません)
• \rm - normal font
• \fontname{fontname} - 使用するフォント名を設定
• \fontsize{fontsize} - FontUnitsにフォントサイズを設定

ユーザ指定のオブジェクトのラベル。Tag プロパティはユーザ指定のラベルでグラフィックスオブジェクトを識別する方法を提供します。これはオブジェクトのハンドル番号をグローバル変数として定義したり、コールバックルーチン間で引数として渡すことを必要とする、対話的なグラフィックスプログラムを構築するときに、特に有効です。任意の文字列でTag を指定することができます。

グラフィックスオブジェクトのクラス。Text オブジェクトに対して、Type は常に文字列 'text'です。

測定の単位。このプロパティは、MATLABが、Extent と Position プロパティを解釈する単位を指定します。すべての単位は、Axes のプロットボックスの左下隅から測定されます。Normalizedは、Axes で定義した長方形の左下隅を (0,0) に写像し、右上隅を(1.0,1.0) に写像します。pixels, inches,centimeters, points は、絶対単位です（1ポイント = 1/72インチ)。data は親の Axes のデータ単位を参照します。

ユーザ指定のデータ。Text オブジェクトと関連付けたいデータです。MATLABは、このデータを使いませんが、set と get を使って、アクセスすることができます。

Textに関連したコンテキストメニュー。Textと同じFigure内に作成するUicontextmenuオブジェクトのハンドルにプロパティをアサインします。コンテキストメニューを作成するには、uicontextmenu関数を使います。Text上を右クリックすると、コンテキストメニューを表示します。

Text の垂直方向の整列。このプロパティは、Text文字列の垂直方向の位置を指定します。Position プロパティの値に関して、文字列をどこに配置するかを決定します。値は、つぎの通りです。

• top - 指定した y の位置の一番上に文字Extentを配置します。
• cap - 指定したyの位置で大文字の高さに配置します。
• middle - 指定した y の位置の中央に文字列を配置します。
• baseline - 指定した y の位置のフォントのベースラインに配置します。
• bottom - 指定した y の位置の下に文字Extentを配置します。

Text の可視性。デフォルトでは、すべてのText は視覚可能です。このプロパティを off に設定したとき、Textは見えなくなりますが、それでも存在していて、プロパティを設定することができます。

text

textread