.NET Framework 4 または .NET Framework 4.5 に移行する Office プロジェクトのリボンのカスタマイズの更新

[アーティクル]
03/22/2013

プロジェクトの [リボン (ビジュアルなデザイナー)] のプロジェクト項目を使用して作成されたリボンのカスタマイズが含まれている場合は、ターゲットフレームワークを .NET Framework 4 か .NET Framework 4.5に変更する場合は、プロジェクトコードに対して次の変更を加える必要があります:

生成されたリボンコードを変更する。
実行時にリボンコントロールをインスタンス化するコード、リボンイベントを処理するコード、またはリボンコンポーネントの位置をプログラムによって設定するコードをすべて変更する。

生成されたリボンコードの更新

プロジェクトのターゲットフレームワークを .NET Framework 4 か .NET Framework 4.5に変更する場合は、次の手順を実行して、リボン項目に対して生成されたコードを変更する必要があります。更新する必要があるコードファイルは、プログラミング言語の種類とプロジェクトの作成方法に応じて次のように異なります。

Visual Basic プロジェクトまたは Visual C# で Visual Studio 2012 で作成または Visual Studio 2010 がリボンの分離コードファイル (YourRibbonItemですべての手順を実行することがあります。Designer.cs か YourRibbonItem。Designer.vb)。Visual Basic プロジェクトで分離コードファイルを確認するには、ソリューションエクスプローラーの [すべてのファイルの表示] をクリックします。
Visual C# では、Visual Studio 2008 で Visual Studio 2012に、アップグレードして作成し、リボンコードファイル (.cs または .vb) YourRibbonItemYourRibbonItemの最初の 2 種類のステップを実行しプロジェクト、およびリボンの分離コードファイルで残りのステップを実行します。

生成されたリボンコードを変更するには

Microsoft.Office.Tools.Ribbon.OfficeRibbon の代わりに Microsoft.Office.Tools.Ribbon.RibbonBase から派生するように、リボンクラスの宣言を変更します。
リボンクラスのコンストラクターを次のように変更します。コンストラクターに独自のコードを追加している場合は、コードを変更しないでください。Visual Basic プロジェクトでは、パラメーターなしのコンストラクターのみを変更します。その他のコンストラクターは無視します。

.NET Framework 3.5 を対象とするプロジェクトのリボンクラスの既定のコンストラクターを次のコード例に示します。
```
Public Sub New()
    MyBase.New()
    InitializeComponent()
End Sub
```
```
public Ribbon1()
{
    InitializeComponent();
}
```
次のコード例は、プロジェクトのリボンクラスの既定のコンストラクターを対象 .NET Framework 4 か .NET Framework 4.5示します。
```
Public Sub New()
    MyBase.New(Globals.Factory.GetRibbonFactory())
    InitializeComponent()
End Sub
```
```
public Ribbon1()
    : base(Globals.Factory.GetRibbonFactory())
{
    InitializeComponent();
}
```
InitializeComponent メソッドでは、代わりに RibbonFactory オブジェクトのいずれかのヘルパーメソッドが使用されるように、リボンコントロールを構築するすべてのコードを変更します。

[!メモ]

Visual C# プロジェクトでは、InitializeComponent メソッドを表示するために Component Designer generated code という名前の領域を展開する必要があります。

たとえば、.NET Framework 3.5 を対象とするプロジェクトで、button1 という名前の RibbonButton をインスタンス化する次のコード行がファイルに含まれていると仮定します。
```
Me.button1 = New Microsoft.Office.Tools.Ribbon.RibbonButton()
```
```
this.button1 = new Microsoft.Office.Tools.Ribbon.RibbonButton();
```
プロジェクトがターゲット .NET Framework 4 か .NET Framework 4.5の代わりに次のコードを使用する必要があります。
```
Me.button1 = Me.Factory.CreateRibbonButton()
```
```
this.button1 = this.Factory.CreateRibbonButton();
```
リボンコントロールのすべてのヘルパーメソッドの一覧については、「リボンコントロールのインスタンス化」を参照してください。
Visual C# プロジェクトでは、代わりに特定のリボンデリゲートが使用されるように、EventHandler<TEventArgs> デリゲートを使用する InitializeComponent メソッドのコード行を変更します。

