チェックボックス (PRIM_MD.CheckBox)

チェックボックスは通常ブール値選択に使用されます

祖先 - コントロール (PRIM_MD.Control) コントロール (PRIM_CTRL) オブジェクト (PRIM_OBJT)

詳細

チェックボックスは、通常バイナリ選択 (Yes または No など)  を示すために使用されます。
 
通常、チェックマークを入れると肯定になり、否定の場合にはチェックを外します。
 
チェックボックスには、3 つ目の不定の Checkstate もあり、これを利用して、結果が競合する複数の答えを表すことができます。
 
以前の Windows のチェックボックスとは違い、このチェックボックス自体がフォントのサイズ変更に合わせてサイズ調整されます。

例

以下の例では、2 つの小さいチェックボックスのいずれかの変更をベースに、一番大きなチェックボックスの Checkstate が 評価されます。

Begin_Com Role(*EXTENDS #PRIM_WEB) Theme(#SYS_THEME) Height(592) Width(881)
 
   Define_Com Class(#PRIM_MD.CheckBox) Name(#CheckBox) Caption('Checked') DisplayPosition(1) Height(41) IconHeight(0) Left(24) Parent(#COM_OWNER) TabPosition(1) ThemeDrawStyle('Heading1') Top(24) Width(241) Enabled(False)
   Define_Com Class(#PRIM_MD.CheckBox) Name(#CheckBox1) Caption('Check Box 1') DisplayPosition(2) IconColor(Theme500) Left(24) Parent(#COM_OWNER) TabPosition(2) Top(80) Width(145) Height(33)
   Define_Com Class(#PRIM_MD.CheckBox) Name(#CheckBox2) Caption('Check Box 2') DisplayPosition(3) IconColor(ThemeAccentMedium) Left(24) Parent(#COM_OWNER) TabPosition(3) Top(136) Width(129)
 
   Evtroutine Handling(#CheckBox1.Changed #CheckBox2.Changed)
 
      If (#CheckBox1.CheckState = #CheckBox2.CheckState)
 
         #CheckBox.CheckState := #CheckBox1.CheckState
 
      Else
 
         #CheckBox.CheckState := Grayed
 
      Endif
 
   Endroutine
 
End_Com

プロパティ

名前記述
BusyUpdatesBusyUpdatesはコントロールがそれ自身をどのようにしてアップデートするかを指定します。 コントロール (PRIM_CTRL) より継承
BusyUpdatesOfParentBusyUpdatesOfParentは親のコントロールが更新するかどうかを指定します。 コントロール (PRIM_CTRL) より継承
CanFocusCanFocusはコントロールがキーボードフォーカスを受け取れるかどうかを示す値を返します。 コントロール (PRIM_CTRL) より継承
Captionポップアップ内に表示されるテキスト
CaptionAlignmentコントロール内のキャプション配置
CaptionMarginBottom下の余白(ピクセル)
CaptionMarginLeft左の余白(ピクセル)
CaptionMarginRight右の余白(ピクセル)
CaptionMarginTop上の余白(ピクセル)
CheckStateチェックボックスがチェックされているかどうかを示します
ComponentClassNameコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
ComponentMembersこのコンポーネントの全てにアクセスできるようにします。 オブジェクト (PRIM_OBJT) より継承
ComponentPatternNameコンポーネントのクラスを制限します。 オブジェクト (PRIM_OBJT) より継承
ComponentTagインスタンス用に値を格納できる汎用スペース オブジェクト (PRIM_OBJT) より継承
ComponentTypeComponentTypeではコンポーネントのタイプ情報にアクセスできます。 オブジェクト (PRIM_OBJT) より継承
ComponentTypeNameComponentTypeName十分適格なコンポーネントのクラス名です。 オブジェクト (PRIM_OBJT) より継承
CursorCursorのイメージを指定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
DisplayPositionDisplayPositionに表示の位置を指定します。 コントロール (PRIM_CTRL) より継承
DragStyleDragStyleはどのようにコンポーネントがドラッグされるかを決めます。 コントロール (PRIM_CTRL) より継承
Ellipses切り詰められたテキストに省略記号を表示
EnabledEnabledはコンポーネントを使用可能/使用不可にするためのプロパティです。 コントロール (PRIM_CTRL) より継承
FixedPosition親がスクールされても移動しないよう、コントロールを固定します コントロール (PRIM_CTRL) より継承
FocusFocusはコンポーネントにフォーカスがあるかどうかを判断するためのプロパティです。 コントロール (PRIM_CTRL) より継承
FocusedStyleコントロールにフォーカスがある時に適用するスタイルへの参照 コントロール (PRIM_CTRL) より継承
FocusedStylesコントロールにフォーカスがある時に適用するスタイルのコレクション コントロール (PRIM_CTRL) より継承
Handleデスクトップアプリケーション内のWindowsハンドルを返します コントロール (PRIM_CTRL) より継承
HeightHeightコンポーネントの高さを設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintHintはコンポーネントの記述を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintPopupHintPopupは省略値のポップアップテキストの代わりにポップアップパネル(#prim_ppnl)インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
HintShowHintShowはヒントを表示するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintShowOfParentHintShowOfParentはコンテナのHintShowプロパティを参照するためのプロパティです。 コントロール (PRIM_CTRL) より継承
HintTitleHintTitleヒントウィンドウの上部に強調文字で表示されるテキストを指定します。 コントロール (PRIM_CTRL) より継承
IconAlignmentコントロール内のアイコン配置
IconColorアイコンに適用する色
IconHeightアイコンの高さ(ピクセル)
IconMarginBottom下の余白(ピクセル)
IconMarginLeft左の余白(ピクセル)
IconMarginRight右の余白(ピクセル)
IconMarginTop下の余白(ピクセル)
IsAnimatingIsAnimatingは現在コントロールがアニメーションで表示されていることを示します。 コントロール (PRIM_CTRL) より継承
IsRealizedデザインインスタンスが実施されるとTRUEになります。 コントロール (PRIM_CTRL) より継承
LeftLeftはコンポーネントの左側の位置を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
ModifiedModifiedはコントロールの内容が変更されていることを知らすためのプロパティです。 コントロール (PRIM_CTRL) より継承
MouseOverMouseOverマウスがコントロールの真上にあるかどうかを決定します。 コントロール (PRIM_CTRL) より継承
MouseOverStyleMouseOverStyleマウスが真上にある時にコントロールに適用するスタイル(#Prim_vs.Style)を定義します。 コントロール (PRIM_CTRL) より継承
MouseOverStylesMouseOverStylesマウスが真上にある時にコントロールに適用するスタイル集(#Prim_vs.Style)です。 コントロール (PRIM_CTRL) より継承
Nameコンポーネントの名前 オブジェクト (PRIM_OBJT) より継承
OpacityOpacityはコントロールと背景の表示関係を表します。 コントロール (PRIM_CTRL) より継承
Ownerコンポーネントのオーナーです。 オブジェクト (PRIM_OBJT) より継承
PaddingBottom下のパディング(ピクセル)
PaddingLeft左のパディング(ピクセル)
PaddingRight右のパディング(ピクセル)
PaddingTop上のパディング(ピクセル)
Parentこのコントロールがビジュアル的に位置しているコントロールへの参照 コントロール (PRIM_CTRL) より継承
PopupPopupは通常の右クリックのポップアップメニューの代わりにポップアップパネル(#prim_ppnl)インスタンスが利用できるようにします。 コントロール (PRIM_CTRL) より継承
PopupMenu右クリックで表示されるポップアップメニューへの参照 コントロール (PRIM_CTRL) より継承
RotationRotationは指定の原点の周りをコントロールが回転できるようにします。 コントロール (PRIM_CTRL) より継承
RotationOriginLeftRotationOriginLeftはコントロールがその周りを回転する想定地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
RotationOriginTopRotationOriginTopはコントロールがその周りを回転する想定地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleHeightScaleHeightはコントロールのビジュアル表示で使用する高さをパーセントで示します。 コントロール (PRIM_CTRL) より継承
ScaleOriginLeftScaleOriginLeftはコントロールのサイズ調整時の想定開始地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleOriginTopScaleOriginTopはコントロールのサイズ調整時の想定開始地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
ScaleWidthScaleWidthはコントロールのビジュアル表示で使用する幅をパーセントで示します。 コントロール (PRIM_CTRL) より継承
ScreenLeftScreenLeftはスクリーンの左側からの距離を設定します。 コントロール (PRIM_CTRL) より継承
ScreenTopScreenTopはスクリーンの上部からの距離を設定します。 コントロール (PRIM_CTRL) より継承
ScrollLeftスクロールされた子コントロールの(親コントロールに対して)左の位置 コントロール (PRIM_CTRL) より継承
ScrollTopスクロールされた子コントロールの(親コントロールに対して)上の位置 コントロール (PRIM_CTRL) より継承
SkewLeftSkewLeftはコントロールを水平方向に傾ける角度を定義します。 コントロール (PRIM_CTRL) より継承
SkewOriginLeftSkewOriginLeftはコントロール傾斜時の想定開始地点の左座標を指定します。 コントロール (PRIM_CTRL) より継承
SkewOriginTopSkewOriginTopはコントロール傾斜時の想定開始地点の上座標を指定します。 コントロール (PRIM_CTRL) より継承
SkewTopSkewTopはコントロールを垂直方向に傾ける角度を定義します。 コントロール (PRIM_CTRL) より継承
StyleStyleはコントロールに適用するスタイル(#Prim_vs.Style)を定義します。 コントロール (PRIM_CTRL) より継承
Stylesコントロールに適用するスタイルのコレクション コントロール (PRIM_CTRL) より継承
TabPositionTabPositionはフォーカスの順番を指定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
TabStopTabStopはTabキーによってフォーカスをもつことを設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
ThemeBackground使用する背景テーマ コントロール (PRIM_MD.Control) より継承
ThemeDrawStyleコントロールに適用するテーマの描画スタイルの名前 コントロール (PRIM_CTRL) より継承
TopTopはコンポーネントの上側の位置を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
TouchMoveタッチ移動処理にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchRotateタッチ回転にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchScaleタッチサイズ変更にコントロールがどう対応するかを決定します。 コントロール (PRIM_CTRL) より継承
TouchSizeコントロールをサイズ調整可能にするかどうかを決定します。 コントロール (PRIM_CTRL) より継承
VisibleVisibleはコンポーネントを表示/非表示するためのプロパティです。 コントロール (PRIM_CTRL) より継承
VisualStyleVisualStyleはコンポーネントの表示構成を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
VisualStyleOfParentVisualStyleOfParentはコンテナのVisualStyleプロパティを参照するためのプロパティです。 コントロール (PRIM_CTRL) より継承
WebAriaこの Web ページのコンポーネントのアクセシビリティ記述として利用される Aria 属性を上書きする内容の詳細を示すコンポーネント インスタンスへの参照 コントロール (PRIM_CTRL) より継承
WidthWidthはコンポーネントの幅を設定するためのプロパティです。 コントロール (PRIM_CTRL) より継承
WordWrap十分なスペースがない場合、テキストを次の行に折り返します。

イベント

名前記述
AnimationEndedアニメーション終了時に起動します チェックボックス (PRIM_MD.CheckBox) より継承
Cancelled
Changed値が変更されると起動します
CreateInstanceコンポーネントを作成する時にCreateInstanceのイベントを実行します。 チェックボックス (PRIM_MD.CheckBox) より継承
DestroyInstanceコンポーネントが解除される前にDestroyInstanceのイベントを実行します。 チェックボックス (PRIM_MD.CheckBox) より継承
DragDropDragDropイベントはコンポーネントがドロップされる時に実行されます。 チェックボックス (PRIM_MD.CheckBox) より継承
PosX, PosY, Source, Payload, AggregatedSource, Origin, Handled, DragResult
DragOverカーソルがコントロールの上を移動するドラッグアンドドロップ処理中に起動されます。 チェックボックス (PRIM_MD.CheckBox) より継承
PosX, PosY, Source, Payload, DragState, AcceptDrop, DragCursor, ShowDropHilight, AggregatedSource, Origin, Handled
EndDragEndDragはドラッグアンドドロップが完了した時に実行されます。 チェックボックス (PRIM_MD.CheckBox) より継承
Source, Payload, DragResult, AggregatedSource, Origin, Handled
GotFocusコントロールがフォーカスを受け取ると起動します
InitializeInitializeはコンポーネントをロードする時に実行されます。 チェックボックス (PRIM_MD.CheckBox) より継承
LostFocusコントロールがフォーカスを失うと起動します
MouseEnterコントロールの境界内にマウスが入りました。 チェックボックス (PRIM_MD.CheckBox) より継承
MouseHoverマウスがコントロール上でホバリングしました。 チェックボックス (PRIM_MD.CheckBox) より継承
Origin, Handled
MouseLeaveマウスがコントロールの境界から出ました。 チェックボックス (PRIM_MD.CheckBox) より継承
StartDragStartDragはマウスをドラッグした時に実行されます。 チェックボックス (PRIM_MD.CheckBox) より継承
Source, Payload, Continue, DragList, AggregatedSource, Origin, Handled
TouchChangeTouchStartとTouchEndの境界で繰り返し起動され、タッチイベントの詳細を提供します。 チェックボックス (PRIM_MD.CheckBox) より継承
MoveLeft, MoveTop, ScaleWidth, ScaleHeight, Rotation, Continue
TouchEndユーザーのタッチが終了した時に起動します。 チェックボックス (PRIM_MD.CheckBox) より継承
TouchStartユーザーにより画面に物理的な接触が最初に行われた時に起動します。 チェックボックス (PRIM_MD.CheckBox) より継承
Origin, TouchMove, TouchRotate, TouchScale, TouchSize

メソッド

名前記述
FadeIn非表示から表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay
FadeOut表示から非表示へのアニメーション コントロール (PRIM_CTRL) より継承
Duration, Delay, Visible
MoveFromコントロールを指定位置から現在の位置に移動 コントロール (PRIM_CTRL) より継承
Left, Top, Duration, Delay
MoveTo指定されたピクセル数の移動をアニメーション化 コントロール (PRIM_CTRL) より継承
Left, Top, Duration, Delay
RealizeRealizeは動的にコンポーネントを作成するためのメソッドです。 コントロール (PRIM_CTRL) より継承
Scaleサイズの変化をアニメーション化 コントロール (PRIM_CTRL) より継承
ScaleWidth, ScaleHeight, Duration, Delay
SetFocusSetFocusはコンポーネントにフォーカスをするためのメソッドです。 コントロール (PRIM_CTRL) より継承
ShowMessagesLANSA内部専用 コントロール (PRIM_CTRL) より継承
SizeToサイズの変化をアニメーション化 コントロール (PRIM_CTRL) より継承
Width, Height, Duration, Delay
UnrealizeUnrealizeメソッドはコンポーネントを削除するためのメソッドです。 コントロール (PRIM_CTRL) より継承
UpdateDisplayUpdateDisplayメソッドは画面を直ちに更新します。 コントロール (PRIM_CTRL) より継承

参照

すべてのコンポーネント クラス

テクニカルリファレンス

EPC150060 - December 2023