RibbonDropDown Interfejs

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Ribbon

Zestaw:

Microsoft.Office.Tools.Common.dll

Reprezentuje listę elementów, które użytkownik może wybrać, oraz listę przycisków wstążki, które użytkownik może kliknąć.

public interface class RibbonDropDown : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl

Atrybuty

GuidAttribute

Implementuje

RibbonComponent RibbonControl IComponent IDisposable

Uwagi

Obiekt RibbonDropDown może zawierać RibbonDropDownItem obiekty i RibbonButton kontrolki.

Obiekt można utworzyć RibbonDropDown w czasie wykonywania przy użyciu CreateRibbonDropDown 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.

Nie można dodawać przycisków do Buttons kolekcji w czasie wykonywania po załadowaniu wstążki do pakietu Office.

Poniższe procedury wyjaśniają sposób dodawania RibbonDropDownItem obiektów i RibbonButton kontrolek do obiektu RibbonDropDown.

Dodawanie obiektów RibbonDropDownItem w czasie projektowania

1. Kliknij właściwość Items w oknie Właściwości .

2. Kliknij wielokropek (...).

3. W Redaktor Kolekcji rozwijanej dodaj, porządkuj i edytuj nowe elementy.

Kontrolki można dodawać RibbonButton do RibbonDropDown elementu w czasie projektowania.

Dodawanie formantów RibbonButton w czasie projektowania

1. Kliknij właściwość Buttons w oknie Właściwości .

2. Kliknij wielokropek (...).

3. W Redaktor kolekcji przycisków dodaj, porządkuj i edytuj nowe kontrolki przycisków.

Niektóre elementy członkowskie tego typu można ustawić tylko przed załadowaniem wstążki do aplikacji pakietu Office. Aby uzyskać informacje na temat ustawiania tych właściwości, zobacz Temat Omówienie modelu obiektów 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

Buttons	Pobiera kolekcję obiektów należących RibbonButton do tego RibbonDropDownobiektu .
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 na tym RibbonDropDownobiekcie .
ImageName	Pobiera lub ustawia nazwę, której można użyć w procedurze LoadImage obsługi zdarzeń, aby zidentyfikować obraz kontrolki.
Items	Pobiera kolekcję elementów w tym RibbonDropDownobiekcie .
KeyTip	Pobiera lub ustawia skrót klawiaturowy dla tego RibbonDropDown.
Label	Pobiera lub ustawia tekst wyświetlany w tym RibbonDropDownobiekcie .
Name	Pobiera lub ustawia nazwę tego RibbonComponentelementu . (Odziedziczone po RibbonComponent)
OfficeImageId	Pobiera lub ustawia obraz do wyświetlenia na RibbonDropDownobiekcie , jeśli chcesz użyć wbudowanej ikony pakietu Microsoft Office.
Parent	Pobiera element RibbonComponent reprezentujący element nadrzędny tego RibbonComponentobiektu . (Odziedziczone po RibbonComponent)
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 porad, który pojawia się, gdy użytkownik przenosi wskaźnik na RibbonDropDown.
SelectedItem	Pobiera lub ustawia RibbonDropDownItem aktualnie wybrane.
SelectedItemIndex	Pobiera lub ustawia indeks aktualnie wybranego RibbonDropDownItemelementu .
ShowImage	Pobiera lub ustawia wartość wskazującą, czy obraz skojarzony z elementem RibbonDropDown jest widoczny.
ShowItemImage	Pobiera lub ustawia wartość wskazującą, czy obrazy są wyświetlane dla elementów w menu rozwijanym.
ShowItemLabel	Pobiera lub ustawia wartość wskazującą, czy etykiety są wyświetlane dla elementów w menu rozwijanym.
ShowLabel	Pobiera lub ustawia wartość wskazującą, czy etykieta dla tego RibbonDropDown elementu jest widoczna.
SizeString	Pobiera lub ustawia ciąg, który określa rozmiar obiektu RibbonDropDown.
SuperTip	Pobiera lub ustawia tekst wielowierszowej porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad RibbonDropDown.
Tag	Pobiera lub ustawia dane specyficzne dla aplikacji, które są skojarzone z tym RibbonComponent. (Odziedziczone po RibbonComponent)
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

ButtonClick	Występuje, gdy użytkownik kliknie przycisk na RibbonDropDown.
ItemsLoading	Występuje, gdy kontrolki są ładowane do .RibbonDropDown
SelectionChanged	Występuje, gdy użytkownik wybiera nowy element na kontrolce listy rozwijanej wstążki.