RibbonSplitButton Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Kontrolka wstążki, która łączy przycisk lub przycisk przełącznika i menu rozwijane.
public interface class RibbonSplitButton : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")>]
type RibbonSplitButton = interface
interface RibbonControl
interface RibbonComponent
interface IComponent
interface IDisposable
Public Interface RibbonSplitButton
Implements IComponent, IDisposable, RibbonControl
- Atrybuty
- Implementuje
Uwagi
Kontrolka RibbonSplitButton łączy przycisk lub przycisk przełącznika i menu rozwijane. Aby wybrać przycisk i przycisk przełącznika ButtonType , użyj właściwości .
W przeciwieństwie do kontrolki RibbonMenu kontrolka RibbonSplitButton nie ma Dynamic właściwości , więc nie można zmienić zawartości Items kolekcji w czasie wykonywania.
Obiekt można utworzyć RibbonSplitButton w czasie wykonywania przy użyciu CreateRibbonSplitButton metody RibbonFactory obiektu .
Istnieją dwa sposoby uzyskiwania RibbonFactory dostępu do obiektu:
Za pomocą
Factory
właściwości klasy Wstążki. Użyj podejścia z kodu w klasie wstążki.Przy użyciu
Globals.Factory.GetRibbonFactory
metody . Użyj podejścia do kodu spoza klasy wstążki.
Uwaga
Ten interfejs jest wdrażany przy użyciu programu Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz omówienie środowiska uruchomieniowego Visual Studio Tools dla pakietu Office.
Użycie
W tej dokumentacji opisano wersję tego typu używaną tylko w projektach pakietu Office przeznaczonych dla platformy .NET Framework 4 i nowszych. W projektach przeznaczonych do pracy z programem .NET Framework 3.5 ten typ może mieć inne elementy członkowskie, a przykładowy kod podany dla tego typu może nie działać. Aby uzyskać dokumentację dotyczącą tego typu projektów przeznaczonych dla .NET Framework 3.5, zobacz następującą sekcję referencyjną w dokumentacji programu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.
Właściwości
ButtonEnabled |
Pobiera lub ustawia wartość wskazującą, czy przycisk na RibbonSplitButton obiekcie jest włączony. |
ButtonType |
Pobiera lub ustawia typ przycisku na .RibbonSplitButton |
Checked |
Pobiera lub ustawia wartość wskazującą, czy RibbonSplitButton jest naciśnięty, czy nie. |
ControlSize |
Pobiera lub ustawia rozmiar kontrolki RibbonSplitButton . |
Description |
Pobiera lub ustawia tekst wyświetlany w tej RibbonSplitButton kontrolce w menu rozwijanym. |
Enabled |
Pobiera lub ustawia wartość wskazującą, czy jest to RibbonControl włączone. (Odziedziczone po RibbonControl) |
Id |
Pobiera ciąg używany przez pakiet Microsoft Office do identyfikowania tego RibbonControl obiektu. (Odziedziczone po RibbonControl) |
Image |
Pobiera lub ustawia obraz wyświetlany w kontrolce. |
ImageName |
Pobiera lub ustawia nazwę, której można użyć w programie obsługi zdarzeń E:Microsoft.Office.Tools.Ribbon.LoadImage, aby zidentyfikować obraz kontrolki. |
Items |
Pobiera kolekcję kontrolek, które znajdują się w tym RibbonSplitButtonobiekcie . |
ItemSize |
Pobiera lub ustawia rozmiar kontrolek w RibbonSplitButton menu rozwijanym. |
KeyTip |
Pobiera lub ustawia skrót klawiaturowy kontrolki RibbonSplitButton . |
Label |
Pobiera lub ustawia tekst w kontrolce RibbonSplitButton . |
Name |
Pobiera lub ustawia nazwę tego RibbonComponentelementu . (Odziedziczone po RibbonComponent) |
OfficeImageId |
Pobiera lub ustawia obraz do wyświetlenia w kontrolce RibbonSplitButton , jeśli chcesz użyć wbudowanej ikony pakietu Microsoft Office. |
Parent |
Pobiera element RibbonComponent reprezentujący element nadrzędny tego RibbonComponentobiektu . (Odziedziczone po RibbonComponent) |
Position |
Pobiera lub ustawia pozycję kontrolki RibbonSplitButton , jeśli kontrolka znajduje się w menu pakietu Microsoft Office. |
Ribbon |
Pobiera obiekt najwyższego poziomu Ribbon zawierający hierarchię sterowania. (Odziedziczone po RibbonComponent) |
RibbonUI |
Pobiera wystąpienie IRibbonUI udostępniane przez aplikację pakietu Microsoft Office do kodu rozszerzalności wstążki. (Odziedziczone po RibbonComponent) |
ScreenTip |
Pobiera lub ustawia tekst etykietki narzędzia, który pojawia się, gdy użytkownik przenosi wskaźnik nad kontrolką RibbonSplitButton . |
ShowLabel |
Pobiera lub ustawia wartość wskazującą, czy etykieta kontrolki jest widoczna RibbonSplitButton . |
SuperTip |
Pobiera lub ustawia tekst wielowierszowej etykietki narzędzia, który pojawia się, gdy użytkownik przenosi wskaźnik nad kontrolką RibbonSplitButton . |
Tag |
Pobiera lub ustawia dane specyficzne dla aplikacji, które są skojarzone z tym RibbonComponent. (Odziedziczone po RibbonComponent) |
Title |
Pobiera lub ustawia tytuł wyświetlany w górnej RibbonSplitButton części kontrolki, jeśli kontrolka znajduje się w menu pakietu Microsoft Office. |
Visible |
Pobiera lub ustawia wartość wskazującą, czy jest ona RibbonControl widoczna. (Odziedziczone po RibbonControl) |
Metody
PerformDynamicLayout() |
Wywołuje metodę Microsoft.Office.Core.IRibbonUI.InvalidateControl kontrolki nadrzędnej, jeśli RibbonComponent obiekt ma dynamiczny element nadrzędny, taki jak menu dynamiczne, i układ nie jest zawieszony. (Odziedziczone po RibbonComponent) |
PerformLayout() |
Wywołuje element Microsoft.Office.Core.IRibbonUI.InvalidateControl, jeśli RibbonComponent obiekt ma element nadrzędny i układ nie jest zawieszony. (Odziedziczone po RibbonComponent) |
ResumeLayout() |
Odwraca efekt SuspendLayout() metody . (Odziedziczone po RibbonComponent) |
ResumeLayout(Boolean) |
Odwraca efekt SuspendLayout() metody . (Odziedziczone po RibbonComponent) |
SuspendLayout() |
Uniemożliwia aplikacji pakietu Microsoft Office odświeżanie stanu kontrolek na wstążce. (Odziedziczone po RibbonComponent) |
Zdarzenia
Click |
Występuje, gdy użytkownik kliknie kontrolkę RibbonSplitButton . |