Przewodnik: tworzenie karty niestandardowej przy użyciu Projektant wstążki

Za pomocą Projektant wstążki można utworzyć kartę niestandardową, a następnie dodać i umieścić na niej kontrolki.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu dla programu Excel. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

W instruktażu przedstawiono następujące zagadnienia:

• Tworzenie okienek akcji.

• Utwórz kartę niestandardową.

• Ukryj i pokaż okienka akcji przy użyciu przycisków na karcie niestandardowej.

Uwaga

Na komputerze w poniższych instrukcjach mogą być wyświetlane inne nazwy i lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio. Te elementy są określane przez numer wersji Visual Studio oraz twoje ustawienia. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE programu Visual Studio.

Wymagania wstępne

Następujące składniki są wymagane do przeprowadzenia tego instruktażu:

• Edycja programu Visual Studio, która oferuje narzędzia deweloperskie pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz Konfigurowanie komputera do tworzenia rozwiązań pakietu Office.

• Microsoft Excel

Tworzenie projektu skoroszytu programu Excel

Kroki używania Projektant wstążki są prawie identyczne dla wszystkich aplikacja pakietu Office licacji. W tym przykładzie użyto skoroszytu programu Excel.

Aby utworzyć projekt skoroszytu programu Excel

• Utwórz projekt skoroszytu programu Excel o nazwie MyExcelRibbon. Aby uzyskać więcej informacji, zobacz How to: Create Office Projects in Visual Studio (Jak tworzyć projekty pakietu Office w programie Visual Studio).

  Program Visual Studio otwiera nowy skoroszyt w projektancie i dodaje projekt MyExcelRibbon do Eksplorator rozwiązań.

Tworzenie okienek akcji

Dodaj do projektu dwa okienka akcji niestandardowych. Później dodasz przyciski, które wyświetlają i ukrywają te okienka akcji na karcie niestandardowej.

Aby utworzyć okienka akcji

1. W menu Project (Projekt) wybierz pozycję Add New Item (Dodaj nowy element).

2. W oknie dialogowym Dodawanie nowego elementu wybierz pozycję ActionsPaneControl, a następnie wybierz pozycję Dodaj.

   Plik ActionsPaneControl1.cs lub ActionsPaneControl1.vb zostanie otwarty w projektancie.

3. Na karcie Wspólne kontrolkiprzybornika dodaj etykietę do powierzchni projektanta.

4. W oknie Właściwości ustaw właściwość Text etykiety1 na Akcje Okienko 1.

5. Powtórz kroki od 1 do 5, aby utworzyć drugie okienko akcji i etykietę. Ustaw właściwość Text drugiej etykiety na Akcje Okienko 2.

Tworzenie karty niestandardowej

Jednym z wytycznych dotyczących projektowania aplikacja pakietu Office lication jest to, że użytkownicy powinni zawsze mieć kontrolę nad interfejsem użytkownika aplikacja pakietu Office lication. Aby dodać tę funkcję dla okienk akcji, możesz dodać przyciski, które pokazują i ukrywają każde okienko akcji na karcie niestandardowej na wstążce. Aby utworzyć kartę niestandardową, dodaj element wstążki (Visual Projektant) do projektu. Projektant pomaga dodawać i umieszczać kontrolki, ustawiać właściwości kontrolki i obsługiwać zdarzenia sterowania.

Aby utworzyć kartę niestandardową

1. W menu Project (Projekt) wybierz pozycję Add New Item (Dodaj nowy element).

2. W oknie dialogowym Dodawanie nowego elementu wybierz pozycję Wstążka (Visual Projektant).

3. Zmień nazwę nowej wstążki na MyRibbon, a następnie wybierz pozycję Dodaj.

   Plik MyRibbon.cs lub MyRibbon.vb zostanie otwarty w Projektant wstążki i wyświetli domyślną kartę i grupę.

4. Na Projektant wstążki wybierz kartę domyślną.

5. W oknie Właściwości rozwiń właściwość ControlId, a następnie ustaw właściwość ControlIdType na Wartość niestandardowa.

6. Ustaw właściwość Label na Wartość Moja karta niestandardowa.

7. W Projektant wstążki wybierz grupę1.

8. W oknie Właściwości ustaw pozycję Etykieta na Menedżer okienka akcji.

9. Na karcie Kontrolki wstążki pakietu Office przybornika przeciągnij przycisk na grupę1.

10. Wybierz przycisk1.

11. W oknie Właściwości ustaw wartość Etykieta na Pokaż akcje Okienko 1.

12. Dodaj drugi przycisk do grupy group1 i ustaw właściwość Label na Pokaż okienko akcji 2.

13. Na karcie Kontrolki wstążki pakietu Office przybornika przeciągnij kontrolkę ToggleButton do grupy group1.

14. Ustaw właściwość Label na Ukryj okienko akcji.

Ukryj i pokaż okienka akcji przy użyciu przycisków na karcie niestandardowej

Ostatnim krokiem jest dodanie kodu, który odpowiada użytkownikowi. Dodaj programy obsługi zdarzeń dla Click zdarzeń dwóch przycisków i Click zdarzenia przycisku przełącznika. Dodaj kod do tych procedur obsługi zdarzeń, aby włączyć ukrywanie i wyświetlanie okienek akcji.

