Okienko akcji ― Omówienie

Artykuł
06/10/2015

W okienku akcji jest konfigurowalny Akcje dokumentu okienko zadań, który jest dołączony do określonego dokumentu programu Microsoft Office Word lub skoroszytu programu Microsoft Office Excel.Jest obsługiwany w ramach okienko zadań pakietu Office oraz inne okienka zadań wbudowanych takich jak Źródło XML okienko zadań w programie Excel lub Style i formatowanie okienko zadań w programie Word.Windows Forms formantów lub formanty WPF można użyć do projektowania interfejsu użytkownika w okienku akcji.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu dla następujących aplikacji: Excel 2013 i Excel 2010; Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

W okienku akcji można utworzyć tylko w przypadku dostosowywania poziomie dokumentu dla programu Word lub Excel.Nie można utworzyć w okienku Akcje w poziomie aplikacji dodatek.Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

[!UWAGA]

W okienku Akcje różni się od niestandardowych okienek zadań.Niestandardowe okienka zadań są skojarzone z aplikacją, a nie konkretnego dokumentu.Można utworzyć niestandardowe okienka zadań w poziomie aplikacji dodatków niektórych aplikacji pakietu Microsoft Office.Aby uzyskać więcej informacji, zobacz Niestandardowe okienka zadań.

łącze do wideo Aby wyświetlić pokrewne wideo demonstracyjne, zobacz jak zrobić I: użycia WPF formantów wewnątrz programu Excel okienku Akcje?.

Wyświetlanie okienka akcji

W okienku akcji jest reprezentowana przez ActionsPane klasy.Podczas tworzenia projektu na poziomie dokumentu, wystąpienie tej klasy jest dostępne w kodzie za pomocą ActionsPane pole ThisWorkbook (dla programu Excel) lub ThisDocument (dla programu Word) klasy do projektu.Aby wyświetlić okienko akcji, należy dodać formant Windows Forms do Controls właściwość ActionsPane pole.Poniższy przykład kodu dodaje formant o nazwie actions do okienka akcji.

Me.ActionsPane.Controls.Add(actions)

this.ActionsPane.Controls.Add(actions);

W okienku Akcje staje się widoczny w czasie wykonywania, jak tylko jawnie dodać formant do niego.Po wyświetleniu w okienku akcji można dynamicznie Dodawanie lub usuwanie formantów w odpowiedzi na akcje użytkownika.Zazwyczaj, Dodaj kod, aby wyświetlić okienko akcji w Startup obsługi zdarzeń z ThisDocument lub ThisWorkbook tak aby był widoczny w okienku Akcje kiedy użytkownik po raz pierwszy otwiera dokument.Jednakże można wyświetlić w okienku akcji tylko w odpowiedzi na działania użytkownika w dokumencie.Na przykład, może dodać kod do Click zdarzenia dla formantu na dokument.

Dodawanie wielu formantów w okienku akcji

Dodawania wielu formantów w okienku Akcje, w większości przypadków należy grupy formantów w formancie użytkownika i następnie dodać formant użytkownika do Controls właściwość.Proces ten obejmuje następujące kroki:

Tworzenie interfejsu użytkownika (UI) w okienku akcji przez dodanie Formant okienka Akcje lub Kontrola użytkownika element do projektu.Oba te elementy obejmują niestandardowe Windows Forms UserControl klasy.Formant okienka Akcje i Kontrola użytkownika elementy są równoważne; Jedyną różnicą jest ich nazwa.
Dodać formanty Windows Forms UserControl przy użyciu projektanta lub pisanie kodu.

[!UWAGA]

Formanty WPF można dodać do okienka akcji, dodając WPF UserControl do Windows Forms UserControl.Aby uzyskać więcej informacji, zobacz Korzystanie z formantów WPF w rozwiązaniach pakietu Office.
Dodaj wystąpienia formantu użytkownika niestandardowych formantów, które są zawarte w ActionsPane pole ThisWorkbook (dla programu Excel) lub ThisDocument (dla programu Word) klasy do projektu.

Zobacz przykłady, które wskazują ten proces bardziej szczegółowo, Porady: dodawanie okienek akcji do dokumentów programu Word lub arkuszy programu Excel.

Ukrywanie okienka Akcje

Chociaż ActionsPane klasa ma Hide metoda i Visible właściwość, nie możesz usunąć w okienku Akcje z interfejsu użytkownika przy użyciu wszystkich członków ActionsPane się klasa.Wywołanie Hide ustawienie lub metoda Visible właściwość, aby false ukrywa tylko formantów w okienku akcji; nie powoduje ukrycia okienko zadań.

