Function Reference

GUICtrlCreateCheckbox

GUI用のチェックボックスコントロールを作成します。

GUICtrlCreateCheckbox ( "text", left, top [, width [, height [, style [, exStyle]]]] )

 

パラメータ

text チェックボックスコントロールのテキスト。
left コントロールの左端。-1を使用するとGUICoordModeに基づいて左端位置が計算されます。
top コントロールの上端。-1を使用するとGUICoordModeに基づいて上端位置が計算されます。
width [オプション] コントロールの幅(デフォルトではテキストの幅に合わせて自動調整されます)。
height [オプション] コントロールの高さ(デフォルトではテキストの高さに合わせて自動調整されます)。
style [オプション] コントロールのスタイルを定義。GUIコントロールスタイル付録を参照。

デフォルト ( -1) : $BS_AUTOCHECKBOX.
強制適用されるスタイル : チェックボックススタイルが定義されない場合$WS_TABSTOPと$BS_AUTOCHECKBOX。
exStyle [オプション] コントロールの拡張スタイルを定義。拡張スタイル表を参照。

 

返し値

成功 新しく作成したコントロールの識別子(コントロールID)を返します。
失敗 0を返します。

 

注意

コントロールの値を取得する方法についてはGUICtrlReadを参照。
コントロールの情報を設定/変更する方法についてはGUICtrlUpdate...を参照。

$BS_ICON、$BS_BITMAPスタイルを使用することでチェックボックスコントロールにアイコン、イメージを表示できます。使用する画像の指定にはGUICtrlSetImageを使用してください。

デフォルトスタイルに他のスタイルを組み合わせる場合はBitOr($GUI_SS_DEFAULT_CHECKBOX, newstyle,...)を使用してください。

上で指定されている値を使用するためにはスクリプトに#include <ButtonConstants.au3>と書く必要があります。

デフォルトのサイズ変更方法は$GUI_DOCKSIZEです。

 

関連

GUICoordMode (Option), GUICtrlUpdate..., GUIGetMsg

 


#include <GUIConstantsEx.au3>

Opt('MustDeclareVars', 1)

Example()

Func Example()
    Local $checkCN, $msg
    GUICreate("My GUI Checkbox")  ; 表示時に中央に表示されるダイアログボックスを作成

    $checkCN = GUICtrlCreateCheckbox("CHECKBOX 1", 10, 10, 120, 20)

    GUISetState()       ; チェックボックスを1つ持つダイアログボックスを表示

    ; ダイアログが閉じられるまでGUIを実行
    While 1
        $msg = GUIGetMsg()
       
        If $msg = $GUI_EVENT_CLOSE Then ExitLoop
    WEnd
EndFunc   ;==>Example