【ExtendScript】GUI : statictext（固定テキスト）

2019-01-092020-09-29

当ページのリンクには広告が含まれています。

Adobe JavaScript Reference GUI編：固定テキスト文字を表示

statictext（固定テキスト）は、GUI画面にテキストを表示します。

スクリプト実行時に変更することはできないオブジェクトなので、見出し部分などに使います。

statictextは、ウインドウまたはコンテナの各種オブジェクトの中に作成します。

種類

statictextコントロール
クラス名：StaticText

機能

ユーザーが変更することのできないテキストフィールド。

構文

■ウインドウwに、固定文字の領域を追加する。

w.add ("statictext" [, bounds, text, {creation_properties}]);

bounds

オプション。コントロールの位置とサイズ。

text

オプション。コントロールに表示されるテキストの初期値。

creation_properties

オプション。 statictext作成時のプロパティ。

name: ユニークな名前
multiline: falseのとき、1行分のテキストを表示。（デフォルト）
trueのとき、複数の行を表示し、テキストはコントロール幅で折り返される。
scrolling: falseの場合、垂直スクロールバーを表示しない。（デフォルト）
trueのとき、垂直スクロールバーを表示。
truncate: 文字がスペースに収まらないときの文字の省略記号の出し方。
noneのとき、収まらない文字は削除され省略記号の表示もされない。
middleのとき、文字の中ほどに「…」を表示する。
endのとき、文末に「…」を表示する。
middle、endは、”middle”、”end”のように” ” で囲む。

statictextのプロパティ

active: フォーカス
alignment: 揃え方向
bounds: 位置やサイズ
children: 子要素
enabled: 有効化・無効化
graphics: 外観をカスタマイズするグラフィック
helpTip: マウスを重ねたときに表示する簡単なヘルプ。ツールチップ
justify: テキストの位置揃え
location: 位置
maximumSize: 最大の高さと幅
minimumSize: 最小の高さと幅
parent: 直接の親
preferredSize: 最適サイズ
properties: statictextが作成されるときのプロパティ
shortcutKey: ショートカットキー（Windowsのみ）
size: サイズ
text: ボックス内のテキスト
type: 作成時の型名（statictext）
visible: 表示・非表示
window: statictextを含むWindowオブジェクト
windowBounds: ウインドウ座標内のBounds

statictextのメソッド

addEventListener: イベントリスナーを登録する
dispatchEvent: イベントの発生をシミュレートする
hide: 非表示にする
notify: イベントをシミュレートする
removeEventListener: イベントリスナーの登録を解除する
show: 表示する

statictextのイベント

onActivate: コントロールにフォーカスが与えられたときに呼び出される
onClick: コントロールをクリックしたときに呼び出される
onDeactivate: コントロールからフォーカスが他へ移動したときに呼び出される
onDraw: コンテナまたはコントロールが描画されようとしているときに呼び出される
onShortcutKey: ショートカットキーシーケンスが入力されたときに呼び出される。Windowsのみ

サンプルコードと実行結果1

■オプション指定なし。

var w = new Window("window", "statictextのサンプル", [0,0,300,100]);

var c01 = w.add("statictext", [30,30,280,70], "テキスト表示のフィールドです。");

w.center();
w.show();

サンプルコードと実行結果2

■複数行をスクロールできる形式で表示する。

var w = new Window("window", "statictextのサンプル", [0,0,300,100]);

var c01 = w.add("statictext", [30,30,280,70], 
        "テキスト表示のフィールド　1行目です。\r\n"+
        "テキスト表示のフィールド　2行目です。\r\n"+
        "テキスト表示のフィールド　3行目です。\r\n"+
        "テキスト表示のフィールド　4行目です。", 
        {multiline:true, scrolling:true});

w.center();
w.show();