Aby ukryć okienko zadań w swoje rozwiązanie, istnieje kilka możliwości:

Dla programu Word, należy ustawić Visible właściwość TaskPane obiekt, który reprezentuje okienko zadań Akcje dokumentu do false.Poniższy przykład kodu jest przeznaczony do uruchomienia z ThisDocument klasy do projektu.
```
Me.Application.TaskPanes(Word.WdTaskPanes.wdTaskPaneDocumentActions).Visible = False
```
```
this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;
```
Dla programu Excel, zestaw DisplayDocumentActionTaskPane właściwość Application obiekt do false.Poniższy przykład kodu jest przeznaczony do uruchomienia z ThisWorkbook klasy do projektu.
```
Me.Application.DisplayDocumentActionTaskPane = False
```
```
this.Application.DisplayDocumentActionTaskPane = false;
```
Dla programu Word lub Excel, można również ustawić CommandBar.Visible właściwość paska poleceń, który reprezentuje okienko zadań do false.Poniższy przykład kodu jest przeznaczony do uruchomienia z ThisDocument lub ThisWorkbook klasy do projektu.
```
Me.Application.CommandBars("Task Pane").Visible = False
```
```
this.Application.CommandBars["Task Pane"].Visible = false;
```

Czyszczenie podczas dokumentu dla okienka Akcje jest otwarty.

Jeśli użytkownik zapisuje dokument, podczas gdy w okienku akcji jest widoczny, w okienku akcji jest widoczny za każdym razem, gdy dokument jest otwarty, czy okienko akcji zawiera wszelkie kontrole.Jeśli chcesz kontrolować pojawiają się, zadzwoń Clear metoda ActionsPane w Startup obsługi zdarzeń z ThisDocument lub ThisWorkbook do zapewnienia, że w okienku akcji nie jest widoczne, gdy dokument jest otwarty.

Okienko akcji podczas określania jest zamknięty.

Nie ma żadnych zdarzenie jest wywoływane, gdy w okienku akcji jest zamknięty.Chociaż ActionsPane klasa ma VisibleChanged zdarzenie, to zdarzenie nie jest wywoływane, gdy użytkownik zamyka okienko akcji.Zamiast tego, to zdarzenie jest wywoływane, gdy formantów w okienku Akcje są ukryte przez wywołanie Hide metoda lub przez ustawienie Visible właściwość, aby false.

Jeśli użytkownik zamyka okienko akcji, użytkownika można wyświetlić go ponownie, wykonując jedną z następujących procedur w interfejsie użytkownika (UI) aplikacji.

Aby wyświetlić okienko akcji za pomocą interfejsu użytkownika programu Word lub Excel

Kliknij na Wstążce, Widok kartę.
W Pokaż/Ukryj grupy, kliknij przycisk Akcje dokumentu przycisk przełącznika.

Programowanie zdarzenia w okienku akcji

Można dodać wiele formantów użytkownika do okienka akcji, a następnie wpisz kod, który odpowiada na zdarzenia występujące w dokumencie przez pokazywanie i ukrywanie formantów użytkownika.Jeśli mapowania elementów schematu XML do dokumentu, można wyświetlić niektórych formantów użytkownika w okienku Akcje zawsze, gdy punkt wstawiania znajduje się wewnątrz jednego z elementów XML.Aby uzyskać więcej informacji, zobacz Porady: mapowanie schematów z dokumentami programu Word w programie Visual Studio i Porady: mapowanie schematów z arkuszami w programie Visual Studio.

Można także napisać kod, aby reagować na zdarzenia dowolnego obiektu, w tym kontroli hosta, aplikacji lub zdarzenia dokumentu.Aby uzyskać więcej informacji, zobacz Wskazówki: programowanie w odniesieniu do zdarzeń formantu NamedRange.

Wiązanie danych do formantów w okienku Akcje

Formantów w okienku Akcje mają takie same możliwości powiązania danych jako formanty na Windows Forms.Można powiązać formantów źródeł danych, takich jak zestawy danych, zestawów danych wpisywanych i XML.Aby uzyskać więcej informacji, zobacz Wiązanie danych i formularze systemu Windows.

Ten sam zestaw danych można powiązać formantów w okienku Akcje i formantów w dokumencie.Na przykład można utworzyć relacji wzorzec/szczegół między formantów w okienku Akcje i formantów w arkuszu.Aby uzyskać więcej informacji, zobacz Wskazówki: wiązanie danych do kontrolek okienku akcji programu Excel.

Sprawdzanie poprawności danych w formantach w okienku akcji