たとえば、.NET Framework 3.5 を対象とするプロジェクトで、RibbonButton.Click イベントを処理する次のコード行がファイルに含まれていると仮定します。
```
this.button1.Click += new System.EventHandler<Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>(
    this.button1_Click);
```
プロジェクトがターゲット .NET Framework 4 か .NET Framework 4.5の代わりに次のコードを使用する必要があります。
```
this.button1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
    this.button1_Click);
```
すべてのリボンデリゲートの一覧については、「リボンイベントの処理」を参照してください。
Visual Basic プロジェクトでは、ファイルの最後にある ThisRibbonCollection クラスを検索します。このクラスが Microsoft.Office.Tools.Ribbon.RibbonReadOnlyCollection から継承されないように、クラスの宣言を変更します。

リボンコントロールのインスタンス化

リボンコントロールを動的にインスタンス化するすべてのコードを変更する必要があります。.NET Framework 3.5 を対象とするプロジェクトでは、リボンコントロールは特定のシナリオで直接インスタンス化できるクラスです。.NET Framework 4 か .NET Framework 4.5を対象とするプロジェクトでは、これらのコントロールは、直接インスタンス化できないインターフェイスです。コントロールを作成するには、RibbonFactory オブジェクトが提供するメソッドを使用する必要があります。

RibbonFactory オブジェクトにアクセスするには、次の 2 つの方法があります。

リボンクラスの Factory プロパティの使用。この方法は、リボンクラス内のコードから使用します。
Globals.Factory.GetRibbonFactory メソッドの使用。この方法は、リボンクラス外のコードから使用します。Globals クラスの詳細については、「Office プロジェクト内のオブジェクトへのグローバルアクセス」を参照してください。

次のコード例は、プロジェクトのリボンクラスの RibbonButton を作成して、を対象 .NET Framework 4 か .NET Framework 4.5示します。

Dim button As Microsoft.Office.Tools.Ribbon.RibbonButton =
    Me.Factory.CreateRibbonButton()

Microsoft.Office.Tools.Ribbon.RibbonButton button =
    this.Factory.CreateRibbonButton();

次の表は、.NET Framework 4 か .NET Framework 4.5を対象とするプロジェクトでのコントロールの作成に使用するメソッドプログラムで作成できるコントロールの一覧を示します。

Control	.NET Framework 4 と .NET Framework 4.5 プロジェクトで使用する RibbonFactory メソッド
RibbonButton	CreateRibbonButton
RibbonButtonGroup	CreateRibbonButtonGroup
RibbonCheckBox	CreateRibbonCheckBox
RibbonComboBox	CreateRibbonComboBox
RibbonDialogLauncher	CreateRibbonDialogLauncher
RibbonDropDown:	CreateRibbonDropDown
RibbonDropDownItem	CreateRibbonDropDownItem
RibbonEditBox	CreateRibbonEditBox
RibbonGallery	CreateRibbonGallery
RibbonGroup	CreateRibbonGroup
RibbonLabel	CreateRibbonLabel
RibbonManager	CreateRibbonManager
RibbonMenu	CreateRibbonMenu
RibbonSeparator	CreateRibbonSeparator
RibbonSplitButton	CreateRibbonSplitButton
RibbonTab	CreateRibbonTab
RibbonToggleButton	CreateRibbonToggleButton

リボンイベントの処理

リボンコントロールのイベントを処理するすべてのコードを変更する必要があります。.NET Framework 3.5 を対象とするプロジェクトでは、これらのイベントは汎用の EventHandler<TEventArgs> デリゲートによって処理されます。.NET Framework 4 か .NET Framework 4.5を対象とするプロジェクトでは、これらのイベントは他のデリゲートによって処理されるようになりました。

次の表は .NET Framework 4 か .NET Framework 4.5を対象とするプロジェクトでこれらのイベントに関連付けられたデリゲート、リボンのイベントを示します。

