次の方法で共有

CheckBox.GroupName プロパティ (Outlook フォーム スクリプト)

  • [アーティクル]

同時に選択できない CheckBox コントロールのグループを示す、文字列型 ( String) の値を取得または設定します。 値の取得と設定が可能です。

構文

式。Groupname

式CheckBox オブジェクトを表す変数。

注釈

グループ内のチェック ボックスについてはすべて同一の GroupName を使用します。 既定値は、長さ 0 の文字列 ("") です。

CheckBox コントロールのグループを作成するには、フォーム上のフレーム ( Frame ) にチェック ボックスを配置するか、 GroupName プロパティを使用します。 GroupName プロパティを使用すると、次のような利点があります。

  • グループごとに Frame を含める必要はありません。 Frame を使用しないと、フォーム上のコントロールの数が減り、結果としてパフォーマンスが向上し、ファームのサイズが小さくなります。

  • 設計の柔軟性が高まります。 Frame を使用してグループを作成する場合は、すべてのチェック ボックスが Frame 内にある必要があります。 複数のグループが必要な場合は、グループごとに 1 つの Frame が必要です。 ただし、 GroupName を 使用してグループを作成する場合、グループにはフォーム上の任意の場所にチェック ボックスを含めることができます。 複数のグループが必要な場合は、グループごとに一意の名前を指定します。フォーム上の任意の場所に個々のコントロールを配置できます。

  • 背景を透明に設定したチェック ボックスを作成できます。 フレーム ( Frame) コントロールは透明なコントロールではありません。

チェック ボックスのグループを作成する際、どのメソッドを使用するかにかかわらず、グループ内の 1 つのチェック ボックスをクリックすると、同じグループ内のほかのチェック ボックスには False が設定されます。 1 つのコンテナーの中で、同じ GroupName プロパティを持つすべてのチェック ボックスの中から 1 つの項目だけを選択できます。 2 つのコンテナーで同じグループ名を使用しますが、これにより、両方のコンテナーを含む 1 つのグループではなく、2 つのグループ (各コンテナーに 1 つ) が作成されます。

たとえば、複数のオプション ボタンを配置したフォームと、同様にいくつかのオプション ボタンを配置したマルチ ページ ( MultiPage ) コントロールがあるとします。 MultiPage 上のコントロールに配置したチェック ボックスは 1 つのグループで、フォームに配置したオプション ボタンは別のグループになります。 2 つのグループは互いに影響しません。 MultiPage 上のコントロールに配置したチェック ボックスのオン/オフを変更しても、フォームに配置したチェック ボックスには影響しません。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。