Excel VBA トグルボタンのプロパティ

スポンサーリンク

トグルボタンのプロパティ

トグルボタンは、二者択一や項目のオン/オフの選択状態を、ボタンで表示する場合などに使用されます。

コマンドボタンと異なりボタンを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 折り返しません。

以上で、トグルボタンのプロパティについての解説を終了します。ありがとうございました。

スポンサーリンク

関連記事・広告