Aktualizowanie dostosowań wstążki w projektach związanych z pakietem Office przenoszonych do oprogramowania .NET Framework w wersji 4 lub 4.5

Artykuł
06/10/2015

Jeśli projekt zawiera dostosowania wstążki, który został utworzony za pomocą wstążki (Visual Designer) na towary do projektu, należy wprowadzić następujące zmiany do kodu projektu Jeżeli ramach docelowego została zmieniona na Program .NET Framework 4 lub Program .NET Framework 4.5:

Zmodyfikować wygenerowany kod wstążki.
Modyfikowanie wszelki kod, który uruchamia formanty wstążki w czasie wykonywania, obsługuje zdarzenia Wstążki lub programowo Ustawia położenie elementu Wstążkę.

Aktualizowanie kodu wygenerowanego wstążki

Jeśli ramy cel projektu zostanie zmieniona na Program .NET Framework 4 lub Program .NET Framework 4.5, należy zmienić wygenerowany kod dla elementu Wstążkę, wykonując następujące kroki.Pliki kodu, który trzeba zaktualizować zależą od języka programowania i sposobu tworzenia projektu:

W projekty języka Visual Basic lub Visual C# projekty utworzone w jednej Visual Studio 2012 lub Visual Studio 2010 wykonać wszystkie kroki w pliku kodem wstążki (YourRibbonItem.Designer.cs narzędzie lub YourRibbonItem.Designer.VB).Aby wyświetlić plik kodem w projekty języka Visual Basic, kliknij przycisk Pokaż wszystkie pliki przycisk w Solution Explorer.
W środowisku Visual C# projekty, które utworzone w programie Visual Studio 2008, a następnie uaktualniono do Visual Studio 2013, wykonać dwa pierwsze kroki w pliku kodu wstążki (YourRibbonItemCS lub YourRibbonItem.vb) i wykonaj pozostałe kroki w pliku kodem wstążki.

Aby zmienić wygenerowany kod wstążki

Zmodyfikuj deklaracja klasy wstążki, tak aby pochodzi od RibbonBase zamiast Microsoft.Office.Tools.Ribbon.OfficeRibbon.
Modyfikowanie Konstruktor klasy wstążki, jak pokazano poniżej.Jeśli którykolwiek z własnego kodu dodano do konstruktora, nie należy zmieniać swój kod.W projekty języka Visual Basic należy zmodyfikować konstruktora bez parametrów.Ignoruj inne Konstruktor.

Poniższy przykład kodu pokazuje domyślnego konstruktora klasy wstążki w projekcie, atakującego.NET Framework 3.5.
```
Public Sub New()
    MyBase.New()
    InitializeComponent()
End Sub
```
```
public Ribbon1()
{
    InitializeComponent();
}
```
Poniższy przykład kodu pokazuje domyślnego konstruktora klasy wstążki w projekcie atakującego Program .NET Framework 4 lub Program .NET Framework 4.5.
```
Public Sub New()
    MyBase.New(Globals.Factory.GetRibbonFactory())
    InitializeComponent()
End Sub
```
```
public Ribbon1()
    : base(Globals.Factory.GetRibbonFactory())
{
    InitializeComponent();
}
```
W InitializeComponent metoda, modyfikować wszelki kod, który konstruuje formantu wstążki, tak, że kod zamiast tego wykorzystuje jedną z metod Pomocnika RibbonFactory obiektu.

[!UWAGA]

W środowisku Visual C# projektów, należy rozwinąć regionu o nazwie Component Designer generated code aby zobaczyć InitializeComponent metody.

Załóżmy na przykład, czy plik zawiera następujący wiersz kodu, który tworzy RibbonButton o nazwie button1 w projekcie, które jest przeznaczony dla.NET Framework 3.5.
```
Me.button1 = New Microsoft.Office.Tools.Ribbon.RibbonButton()
```
```
this.button1 = new Microsoft.Office.Tools.Ribbon.RibbonButton();
```
W programie project, który jest przeznaczony dla Program .NET Framework 4 lub Program .NET Framework 4.5, należy użyć następującego kodu.
```
Me.button1 = Me.Factory.CreateRibbonButton()
```
```
this.button1 = this.Factory.CreateRibbonButton();
```
Aby uzyskać pełną listę metody pomocnika dla formanty wstążki, zobacz Formanty wstążki utworzenie wystąpienia.
W środowisku Visual C# projektów, zmodyfikować dowolnego wiersza kodu w InitializeComponent metodą korzystającej z EventHandler delegata zamiast tego użyć konkretnych pełnomocnik wstążki.