Aby ukryć i pokazać okienka akcji przy użyciu przycisków na karcie niestandardowej

1. W Eksplorator rozwiązań otwórz menu skrótów dla pliku MyRibbon.cs lub MyRibbon.vb, a następnie wybierz pozycję Wyświetl kod.

2. Dodaj następujący kod na początku MyRibbon klasy. Ten kod tworzy dwa obiekty okienka akcji.

   C#

   ActionsPaneControl1 actionsPane1 = new ActionsPaneControl1();
   ActionsPaneControl2 actionsPane2 = new ActionsPaneControl2();
   

   VB

   Dim actionsPane1 As New ActionsPaneControl1()
   Dim actionsPane2 As New ActionsPaneControl2()
   

3. Zastąp metodę MyRibbon_Load następującym kodem. Ten kod dodaje obiekty okienka akcji do Controls kolekcji i ukrywa obiekty przed widokiem. Kod języka Visual C# dołącza również delegatów do kilku zdarzeń sterowania wstążką.

   C#

   private void MyRibbon_Load(object sender, RibbonUIEventArgs e)
   {
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1);
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2);
       actionsPane1.Hide();
       actionsPane2.Hide();
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
   
       this.button1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
           this.button1_Click);
       this.button2.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
           this.button2_Click);
       this.toggleButton1.Click += new Microsoft.Office.Tools.Ribbon.RibbonControlEventHandler(
           this.toggleButton1_Click);
   
   
   }
   

   VB

   Private Sub MyRibbon_Load(ByVal sender As System.Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonUIEventArgs) Handles MyBase.Load
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane1)
       Globals.ThisWorkbook.ActionsPane.Controls.Add(actionsPane2)
       actionsPane1.Hide()
       actionsPane2.Hide()
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
   End Sub
   

4. Dodaj do klasy następujące trzy metody MyRibbon obsługi zdarzeń. Te metody obsługują Click zdarzenia dwóch przycisków i Click zdarzenie przełącznika. Programy obsługi zdarzeń dla przycisk1 i button2 zawierają okienka akcji alternatywnych. Program obsługi zdarzeń przełącznikButton1 pokazuje i ukrywa aktywne okienko akcji.

   C#

   private void button1_Click(object sender, RibbonControlEventArgs e)
   {
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
       actionsPane2.Hide();
       actionsPane1.Show();
       toggleButton1.Checked = false;
   }
   
   private void button2_Click(object sender, RibbonControlEventArgs e)
   {
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
       actionsPane1.Hide();
       actionsPane2.Show();
       toggleButton1.Checked = false;
   
   }
   
   private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
   {
       if (toggleButton1.Checked == true)
       {
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = false;
       }
       else
       {
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = true;
       }
   
   }
   

   VB

   Private Sub Button1_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
           Handles Button1.Click
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
       actionsPane2.Hide()
       actionsPane1.Show()
       ToggleButton1.Checked = False
   End Sub
   
   Private Sub Button2_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
           Handles Button2.Click
   
       Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
       actionsPane1.Hide()
       actionsPane2.Show()
       ToggleButton1.Checked = False
   
   End Sub
   
   
   Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) _
           Handles ToggleButton1.Click
   
       If ToggleButton1.Checked Then
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = False
       Else
           Globals.ThisWorkbook.Application.DisplayDocumentActionTaskPane = True
       End If
   
   End Sub
   

Testowanie karty niestandardowej

Po uruchomieniu projektu program Excel zostanie uruchomiony, a na wstążce zostanie wyświetlona karta Moja karta niestandardowa. Wybierz przyciski na karcie Moje niestandardowe, aby wyświetlić i ukryć okienka akcji.

Aby przetestować kartę niestandardową

1. Naciśnij klawisz F5 , aby uruchomić projekt.

2. Wybierz kartę Moja karta niestandardowa.

3. W grupie Menedżer okienka akcji niestandardowych wybierz pozycję Pokaż akcje Okienko 1.

   Zostanie wyświetlone okienko akcji i zostanie wyświetlona etykieta Okienko akcji 1.

4. Wybierz pozycję Pokaż okienko akcji 2.

   Zostanie wyświetlone okienko akcji i zostanie wyświetlona etykieta Okienko akcji 2.

5. Wybierz pozycję Ukryj okienko akcji.

   Okienka akcji nie są już widoczne.

Następne kroki

Więcej informacji na temat dostosowywania interfejsu użytkownika pakietu Office można znaleźć w następujących tematach:

• Dodaj interfejs użytkownika oparty na kontekście do dowolnego dostosowania na poziomie dokumentu. Aby uzyskać więcej informacji, zobacz Omówienie okienka akcji.

• Rozszerzanie standardowego lub niestandardowego formularza programu Microsoft Office Outlook. Aby uzyskać więcej informacji, zobacz Przewodnik: projektowanie regionu formularza programu Outlook.

Powiązana zawartość

• Uzyskiwanie dostępu do wstążki w czasie wykonywania
• Omówienie wstążki
• Projektant wstążki
• Dostosowywanie wstążki dla programu Outlook
• Instrukcje: rozpoczynanie dostosowywania wstążki
• Instrukcje: zmienianie położenia karty na wstążce
• Instrukcje: dostosowywanie wbudowanej karty
• Instrukcje: dodawanie kontrolek do widoku backstage
• Omówienie modelu obiektów wstążki