# label_properties

Labelエンティティプロパティの説明

## 説明

Labelエンティティは`Axes`エンティティの子です. Axesエンティティが構築された時, TitleおよびLabelsのハンドルはAxesプロパティの一部として組み込まれます. このため、これらのサブオブジェクトのプロパティはAxesハンドル経由で編集可能です (`gca` および `gda`参照). Labelエンティティを直接削除することはできないことにも注意してください. このエンティティは描画するラベルに関する以下のパラメータを定義します:

parent:

  このエンティティは親のハンドルを有します. labelエンティティの親は`"Axes"`型です.

  現時点でLabelエンティティは `title`, `x_label`, `y_label` および `z_label` を構築する際に排他的に使用されていることに 注意してください.

visible:

  このフィールドはエンティティの`visible`プロパティを有します. この値は`"on"` または `"off"`です. デフォルトでラベルは可視であり,このプロパティの値は`"on"`です. `"off"`の場合,ラベルは画面に表示されません.

text:

  オブジェクトの文字列を有する行列.行列の行は水平に表示され,列は垂直に表示されます.

  Scilab 5.2以降, LaTeX または MathML 式を書くことが可能です.

font_foreground:

  このフィールドはラベル`text`を表示する際に使用される色を 有します.色のインデックスは(カレントのカラーマップに基づく)色インデックス である必要があります.

foreground:

  このフィールドはボックスの周りに線を表示する際に使用される色を 有します.この値は(カレントのカラーマップに基づく)色インデックス である必要があります.

background:

  このフィールドはボックスを塗る際に使用される色を 有します.この値は(カレントのカラーマップに基づく)色インデックス である必要があります.

fill_mode:

  このフィールドは`"on"`または `"off"`を値とします. `"on"` の場合, テキストの周囲に縁に線があるボックスと 背景が描画されます.

font_style:

  ラベルの表示に使用されるフォントを指定します. これはロード済みのフォントの一つを指す正の整数です. その値は最初のフォントを指す 0 から最後のフォントを指すロード済みの フォントの数から1を引いた数までとします. 詳細についてはgraphics_fontsを参照ください.

font_size:

  表示される文字の大きさを指定するスカラー値です. `fractional_font`プロファイルが `"off"`の場合, 値の整数部のみが使用されます. 詳細についてはgraphics_fontsを参照ください.

fractional_font:

  このプロパティはテキストを分数のフォントサイズにより表示するかどうかを 指定します.この値には,`"on"` または `"off"`を指定します. `"on"` の場合,`font_size`の浮動小数点の値が 表示の際に使用され,フォントはアンチエイリアス処理されます. `"off"` の場合,整数部のみが使用され,フォントは平滑化されません.

font_angle:

  このスカラー値によりラベルを回転させることができます. フォントは度を単位として指定した角度で時計回りに回転されます. `font_angle`を変更すると `auto_rotation`プロパティが自動的に無効となる ことに注意してください.

auto_rotation:

  `"on"`の場合, Scilab は表示の際に 最良のラベル回転角を自動的に計算します. `"off"`の場合, ラベルは`font_angle` プロパティにより マニュアルで回転できます.

position:

  この2次元ベクトルにより画面上にラベルをマニュアルで配置できます. 位置は軸のデータユニットに保存されます. `font_angle`を変更すると `auto_position`プロパティが自動的に無効となる ことに注意してください.

auto_position:

  `"on"`の場合, Scilab は 表示の際にグラフィックウインドウにおける最良の位置を自動的に計算します. `"off"`の場合,`position`プロパティにより マニュアルで配置可能です.

## 例

    a=get("current_axes");
    a.title
    type(a.title)
    plot3d()
    a.x_label
    a.y_label
    a.z_label
    xtitle("My title","my x axis label", "Volume","Month")

    t=a.title;
    t.foreground=9;
    t.font_size=4;
    t.font_style=5;
    t.text="SCILAB";

    x_label=a.x_label;
    x_label.text=" Weight"
    x_label.font_style= 5;
    a.y_label.foreground = 12;

    // Scilab 5.2以降, LaTeX または MathML式を書くことができます:
    t.text="$\sqrt{SCILAB}$";
    x_label.font_size= 5;
    x_label.text="<mrow><mfrac><mrow><mn>1</mn></mrow><mrow><mn>2</mn></mrow></mfrac><mo></mo><mfenced open=""{"" close=""}""> ..
    <mrow><mfrac><mrow><mfrac><mrow><mi>a</mi></mrow><mrow><mi>b</mi></mrow></mfrac></mrow><mrow><mfrac><mrow><mi>c</mi></mrow><mrow><mi>d</mi></mrow>..
    </mfrac></mrow></mfrac></mrow></mfenced></mrow>"

## 参照

- set
- get
- delete
- xtitle
- graphics_entities
- axes_properties
- text_properties