Załóżmy na przykład, czy plik zawiera następujący wiersz kodu, który obsługuje RibbonButton.Click zdarzenia w projekcie, które jest przeznaczony dla.NET Framework 3.5.
```
this.button1.Click += new System.EventHandler<Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs>(
    this.button1_Click);
```
W programie project, który jest przeznaczony dla Program .NET Framework 4 lub Program .NET Framework 4.5, należy użyć następującego kodu.
```
this.button1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
    this.button1_Click);
```
Aby uzyskać pełną listę delegatów wstążki, zobacz Obsługi zdarzeń wstążki.
Projekty języka Visual Basic, zlokalizuj ThisRibbonCollection klasy na końcu pliku.Zmodyfikuj zgłoszenia tej klasy, tak aby nie dziedziczy z Microsoft.Office.Tools.Ribbon.RibbonReadOnlyCollection.

Utworzenie wystąpienia formanty wstążki

Należy zmodyfikować wszelki kod, który dynamicznie tworzy formanty wstążki.W projektach obiektu docelowego.NET Framework 3.5, formanty wstążki są klasy, które można utworzyć wystąpienie bezpośrednio w niektórych scenariuszach.W projektach przeznaczonych z Program .NET Framework 4 lub Program .NET Framework 4.5, te formanty są interfejsy, które nie możesz utworzyć wystąpienia bezpośrednio.Formanty należy utworzyć przy użyciu metod, które zostały udostępnione przez RibbonFactory obiektu.

Istnieją dwa sposoby dostępu do RibbonFactory obiekt:

Za pomocą Factory właściwość klasy wstążki.Użyj tego podejścia z kodu w klasie wstążki.
Za pomocą Globals.Factory.GetRibbonFactory metody.Użyj tego podejścia do kodu poza klasy wstążki.Aby uzyskać więcej informacji o Globals klasy, zobacz Globalny dostęp do obiektów w projektach pakietu Office.

Poniższy kod ilustruje sposób tworzenia RibbonButton w klasie wstążki w projekt, który jest przeznaczony dla Program .NET Framework 4 lub Program .NET Framework 4.5.

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

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

W poniższej tabeli przedstawiono formanty można tworzyć programowo i metoda służy do tworzenia formantów w projektach przeznaczonych z Program .NET Framework 4 lub Program .NET Framework 4.5.

Formant	Metoda RibbonFactory do wykorzystania w Program .NET Framework 4 i Program .NET Framework 4.5 projektów
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

Obsługa zdarzeń wstążki

Należy zmodyfikować wszelki kod, który obsługuje zdarzenia formanty wstążki.W projektach.NET Framework 3.5, te zdarzenia są obsługiwane przez nazwę rodzajową EventHandler delegować.W projektach przeznaczonych z Program .NET Framework 4 lub Program .NET Framework 4.5, te zdarzenia są teraz obsługiwane przez innych przedstawicieli.

W poniższej tabeli przedstawiono zdarzenia Wstążki i delegatów, które są skojarzone z nimi w projektach Program .NET Framework 4 lub Program .NET Framework 4.5.

Zdarzenie	Delegowanie do użycia w Program .NET Framework 4 i Program .NET Framework 4.5 projektów
LoadImagezdarzenia w generowanej klasy wstążki	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

LoadImagezdarzenia w generowanej klasy wstążki

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

Ustawienie programowo położenia komponentu wstążki

Należy zmodyfikować wszelki kod, który ustawia pozycję grup, karty lub formanty wstążki.W projektach.NET Framework 3.5, można użyć AfterOfficeId i BeforeOfficeId metody statycznej Microsoft.Office.Tools.Ribbon.RibbonPosition klasy, aby przypisać Position grupy, kartę lub formantu.W projektach przeznaczonych z Program .NET Framework 4 lub Program .NET Framework 4.5, metody te muszą uzyskać dostęp za pomocą RibbonPosition właściwość dostarczonych przez RibbonFactory obiektu.

Istnieją dwa sposoby dostępu do RibbonFactory obiekt:

Za pomocą Factory właściwość klasy wstążki.Użyj tego podejścia z kodu w klasie wstążki.
Za pomocą Globals.Factory.GetRibbonFactory metody.Użyj tego podejścia do kodu poza klasy wstążki.Aby uzyskać więcej informacji o Globals klasy, zobacz Globalny dostęp do obiektów w projektach pakietu Office.

Poniższy przykład kodu pokazuje, jak ustawić Position właściwości karty w klasie wstążki w projekt, który jest przeznaczony dla.NET Framework 3.5.

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

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

Poniższy przykład kodu demonstruje tego samego zadania w projekcie, które jest przeznaczony dla Program .NET Framework 4.

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

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

Zobacz też

Koncepcje

Migracja rozwiązań Office do oprogramowania .NET Framework w wersji 4 lub 4.5

Projektant wstążki

Udostępnij za pośrednictwem