テキスト、ピクチャー
背景パス名
オブジェクトの背景として使用するピクチャーのパスを指定します。 複数の状態 を持つ アイコン を持つオブジェクトの場合、背景ピクチャーにも同じ状態の数が適用されます。
パス名は、スタティックピクチャーのパス名プロパティ と同じように指定します。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| customBackgroundPicture | string | POSIX シンタックスの相対パス。 style プロパティの "custom" オプションと併用する必要があります。 |
対象オブジェクト
カスタムボタン - カスタムチェックボックス - カスタムラジオボタン
ボタンスタイル
ボタンの外観を設定します。 スタイルによっては、特定のオプションが利用できなくなることもあります。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| style | text | "regular", "flat", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom" |
対象オブジェクト
横方向マージン
ボタン内側の横方向のマージンサイズ (ピクセル単位) を指定します。 マージンにより、ボタンアイコンとタイトルの領域を制限します。
背景ピクチャーに境界が含まれるような場合に、このパラメーターを利用します:
| マージン指定 | 例題 |
|---|---|
| マージンなし |  |
| 13 ピクセルのマージン |  |
このプロパティは 縦方向マージン プロパティとの組み合わせで機能します。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| customBorderX | number | "カスタム" スタイルで利用可。 最小値: 0 |
対象オブジェクト
カスタムボタン - カスタムチェックボックス - カスタムラジオボタン
アイコンの場所
フォームオブジェクトに対するアイコンの配置を指定します。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| iconPlacement | string | "none", "left", "right" |
対象オブジェクト
[リストボックスヘッダー](listbox_overview.md#リストボックスヘッダー)
アイコンオフセット
ボタンクリック時のオフセット値をピクセル単位で指定します。
このプロパティを使用すると、指定したピクセル数だけボタンタイトルが右下へシフトされます。 この機能により、ボタンのクリック時に独自の3D 効果を適用することができます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| customOffset | number | 最小値: 0 |
対象オブジェクト
カスタムボタン - カスタムチェックボックス - カスタムラジオボタン
状態の数
このプロパティは ボタン、チェックボックス、ラジオボタン のアイコンとして使用されるピクチャーに含まれる状態の数を指定します。 一般的にボタンアイコンは 4つの状態 (アクティブ、クリック、ロールオーバー、無効) を含んでいます。
一つの状態につき、一つの画像を割り当てます。 ソースピクチャーでは、状態を表すアイコンは縦に並んでいなければなりません:
状態は次の順番で割り当てられます:
- ボタン未クリック / チェックボックス未選択 (変数値=0)
- ボタンクリック / チェックボックス選択 (変数値=1)
- ロールオーバー
- disabled
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| iconFrames | number | 最小値: 1 |
対象オブジェクト
ボタン (ヘルプボタンを除く) - チェックボックス - ラジオボタン
ピクチャーパス名
オブジェクトのアイコンに使用するピクチャーのパスを指定します。
パス名は、スタティックピクチャーのパス名プロパティ と同じように指定します。
アクティブオブジェクトのアイコンとして使う場合、状態の数 変数に対応するよう、デザインされている必要があります。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| icon | picture | POSIX シンタックスの相対パス、またはファイルシステムパス |
対象オブジェクト
ボタン (ヘルプボタンを除く) - チェックボックス - リストボックスヘッダー - ラジオボタン
タイトル/ピクチャー位置
このプロパティはアイコンに対するボタンタイトルの相対的な位置を指定します。 ボタン内に、タイトルのみ (関連ピクチャーなし)、またはピクチャーのみ (タイトルなし) が含まれている場合、このプロパティは効果ありません。 デフォルトでは、ピクチャーの下部にタイトルが置かれます。
このプロパティの各種オプションの結果を次に示します:
| オプション | 説明 | 例題 |
|---|---|---|
| 左 | テキストはアイコンの左に置かれます。 ボタンの内容は右揃えされます。 |  |
| 上 | テキストはアイコンの上に置かれます。 ボタンの内容は中央揃えされます。 |  |
| 右 | テキストはアイコンの右に置かれます。 ボタンの内容は左揃えされます。 |  |
| 下 | テキストはアイコンの下に置かれます。 ボタンの内容は中央揃えされます。 |  |
| 中央 | アイコンのテキストはボタン内で縦と横に中央揃えされます。 テキストをアイコンの中に組み込むような場合に利用します。 |  |
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| textPlacement | string | "left", "top", "right", "bottom", "center" |
対象オブジェクト
ボタン (ヘルプボタンを除く) - チェックボックス - ラジオボタン
縦方向マージン
ボタン内側の縦方向のマージンサイズ (ピクセル単位) を指定します。 マージンにより、ボタンアイコンとタイトルの領域を制限します。
背景ピクチャーに境界が含まれるような場合に、このパラメーターを利用します。
このプロパティは 横方向マージン プロパティとの組み合わせで機能します。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| customBorderY | number | "カスタム" スタイルで利用可。 最小値: 0 |
対象オブジェクト
カスタムボタン - カスタムチェックボックス - カスタムラジオボタン
ポップアップメニューあり
このプロパティを使用すると、ボタン内に逆三角形として表われるシンボルを表示することができます。このシンボルは、ポップアップメニューが付属することを示します:
このシンボルの外観と位置は、ボタンスタイルとプラットフォームによって変わります。
リンクと分離
ポップアップメニューシンボルをボタンに付加する際に、リンクと分離という2つのオプションから選択することができます:
| リンク | 分離 |
|---|---|
 |  |
実際に "分離" モードを利用できるかどうかは、ボタンスタイルとプラットフォームによって決まります。
それぞれのオプションにより、ボタンとポップアップメニューとの関係が指定されます:
ポップアップメニューの管理
"ポップアップメニューあり" プロパティは、ボタンのグラフィック面だけを管理するという点に注意が必要です。 ポップアップメニューとその値の表示は、すべて開発者が処理しなくてはなりません。具体的にはフォームイベントや Dynamic pop up menu、Pop up menu コマンドを使用してこれを処理します。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| popupPlacement | string |
対象オブジェクト
ツールバーボタン - ベベルボタン - 角の丸いべべルボタン - OS X グラデーションボタン - OS X テクスチャーボタン - Office XP ボタン - サークルボタン - カスタムボタン