RibbonGroup インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
[リボン] タブのコントロールのグループを表します。
public interface class RibbonGroup : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")>]
type RibbonGroup = interface
interface RibbonComponent
interface IComponent
interface IDisposable
Public Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent
- 属性
- 実装
注釈
Visual Studio では、[ツールボックス] の RibbonGroup [Office リボン コントロール] タブからリボン Designerにグループ コントロールをドラッグすると、オブジェクトが作成されます。
一般的なタスク
次の表に、一般的なタスクに役立つメンバーを示します。 これらのタスクはすべて、設計時に実行できます。 これらのタスクの一部は、リボンが読み込まれる前に実行時に実行できます。 詳細については、「 リボン オブジェクト モデルの概要」を参照してください。
| タスク | メンバー |
|---|---|
| グループ内のコントロールにアクセスするか、グループにコントロールを追加するか、グループからコントロールを削除します。 | Items プロパティを使用します。 |
| リボン タブにグループを追加します。 | タブの RibbonGroup コレクションに Groups を追加します。 |
| 組み込みグループの場所を基準にして、組み込みタブでグループの場所を指定します。 | Position プロパティを使用します。 |
オブジェクトの メソッドを RibbonGroup 使用して、実行時に CreateRibbonGroup を RibbonFactory 作成できます。
RibbonFactory オブジェクトにアクセスするには、次の 2 つの方法があります。
リボン クラスの
Factoryプロパティの使用。 この方法は、リボン クラス内のコードから使用します。Globals.Factory.GetRibbonFactoryメソッドの使用。 この方法は、リボン クラス外のコードから使用します。
注意
これは、Visual Studio Tools for Office Runtime によって実装されたインターフェイスです。 コードに実装されるものではありません。 詳細については、「Visual Studio Tools for Office ランタイムの概要」を参照してください。
使用
ここでは、.NET Framework 4 以降を対象とする Office プロジェクトで使用される型のバージョンについて説明します。 .NET Framework 3.5 を対象とするプロジェクトでは、この型のメンバーが異なること、およびこのコード例が動作しないことがあります。 .NET Framework 3.5 を対象とするプロジェクトの型の詳細については、Visual Studio 2008 ドキュメントの次の参照セクションを参照してください。http://go.microsoft.com/fwlink/?LinkId=160658
プロパティ
| DialogLauncher |
グループに関連付けられているリボン ダイアログ ランチャーを取得または設定します。 |
| Id |
現在のグラフィックを識別する文字列を取得します。 |
| Items |
グループ内のコントロールを取得します。 |
| KeyTip |
グループのキーボード ショートカットを取得または設定します。 |
| Label |
グループのラベルによって表示されるテキストを取得または設定します。 |
| Name |
この RibbonComponent の名前を取得または設定します。 (継承元 RibbonComponent) |
| Parent |
この RibbonComponent の親を表す RibbonComponent を取得します。 (継承元 RibbonComponent) |
| Position |
組み込みタブ上のグループの位置、タブ上の組み込みグループの相対位置を取得または設定します。 |
| Ribbon |
コントロール階層を含む最上位 Ribbon オブジェクトを取得します。 (継承元 RibbonComponent) |
| RibbonUI |
Microsoft Office アプリケーションによってリボン機能拡張コードに提供される IRibbonUI のインスタンスを取得します。 (継承元 RibbonComponent) |
| Tag |
この RibbonComponent と関連付けられたアプリケーション固有のデータを取得または設定します。 (継承元 RibbonComponent) |
| Visible |
グループが表示されるかどうかを示す値を取得または設定します。 |
メソッド
| PerformDynamicLayout() |
RibbonComponent に動的メニューなどの動的な親があり、レイアウトが中断されていない場合に、親コントロールの Microsoft.Office.Core.IRibbonUI.InvalidateControl メソッドを呼び出します。 (継承元 RibbonComponent) |
| PerformLayout() |
に親があり、レイアウトが中断されていない場合に、RibbonComponentMicrosoft.Office.Core.IRibbonUI.InvalidateControl を呼び出します。 (継承元 RibbonComponent) |
| ResumeLayout() |
SuspendLayout() メソッドの実行結果を元に戻します。 (継承元 RibbonComponent) |
| ResumeLayout(Boolean) |
SuspendLayout() メソッドの実行結果を元に戻します。 (継承元 RibbonComponent) |
| SuspendLayout() |
Microsoft Office アプリケーションがリボン上のコントロールの状態を更新しないようにします。 (継承元 RibbonComponent) |
イベント
| DialogLauncherClick |
ユーザーがグループのリボン ダイアログ ランチャーをクリックすると発生します。 |