バージョン: 20 R6

チェックボックス

チェックボックスはボタンの一種で、バイナリ (true-false) データの入力や表示をおこないます。基本的に、チェックボックスの状態は選択または未選択のいずれかになりますが、3つめの状態を定義することもできます。

チェックボックスは、メソッドまたは標準アクションを使って管理します。チェックボックスが選択されると、チェックボックスに割り当てられたメソッドが実行されます。他のボタンと同じように、フォームが初めて開かれると、チェックボックスの変数は 0 に初期化されます。

チェックボックスは小さな四角形の右側にテキストを表示します。このテキストはチェックボックスのタイトルプロパティで設定します。タイトルには、XLIFF参照を入れることもできます (付録 B: XLIFFアーキテクチャー参照)。

チェックボックスの使用

チェックボックスには整数型またはブール型の変数あるいは式を設定することができます。

整数型: チェックボックスが選択されると、変数の値は 1 になります。チェックボックスが選択されていない場合の値は 0 です。チェックボックスが 3番目の状態 (後述参照) のとき、変数値は 2 になります。
ブール型: チェックボックスが選択されると、変数の値は true になります。チェックボックスが選択されていない場合の値は False です。

フォーム上のすべてのチェックボックスは選択/未選択のいずれかの状態にすることができます。チェックボックスを複数使用することで、複数の候補を同時に選択できるようになります。

スリーステートチェックボックス

ボタンスタイルが通常およびフラットタイプのチェックボックスは 3番目の状態を受け入れます。この 3番目の状態は中間的な状態であり、一般的には表示のために用いられます。たとえば、選択されたオブジェクトが複数あるうち、一部のオブジェクトにのみ特定のプロパティが存在することを表すのに使用されます。

この 3番目の状態を有効にするにはスリーステートプロパティを選択します。

このプロパティは、数値型の変数あるいは式に関連付けられた通常およびフラットスタイルのチェックボックスに対してのみ使用できます。ブール型のチェックボックスはスリーステートプロパティを利用することができません (ブール式には中間状態が存在しません)。

チェックボックスが 3番目の状態になると、チェックボックスに関連付けられた変数は値2を返します。

スリーステートチェックボックスは入力モードにおいて、チェックなし / チェック / 中間状態 / チェックなし、という順に状態表示を切り替えます。一般的にこの中間状態は入力モードではあまり役に立たないため、2という値になった場合は、コード上で変数の値を強制的に 0 に設定し、チェックされた状態からチェックなしの状態へ直接移行します。

標準アクションの使用

チェックボックスに標準アクションを割り当てることで、テキストエリアの属性を管理することができます。たとえば、fontBold 標準アクションを選択すると、ランタイムにおいてそのチェックボックスは、カレントエリア内で選択されたテキストの "bold" 属性を管理します。

true/false ステータスで表すことのできるアクション ("checkable" アクション) のみがサポートされます:

サポートされるアクション	使用条件 (あれば)
avoidPageBreakInsideEnabled	4D Write Proエリアのみ
fontItalic
fontBold
fontLinethrough
fontSubscript	4D Write Proエリアのみ
fontSuperscript	4D Write Proエリアのみ
fontUnderline
font/showDialog	macOS のみ
htmlWYSIWIGEnabled	4D Write Proエリアのみ
section/differentFirstPage	4D Write Proエリアのみ
section/differentLeftRightPages	4D Write Proエリアのみ
spell/autoCorrectionEnabled
spell/autoDashSubstitutionsEnabled	macOS のみ
spell/autoLanguageEnabled	macOS のみ
spell/autoQuoteSubstitutionsEnabled	macOS のみ
spell/autoSubstitutionsEnabled
spell/enabled
spell/grammarEnabled	macOS のみ
spell/showDialog	macOS のみ
spell/visibleSubstitutions
visibleBackground	4D Write Proエリアのみ
visibleFooters	4D Write Proエリアのみ
visibleHeaders	4D Write Proエリアのみ
visibleHiddenChars	4D Write Proエリアのみ
visibleHorizontalRuler	4D Write Proエリアのみ
visiblePageFrames	4D Write Proエリアのみ
visibleReferences
widowAndOrphanControlEnabled	4D Write Proエリアのみ

これらのアクションについての詳細は、標準アクションの章を参照してください。

チェックボックスのボタンスタイル

チェックボックスのボタンスタイルは、チェックボックスの外観を制御すると同時に、提供されるプロパティをも決定します。チェックボックスには、あらかじめ定義されたスタイルを割り当てることができます。これらのプロパティや動作を組み合わせることで、多数のバリエーションが得られます。

スタイルによって提供されるプロパティは異なりますが、大多数のチェックボックスは 構造上 同じです。違いは、関連づけられた変数の処理にあります。

次の既定スタイルが提供されています:

通常

通常スタイルのチェックボックスは、標準的なシステムチェックボックス (四角形にタイトルが付いたもの) です。