Po wyświetleniu okna komunikatu w Validating obsługi zdarzenia formantu w okienku Akcje, zdarzenia może być podniesiony drugi raz, kiedy fokus jest przenoszony z formantu w oknie komunikatu.Aby zapobiec występowaniu tego problemu, należy użyć ErrorProvider formantu, aby wyświetlić komunikaty o błędach sprawdzania poprawności.

Kolejność układania formant użytkownika

Jeśli używasz wielu formantów użytkownika, można napisać kod poprawnie stos formantów użytkownika w okienku Akcje, czy jest on zadokowany pionowo lub poziomo.Kolejność ułożenia formantów użytkownika w okienku akcji można ustawić przy użyciu StackStyle wyliczenie z StackOrder właściwość.Aby uzyskać więcej informacji, zobacz Porady: zarządzanie układem formantu w okienkach akcji.

StackOrder Właściwość może przyjmować następujące StackStyle wartości wyliczenia.

Styl układania	Definicja
FromBottom	Stos z dolnej części okienka akcji.
FromLeft	Stos z lewej strony okienka akcji.
FromRight	Stos z prawej strony w okienku akcji.
FromTop	Stos z górnej części okienka akcji.
None	Nie kolejności zdefiniowane; zamówienie jest kontrolowana przez autora.

Następujący kod dodaje zestawy StackOrder właściwość do stosu formantów użytkownika z górnej części okienka akcji.

Me.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop

this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;

Kotwiczenie formantów

Jeśli użytkownik zmienia rozmiar okienka akcji w czasie wykonywania, z okienka akcji można zmienić rozmiar formantów.Można użyć Anchor właściwości formantu Windows Forms do kotwicy formantów w okienku akcji.Formantów Windows Forms na formant użytkownika mogą być również kotwicy w taki sam sposób.Aby uzyskać więcej informacji, zobacz Porady: kotwiczenie formantów na formularzach systemu Windows.

Zmienianie rozmiaru okienka Akcje

Nie można bezpośrednio zmienić rozmiar ActionsPane bo ActionsPane jest osadzony w okienko zadań.Jednakże można zmienić programistycznie szerokość okienko zadań przez ustawienie Width właściwość CommandBar , oznaczającą okienko zadań.Jeśli jest zadokowany poziomo lub jest ruchomy, można zmienić wysokość okienko zadań.

Programowe zmienianie rozmiaru okienko zadań ogólnie nie jest zalecane, ponieważ użytkownik powinien być w stanie wybrać rozmiar okienko zadań, który najlepiej odpowiada jego potrzeb.Jednak jeśli należy zmienić rozmiar szerokość okienko zadań, można użyć następującego kodu do wykonania tego zadania.

Me.CommandBars("Task Pane").Width = 200

this.CommandBars["Task Pane"].Width = 200;

Zmiana pozycji w okienku akcji

Nie można bezpośrednio zmienić położenie ActionsPane ponieważ jest osadzony w okienko zadań.Jednak można programowo przenieść okienko zadań ustawienie, Position właściwość CommandBar , oznaczającą okienko zadań.

Programowo położenia okienko zadań ogólnie nie jest zalecane, ponieważ użytkownik powinny mieć możliwość wyboru pozycji okienko zadań na ekranie, który najlepiej odpowiada jego potrzeb.Jednakże jeśli okienko zadań należy przenieść do określonej pozycji, można użyć następującego kodu do wykonania tego zadania.

Me.CommandBars("Task Pane").Position = _
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft

this.CommandBars["Task Pane"].Position =
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft;

[!UWAGA]

Użytkownicy końcowi można ręcznie zmienić położenie okienko zadań w dowolnym momencie.Nie istnieje żadne sposobem zapewnienia, że okienko zadań pozostanie zadokowane w stanie wskazać w sposób programowy.Można jednak, sprawdź, czy zmiany orientacji i zapewnienia, że formantów w okienku Akcje są ułożone w odpowiednim kierunku.Aby uzyskać więcej informacji, zobacz Porady: zarządzanie układem formantu w okienkach akcji.

Ustawienie Top i Left właściwości ActionsPane nie powoduje zmiany położenia ActionsPane obiekt jest osadzony w okienko zadań.

Jeśli okienko zadań nie jest zadokowany, można ustawić Top i Left właściwości CommandBar , oznaczającą okienko zadań.Następujący kod przenosi niezadokowany okienko zadań w lewym górnym rogu dokumentu.

If Me.CommandBars("Task Pane").Position = _
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating Then 

    Me.CommandBars("Task Pane").Top = 0
    Me.CommandBars("Task Pane").Left = 0

End If

if (this.CommandBars["Task Pane"].Position == 
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}

Zobacz też

Udostępnij za pośrednictwem