トグルボタンのプロパティ
トグルボタンは、二者択一や項目のオン/オフの選択状態を、ボタンで表示する場合などに使用されます。
コマンドボタンと異なりボタンを1度クリックするとクリックされた状態を維持します。再度クリックすると元の状態に戻ります。
Visual Basic Editor【ﾋﾞｼﾞｭｱﾙﾍﾞｰｼｯｸｴﾃﾞｨﾀ】左下に表示される「プロパティウィンドウ」を使用して設定する場合のプロパティについて説明します。
なお、トグルボタンのイベントについては「トグルボタンのイベント」をご覧ください。
・（オブジェクト名）
ToggleButton【ﾄｸﾞﾙﾎﾞﾀﾝ】オブジェクトの名前を変更できます。既定値はToggleButton1から数を増やすごとにToggleButton2と番号が増えます。名前付けの規則は
1．英数字、漢字、ひらがな、カナカナ、_（アンダースコア）が使用できる※先頭に数字を使用することはできません。
2．既にあるオブジェクト名と同じ名前は使用できない。
3．スペースや記号は使用できない「.」「！」「@」「&」「$」「#」など
・Accelerator【ｱｸｾﾗﾚｰﾀ】
コントロールのアクセラレータキーを設定します。アクセラレータキーとは、ショートカットとして使用される1文字で、Altキーを押しながらアクセラレータキー（指定した1文字）を押すとこのトグルボタンにフォーカスが与えられます。
・AutoSize【ｵｰﾄｻｲｽﾞ】
トグルボタンのサイズをCaption（文字列）に合わせて、自動で拡大縮小するかを設定または取得します。
| 値 | 内容 |
|---|---|
| False | 自動でサイズ変更しません。（既定値） |
| True | 自動でサイズを変更します。 |
・BackColor【ﾊﾞｯｸｶﾗｰ】
トグルボタンの背景色をシステムまたは、パレットで設定または取得します。
※BackStyle【ﾊﾞｯｸｽﾀｲﾙ】の設定が1-fmbackStyleOpaqueの場合、設定が反映されます。
・BackStyle【ﾊﾞｯｸｽﾀｲﾙ】
トグルボタンの背景のスタイルを設定または取得します。
| 定数 | 値 | 内容 |
|---|---|---|
| fmBackStyleTranSparent | 0 | 背景を透明にします。 |
| fmbackStyleOpaque | 1 | BackColorプロパティで設定した色に 背景を塗りつぶします。（既定値） |
・Caption【ｷｬﾌﾟｼｮﾝ】
トグルボタンに表示する文字列を設定または取得します。
・ControlSuorce【ｺﾝﾄﾛｰﾙｿｰｽ】
セル番地を指定するとそのセルにトグルボタンの状態をブール型の値で表示します。
| 値 | 状態 |
|---|---|
| True | ボタンが押された状態 |
| False | ボタンが押されていない状態 |
・ControlTipText【ｺﾝﾄﾛｰﾙﾁｯﾌﾟﾃｷｽﾄ】
マウスポインターをトグルボタン上に置いたときに、表示する文字列を設定または取得します。
・Enabled【ｲﾅｰﾌﾞﾙﾄﾞ】
トグルボタンをイベントに対応するかしないかを設定または取得します。
| 値 | 内容 |
|---|---|
| True | 通常の表示で操作できます。（既定値） |
| False | 淡色表示になり操作できません。 |
・Font【ﾌｫﾝﾄ】
トグルボタンのCaption（文字列）のフォントを設定または取得します。
・ForeColor【ﾌｫｱｶﾗｰ】
トグルボタンのCaotion（文字列）の色を設定または取得します。
・Height【ﾊｲﾄ】
トグルボタンの高さをポイント単位で設定または取得します。
・HelpConTextID【ﾍﾙﾌﾟｺﾝﾃｷｽﾄｱｲﾃﾞｨ】
指定したオブジェクトと関連付けるヘルプトピックのコンテキストIDを設定します。既定値は0です。
・Left【ﾚﾌﾄ】
トグルボタンの位置をフォームの左端からポイント単位で設定または取得します。
・Locked【ﾛｯｸﾄｩ】
トグルボタンを編集できるかできないかを設定または取得します。
| 値 | 内容 |
|---|---|
| False | 編集可（既定値） |
| True | 編集不可（チェックできません。） |
・MouseIcon【ﾏｳｽｱｲｺﾝ】
マウスポインターがトグルボタン上にあるときの形状のアイコンファイルを設定します。
MousePointerプロパティが99-fmMousePointerCustomのときに設定が反映します。
・MousePointer【ﾏｳｽﾎﾟｲﾝﾀｰ】
マウスポインターがトグルボタンに移動したとき、表示されるポインターを設定または取得します。
| 定数 | 値 | 内容 |
|---|---|---|
| fmMousePointerDefault | 0 | 標準ポインター(既定値) |
| fmMousePointerArrow | 1 | 矢印 |
| fmMousePointerCross | 2 | 十字ポインター |
| fmMousePointerIBeam | 3 | I ビーム |
| fmMousePointerSizeNESW | 6 | 右上と左下を指し示す両端矢印 |
| fmMousePointerSizeNS | 7 | 上と下を指し示す両端矢印 |
| fmMousePointerSizeNWSE | 8 | 左上と右下を指し示す両端矢印 |
| fmMousePointerSizeWE | 9 | 左と右を指し示す両端矢印 |
| fmMousePointerUpArrow | 10 | 上向き矢印 |
| fmMousePointerHourglass | 11 | 砂時計 |
| fmMousePointerNoDrop | 12 | ドラッグされているオブジェクトに重なった “不可” シンボル無効なターゲットを示します。 |
| fmMousePointerAppStarting | 13 | 矢印と砂時計 |
| fmMousePointerHelp | 14 | 矢印と疑問符 |
| fmMousePointerSizeAll | 15 | サイズ変更カーソル (上下左右を指し示す矢印) |
| fmMousePointerCustom | 99 | MouseIcon プロパティで指定された アイコンを使用します。 |
・Picture【ﾋﾟｸﾁｬｰ】
トグルボタンの背景に設定する画像ファイルを設定します。
・PicturePosition【ﾋﾟｸﾁｬｰﾎﾟｼﾞｼｮﾝ】
ピクチャのキャプション（設定した文字列）に対する相対位置を設定します。
| 定数 | 値 | 内容 |
|---|---|---|
| fmPicturePositionLeftTop | 0 | ピクチャがキャプションの左側に表示されます キャプションはピクチャの 上端に合わせて配置されます |
| fmPicturePositionLeftCenter | 1 | ピクチャがキャプションの左側に表示されます キャプションはピクチャの 中央に合わせて配置されます |
| fmPicturePositionLeftBottom | 2 | ピクチャがキャプションの左側に表示されます キャプションはピクチャの 下端に合わせて配置されます。 |
| fmPicturePositionRightTop | 3 | ピクチャがキャプションの右側に表示されます キャプションはピクチャの 上端に合わせて配置されます。 |
| fmPicturePositionRightCenter | 4 | ピクチャがキャプションの右側に表示されます キャプションはピクチャの 中央に合わせて配置されます。 |
| fmPicturePositionRightBottom | 5 | ピクチャがキャプションの右側に表示されます キャプションはピクチャの 下端に合わせて配置されます。 |
| fmPicturePositionAboveLeft | 6 | ピクチャがキャプションの上に表示されます キャプションはピクチャの 左端に合わせて配置されます。 |
| fmPicturePositionAboveCenter | 7 | ピクチャがキャプションの上に表示されます キャプションはピクチャの 中央に合わせて配置されます (既定値) |
| fmPicturePositionAboveRight | 8 | ピクチャがキャプションの上に表示されます キャプションはピクチャの 右端に合わせて配置されます。 |
| fmPicturePositionBelowLeft | 9 | ピクチャがキャプションの下に表示されます キャプションはピクチャの 左端に合わせて配置されます |
| fmPicturePositionBelowCenter | 10 | ピクチャがキャプションの下に表示されます キャプションはピクチャの 中央に合わせて配置されます |
| fmPicturePositionBelowRight | 11 | ピクチャがキャプションの下に表示されます キャプションはピクチャの 右端に合わせて配置されます |
| fmPicturePositionCenter | 12 | ピクチャがコントロールの中央に表示されます キャプションはピクチャの 水平方向および垂直方向の 中央に合わせて配置されます。 |
・TabIndex【ﾀﾌﾞｲﾝﾃﾞｯｸｽ】
トグルボタンにフォーカスをあてる順番を設定または取得します。TabStop【ﾀﾌﾞｽﾄｯﾌﾟ】プロパティがTrueのとき反映します。
・TabStop【ﾀﾌﾞｽﾄｯﾌﾟ】
TabIndexの有効、無効を設定または取得します。
| 値 | 内容 |
|---|---|
| True | 有効（既定値） |
| False | 無効 |
・TextAlign【ﾃｷｽﾄｱﾗｲﾝ】
トグルボタンのCaption(文字列)の配置を設定します。
| 定数 | 値 | 内容 |
|---|---|---|
| fmTextAlignLeft | 1 | 左揃え（既定値） |
| fmTextAlignCenter | 2 | 中央揃え |
| fmTextAlignRight | 3 | 右揃え |
・Top【ﾄｯﾌﾟ】
トグルボタンの位置をフォームの上端を0として、ポイント単位で設定または取得します。
・TriPleState【ﾄﾘﾌﾟﾙｽﾃｰﾄ】
トグルボタンの状態を表す値True(押されている）False(押されていない）以外にNull(なにもない)値を設定するかしないかを設定します。
| 値 | 内容 |
|---|---|
| False | Nullはサポートしません。（既定値） |
| True | Nullを含めます。 |
・Value【ﾊﾞﾘｭｰ】
トグルボタンの状態をブール型の値で取得または設定します。
| 値 | 内容 |
|---|---|
| False | トグルボタンは押されていません。（既定値） |
| True | トグルボタンは押された状態です。 |
・Visible【ﾋﾞｼﾞﾌﾞﾙ】
このトグルボタンの表示、非表示を切り替えまたは状態を取得します。
| 値 | 内容 |
|---|---|
| True | 表示します。（既定値） |
| False | 非表示です。 |
・Width【ﾜｲｽﾞ】
トグルボタンの幅をポイント単位で設定または取得します。
・WordWrap【ﾜｰﾄﾞﾜｰﾌﾟ】
Caption（文字列）がトグルボタンの幅を超えたときの、折り返しの有無を設定または取得します。
| 値 | 内容 |
|---|---|
| True | 折り返します。（既定値） |
| False | 折り返しません。 |
以上で、トグルボタンのプロパティについての解説を終了します。ありがとうございました。