JSON 例:

	"myCheckBox": {
		"type": "checkbox",	
		"style":"regular",
		"text": "Cancel",	
		"action": "Cancel", 	
		"left": 60,			
		"top": 160,		
		"width": 100,			
		"height": 20		
		"dataSourceTypeHint":"boolean"
		}

フラット

フラットスタイルのチェックボックスでは、装飾が最小限に抑えられています。このグラフィック的特性により、フラットスタイルは印刷フォームでの使用に適しています。

JSON 例:

	"myCheckBox": {
			"type": "checkbox",	
			"style":"flat",
			"text": "Cancel",	
			"action": "cancel", 
			"left": 60,		
 			"top": 160,	
 			"width": 100,			
			"height": 20			
			}

ツールバーボタン

チェックボックスのツールバーボタンスタイルは、主としてツールバーで使用するためのものです。

ツールバーボタンスタイルは、透明の背景にラベルが付いています。また、通常は 4つの状態を持つ画像が関連付けられます。

チェックなし / チェック / ハイライト状態の例です:

JSON 例:

	"myCheckBox": {
                "type": "checkbox",
                "style":"toolbar",	
                "text": "Checkbox",
				"icon": "/RESOURCES/File.png", 
				"iconFrames": 4 
                "left": 60,	
                "top": 160,	
                "width": 100,					
                "height": 20					
                }

ベベル

ベベルスタイルはデフォルトでは、通常ボタンのような外観に、チェックボックスのツールバーボタンスタイルの機能を組み合わせたものです。

ベベルスタイルは、明るいグレーの背景にラベルが付いています。また、通常は 4つの状態を持つ画像が関連付けられます。

チェックなし / チェック / ハイライト状態の例です:

JSON 例:

	"myCheckBox": {
                "type": "checkbox",	
                "style":"bevel",
                "text": "Checkbox",	 
 				"icon": "/RESOURCES/File.png", 
				"iconFrames": 4 
              	"left": 60,	
                "top": 160,	
                "width": 100,				
                "height": 20				
                }

角の丸いベベル

角の丸いベベルスタイルはベベルスタイルとほぼ同一ですが、OSによっては角が丸く表示されます。ベベルスタイルと同様に、角の丸いベベルスタイルは通常ボタンような外観に、チェックボックスのツールバーボタンスタイルの機能を組み合わせたものです。

角の丸いベベルスタイルは、明るいグレーの背景にラベルが付いています。また、通常は 4つの状態を持つ画像が関連付けられます。

macOS の例:

Windows 上では、角の丸いベベルスタイルはベベルスタイルと同じです。

JSON 例:

	"myCheckBox": {
                "type": "checkbox",	
                "style":"roundedBevel",	 
                "text": "Checkbox",	
 				"icon": "/RESOURCES/File.png", 
				"iconFrames": 4 
                "left": 60,	
                "top": 160,	
                "width": 100,			
                "height": 20			
                }

OS Xグラデーション

OS Xグラデーションスタイルはベベルスタイルとほぼ同一です。ベベルスタイルと同様に、OS Xグラデーションスタイルは通常ボタンような外観に、チェックボックスのツールバーボタンスタイルの機能を組み合わせたものです。

OS X グラデーションスタイルは明るいグレーの背景にラベルが付いています。macOS 上では2トーンのシステムボタンとして表示されることがあります。また、通常は 4つの状態を持つ画像が関連付けられます。

Windows 上では、このスタイルはベベルスタイルと同じです。

JSON 例:

	"myCheckBox": {
			"type": "checkbox",	
			"style":"gradientBevel", 
			"text": "Checkbox",	
			"icon": "/RESOURCES/File.png",
			"iconFrames": 4
			"left": 60,		
			"top": 160,		
			"width": 100,				
			"height": 20				
           }

OS Xテクスチャー

OS Xテクスチャースタイルはベベルスタイルと似ていますが、サイズがより小さいです (最大サイズは macOS の標準的なシステムボタンのサイズです)。ベベルスタイルと同様に、OS Xテクスチャースタイルは通常ボタンような外観に、チェックボックスのツールバーボタンスタイルの機能を組み合わせたものです。

デフォルトで、OS Xテクスチャースタイルの外観は次の通りです:

Windows - 明るいブルーの背景に中央配置のラベルが付いた標準のシステムボタンです。

macOS - 標準のシステムボタンです。高さは定義済みで、変更できません。

JSON 例:

	"myCheckBox": {
			"type": "checkbox",	
			"style":"texturedBevel", 
			"text": "Checkbox",	
			"left": 60,	
			"top": 160,	
			"width": 100,					
			"height": 20					
			}

Office XP

Office XPスタイルは通常ボタンような外観に、ツールバーボタンスタイルの動作を組み合わせたものです。

Office XP スタイルのチェックボックスの反転表示と背景のカラーはシステムカラーに基づいています。チェックボックスにマウスオーバーしたときの表示は OS によって異なります:

Windows - マウスオーバー時にのみ背景が表示されます。チェックなし / チェック / ハイライト状態の例です:

macOS - 背景は常に表示されます。チェックなし / チェック状態の例です:

JSON 例:

	"myCheckBox": {
                "type": "checkbox",	
                "style":"office",
                "text": "Checkbox",	 
                "action": "fontBold",
 				"icon": "/RESOURCES/File.png", 
				"iconFrames": 4 	
               "left": 60,	
                "top": 160,		
                "width": 100,			
                "height": 20			
                }

折りたたみ/展開

このチェックボックススタイルは標準の折りたたみ/展開アイコンを表示するのに使用します。これらは階層リストで使用されます。

Windows - [+] または [-] のように表示されます。

macOS - 右や下を指す三角として表示されます。

info

折りたたみ/展開スタイルは、ボタンスタイル JSON 文法では "disclosure" という名称です。

JSON 例:

	"myCheckBox": {
                "type": "checkbox",	
                "style":"disclosure",
				"method": "m_collapse",
				"left": 60,	
                "top": 160,	
                "width": 100,			
                "height": 20			
                }

開示ボタン

開示ボタンスタイルが適用されたチェックボックスは macOS および Windowsにおいて、詳細情報の表示/非表示にするのに使われる標準的な開示ボタンとして描画されます。値が 0 のときにはボタンの矢印が下向き、値が 1 のときは上向きになります。

Windows
macOS

info

開示ボタンスタイルは、ボタンスタイル JSON 文法では "roundedDisclosure" という名称です。

JSON 例:

	"myCheckBox": {
                "type": "checkbox",		
                "style":"roundedDisclosure",	
				"method": "m_disclose",
                "left": 60,		
                "top": 160,	
                "width": 100,			
                "height": 20			
                }

カスタム

カスタムスタイルのチェックボックスは、背景ピクチャーを使用できるほか、さまざまな追加パラメーターを管理することができます:

カスタムチェックボックスには通常、4つの状態を持つ画像が関連付けられ、これは同じく4つの状態を持つ背景ピクチャーと同時に使用することができます。

JSON 例:

	"myCheckbox": {
		"type": "checkbox",
		"style":"custom",
		"text": "OK", 
		"icon": "/RESOURCES/smiley.jpg", 
		"iconFrame": 4, 
		"customBackgroundPicture": "/RESOURCES/paper.jpg", 
		"iconOffset": 5, //custom icon offset when clicked
		"left": 60,	
		"top": 160,	
		"width": 100,		
		"height": 20,
		"customBorderX": 20,
		"customBorderY": 5
		}

プロパティ一覧

すべてのチェックボックスは次の基本プロパティを共有します:

タイプ - オブジェクト名 - 変数あるいは式 - 式の型 - タイトル - 値を記憶 - CSSクラス - ボタンスタイル - ピクチャーパス名(2) - 状態の数(2) - タイトル/ピクチャー位置(2) - タイトルと画像を隣接させる(2) - 左 - 上 - 右 - 下 - 幅 - 高さ - 横方向サイズ変更 - 縦方向サイズ変更 - 入力可 - フォーカス可 - ショートカット - 表示状態 - フォント - フォントサイズ - 太字 - イタリック - 下線 - フォントカラー - 横揃え(1) - ヘルプTips - 標準アクション

(1) 通常およびフラットスタイルではサポートされていません。
(2) 通常、フラット、開示ボタンおよび折りたたみ/展開スタイルではサポートされていません。

ボタンスタイルに応じて、次の追加プロパティが使用できます:

カスタム: 背景パス名 - アイコンオフセット - 横方向マージン - 縦方向マージン
通常、フラット: スリーステート

チェックボックスの使用​

スリーステートチェックボックス​

標準アクションの使用​

チェックボックスのボタンスタイル​

通常​

JSON 例:​

フラット​

JSON 例:​

ツールバーボタン​

JSON 例:​

ベベル​

JSON 例:​

角の丸いベベル​

JSON 例:​

OS Xグラデーション​

JSON 例:​

OS Xテクスチャー​

JSON 例:​

Office XP​

JSON 例:​

折りたたみ/展開​

JSON 例:​

開示ボタン​

JSON 例:​

カスタム​

JSON 例:​

プロパティ一覧​

チェックボックスの使用

スリーステートチェックボックス

標準アクションの使用

チェックボックスのボタンスタイル

通常

JSON 例:

フラット

JSON 例:

ツールバーボタン

JSON 例:

ベベル

JSON 例:

角の丸いベベル

JSON 例:

OS Xグラデーション

JSON 例:

OS Xテクスチャー

JSON 例:

Office XP

JSON 例:

折りたたみ/展開

JSON 例:

開示ボタン

JSON 例:

カスタム

JSON 例:

プロパティ一覧