Event	.NET Framework 4 と .NET Framework 4.5 のプロジェクトで使用するデリゲート
生成されたリボンクラスの LoadImage イベント	RibbonLoadImageEventHandler
Load	RibbonUIEventHandler
RibbonButton.Click RibbonCheckBox.Click RibbonComboBox.ItemsLoading RibbonComboBox.TextChanged RibbonDropDown.ButtonClick RibbonDropDown.ItemsLoading RibbonDropDown.SelectionChanged RibbonEditBox.TextChanged RibbonGallery.ButtonClick RibbonGallery.Click RibbonGallery.ItemsLoading RibbonGroup.DialogLauncherClick RibbonMenu.ItemsLoading RibbonSplitButton.Click RibbonToggleButton.Click	RibbonControlEventHandler

生成されたリボンクラスの LoadImage イベント

RibbonLoadImageEventHandler

RibbonComboBox.ItemsLoading

RibbonComboBox.TextChanged

RibbonDropDown.ButtonClick

RibbonDropDown.ItemsLoading

RibbonDropDown.SelectionChanged

RibbonEditBox.TextChanged

RibbonGallery.ButtonClick

RibbonGallery.Click

RibbonGallery.ItemsLoading

RibbonGroup.DialogLauncherClick

RibbonMenu.ItemsLoading

RibbonSplitButton.Click

RibbonToggleButton.Click

RibbonControlEventHandler

リボンコンポーネントの位置をプログラムによって設定する

リボンのグループ、タブ、またはコントロールの位置を設定するすべてのコードを変更する必要があります。.NET Framework 3.5 を対象とするプロジェクトでは、静的な Microsoft.Office.Tools.Ribbon.RibbonPosition クラスの AfterOfficeId メソッドと BeforeOfficeId メソッドを使用して、グループ、タブ、またはコントロールの Position プロパティを割り当てることができます。.NET Framework 4 か .NET Framework 4.5を対象とするプロジェクトでは、RibbonFactory のオブジェクトによって提供される RibbonPosition のプロパティを使用して、これらのメソッドにアクセスする必要があります。

RibbonFactory オブジェクトにアクセスするには、次の 2 つの方法があります。

リボンクラスの Factory プロパティの使用。この方法は、リボンクラス内のコードから使用します。
Globals.Factory.GetRibbonFactory メソッドの使用。この方法は、リボンクラス外のコードから使用します。Globals クラスの詳細については、「Office プロジェクト内のオブジェクトへのグローバルアクセス」を参照してください。

次のコード例は、.NET Framework 3.5 を対象とするプロジェクトでリボンクラスのタブの Position プロパティを設定する方法を示しています。

Me.tab1.Position = RibbonPosition.AfterOfficeId("TabHome")

this.tab1.Position = RibbonPosition.AfterOfficeId("TabHome");

次のコード例は、同じ作業を .NET Framework 4 を対象とするプロジェクトで行う方法を示しています。

Me.tab1.Position = Me.Factory.RibbonPosition.AfterOfficeId("TabHome")

this.tab1.Position = this.Factory.RibbonPosition.AfterOfficeId("TabHome");

参照

概念

.NET Framework 4 または .NET Framework 4.5 への Office ソリューションの移行

リボンデザイナー

次の方法で共有

.NET Framework 4 または .NET Framework 4.5 に移行する Office プロジェクトのリボンのカスタマイズの更新

生成されたリボンコードの更新

生成されたリボンコードを変更するには

リボンコントロールのインスタンス化

リボンイベントの処理

リボンコンポーネントの位置をプログラムによって設定する

参照

概念

その他のリソース

次の方法で共有

.NET Framework 4 または .NET Framework 4.5 に移行する Office プロジェクトのリボンのカスタマイズの更新

生成されたリボン コードの更新

生成されたリボン コードを変更するには

リボン コントロールのインスタンス化

リボン イベントの処理

リボン コンポーネントの位置をプログラムによって設定する

参照

概念

その他のリソース

生成されたリボンコードの更新

生成されたリボンコードを変更するには

リボンコントロールのインスタンス化

リボンイベントの処理

リボンコンポーネントの位置をプログラムによって設定する