次の方法で共有

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

  • [アーティクル]

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

構文

式。Groupname

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

注釈

グループ内のすべてのトグル ボタンに同じ GroupName の設定値を使います。 既定値は、長さ 0 の文字列 ("") です。

常にいずれか 1 つだけを選択できるトグル ボタン ( ToggleButton) コントロールのグループを作成するには、フォーム上のフレーム ( 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 のサポートおよびフィードバックを参照してください。