PowerTools PlusPak for Windows Forms 8.0J
チェックマークの変更

GcRadioButtonコントロールのチェックマークの変更方法について、以下に解説します。

チェックマークイメージのカスタマイズ
GcRadioButton コントロールのチェックマークをカスタマイズするには、プロパティウィンドウでCheckMarkプロパティを開いて、各メンバに画像を設定します。複数の GcRadioButton コントロールに同じチェックマークイメージを定義したいときは、対象のコントロールをすべて選択して、設定を行うと効率的です。



次の一覧は、CheckMark プロパティで定義できるメンバとそれに対応する状態の説明です。

プロパティ 説明
CheckedHoverImage チェックの状態がチェックで、マウスカーソルがコントロールの上に置かれている場合のチェックマーク イメージ
CheckedNormalImage チェックの状態がチェックで、コントロールが通常の状態の場合のチェックマーク イメージ
CheckedPressedImage チェックの状態がチェックで、マウスボタンがコントロールの上でクリックされた場合のチェックマーク イメージ
UncheckedHoverImage チェックの状態が未チェックで、マウスカーソルがコントロールの上に置かれている場合のチェックマーク イメージ
UncheckedNormalImage チェックの状態が未チェックで、コントロールが通常の状態の場合のチェックマーク イメージ
UncheckedPressedImage チェックの状態が未チェックで、マウスボタンがコントロールの上でクリックされた場合のチェックマーク イメージ

カスタム画像を設定していない状態は、デフォルトのイメージで表示されます。そのため、HoverImage や PressedImage に NormalImage と異なるイメージを使用しなくても、NormalImage と同じ画像で設定してください。

次のサンプルコードは、コードでチェックマークイメージを定義する方法を示します。

Dim imgCheck As Image = Image.FromFile("c:\image\Check.png")
Dim imgUnCheck As Image = Image.FromFile("c:\image\UnCheck.png")

' 一つ目のラジオボタンの画像を設定します。
GcRadioButton1.CheckMark.CheckedHoverImage = imgCheck
GcRadioButton1.CheckMark.CheckedNormalImage = imgCheck
GcRadioButton1.CheckMark.CheckedPressedImage = imgCheck
GcRadioButton1.CheckMark.UncheckedHoverImage = imgUnCheck
GcRadioButton1.CheckMark.UncheckedNormalImage = imgUnCheck
GcRadioButton1.CheckMark.UncheckedPressedImage = imgUnCheck

' 二つ目のラジオボタンに同様の画像を設定します。
...

' 三つ目のラジオボタンに同様の画像を設定します。
...
Image imgCheck = Image.FromFile(@"c:\image\Check.png");
Image imgUnCheck = Image.FromFile(@"c:\image\UnCheck.png");

// 一つ目のラジオボタンの画像を設定します。
gcRadioButton1.CheckMark.CheckedHoverImage = imgCheck;
gcRadioButton1.CheckMark.CheckedNormalImage = imgCheck;
gcRadioButton1.CheckMark.CheckedPressedImage = imgCheck;
gcRadioButton1.CheckMark.UncheckedHoverImage = imgUnCheck;
gcRadioButton1.CheckMark.UncheckedNormalImage = imgUnCheck;
gcRadioButton1.CheckMark.UncheckedPressedImage = imgUnCheck;

// 二つ目のラジオボタンに同様の画像を設定します。
...

// 三つ目のラジオボタンに同様の画像を設定します。
...


GcRadioButton コントロールは個々のラジオボタンに異なるイメージを設定することもできます。個々の内容に適したイメージを設定することで、エンドユーザーがより直感的に認識できるようになります。



チェックマークのサイズ変更
チェックマークのサイズを変更するには、CheckMarkAutoSizeCheckMarkSizeプロパティを使用します。

CheckMarkAutoSize プロパティを True に設定したとき、チェックマークはコントロールのフォントの高さに応じて自動的に調整します。



任意のサイズを指定したい場合は、CheckMarkAutoSize プロパティを False に設定し、CheckMarkSize プロパティに値を設定します。

' チェックマークの自動サイズ調整を無効にします。
GcRadioButton1.CheckMarkAutoSize = False
' チェックマークのサイズを設定にします。
GcRadioButton1.CheckMarkSize = New Size(32, 32)
// チェックマークの自動サイズ調整を無効にします。
gcRadioButton1.CheckMarkAutoSize = false;
// チェックマークのサイズを設定にします。
gcRadioButton1.CheckMarkSize = new Size(32, 32);


参照