Interfejs RibbonCheckBox

Artykuł
05/08/2013

Reprezentuje pole wyboru formantu na Wstążce.

Przestrzeń nazw: Microsoft.Office.Tools.Ribbon
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)

Składnia

'Deklaracja
<GuidAttribute("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")> _
Public Interface RibbonCheckBox _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")]
public interface RibbonCheckBox : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Typ RibbonCheckBox uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	Checked	Zwraca lub ustawia wartość, która wskazuje, czy to RibbonCheckBox jest sprawdzana.
	Description	Pobiera lub ustawia opis do tego RibbonCheckBox który pojawia się, gdy w formancie nadrzędnym ItemSize właściwość jest ustawiona na RibbonControlSizeLarge.
	Enabled	Zwraca lub ustawia wartość, która wskazuje, czy to RibbonControl jest włączone. (Odziedziczone z RibbonControl).
	Id	Pobiera ciąg, który używa programu Microsoft Office, aby określić to RibbonControl obiektu. (Odziedziczone z RibbonControl).
	KeyTip	Pobiera lub ustawia skrót klawiaturowy do tego RibbonCheckBox.
	Label	Pobiera lub ustawia tekst pojawiający się na tym RibbonCheckBox.
	Name	Pobiera lub ustawia nazwę tego RibbonComponent. (Odziedziczone z RibbonComponent).
	Parent	Pobiera RibbonComponent , oznaczającą nadrzędny to RibbonComponent. (Odziedziczone z RibbonComponent).
	Position	Pobiera lub ustawia pozycję pola wyboru, jeśli pole wyboru znajduje się w Menu programu Microsoft Office.
	Ribbon	Pobiera najwyższego poziomu Ribbon obiekt, który zawiera hierarchii kontrolek. (Odziedziczone z RibbonComponent).
	RibbonUI	Infrastruktura. Pobiera IRibbonUI instancji, która jest dostarczonej wraz z aplikacją Microsoft Office do kodu rozszerzalność wstążki. (Odziedziczone z RibbonComponent).
	ScreenTip	Pobiera lub ustawia tekst porady, który pojawia się, gdy użytkownik przesuwa wskaźnik myszy nad RibbonCheckBox.
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	SuperTip	Pobiera lub ustawia tekst wielowierszowy porady, który pojawia się, gdy użytkownik przesuwa wskaźnik myszy nad RibbonCheckBox.
	Tag	Pobiera lub ustawia dane specyficzne dla aplikacji, która jest skojarzona z tym RibbonComponent. (Odziedziczone z RibbonComponent).
	Visible	Zwraca lub ustawia wartość, która wskazuje, czy to RibbonControl jest widoczny. (Odziedziczone z RibbonControl).

Początek

Metody

	Nazwa	Opis
	Dispose	Wykonuje zadania zdefiniowane aplikacji skojarzonej z zwalniania, zwalnianie lub resetowanie niezarządzanych zasobów. (Odziedziczone z IDisposable).
	PerformDynamicLayout	Wywołania Microsoft.Office.Core.IRibbonUI.InvalidateControl metoda nadrzędnego kontroli, jeśli RibbonComponent ma element nadrzędny dynamicznych, takich jak menu dynamiczne, i układ nie jest zawieszony. (Odziedziczone z RibbonComponent).
	PerformLayout	Wywołania Microsoft.Office.Core.IRibbonUI.InvalidateControl Jeśli RibbonComponent ma element nadrzędny i układ nie jest zawieszony. (Odziedziczone z RibbonComponent).
	ResumeLayout()	Odwraca efekt SuspendLayout metoda. (Odziedziczone z RibbonComponent).
	ResumeLayout(Boolean)	Odwraca efekt SuspendLayout metoda. (Odziedziczone z RibbonComponent).
	SuspendLayout	Zapobiega zastosowaniu programu Microsoft Office z odświeżanie stan formantów na Wstążce. (Odziedziczone z RibbonComponent).

Początek

Zdarzenia

	Nazwa	Opis
	Click	Występuje, gdy użytkownik kliknie pole wyboru.
	Disposed	Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent).

Początek

Uwagi

Można utworzyć wystąpienia tego formantu w czasie wykonywania i dodać do menu dynamiczne.Menu jest dynamiczne, jeśli ustawisz jego Dynamic właściwość, aby true.

Niektóre właściwości tego formantu można ustawić, tylko w przypadku, przed załadowaniem wstążki do aplikacji pakietu Office lub zanim formant zostanie dodane do menu dynamiczne w czasie wykonywania.Aby uzyskać informacje o ustawianiu tych właściwości, zobacz Omówienie modelu obiektu wstążki.

Można utworzyć RibbonCheckBox w czasie wykonywania za pomocą CreateRibbonCheckBox metoda RibbonFactory obiektu.

Istnieją dwa sposoby dostępu do RibbonFactory obiekt:

Za pomocą Factory właściwość klasy wstążki.Użyć tej metody z kodu w klasie wstążki.
Za pomocą Globals.Factory.GetRibbonFactory metoda.Użyj tego podejścia od kodu poza klasy wstążki.

[!UWAGA]

Ten interfejs jest implementowany przez Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz Visual Studio Tools dla pakietu Office, omówienie Runtime.

Użycie

W dokumentacji opisano wersję typu używanego w projektach dla pakietu Office przeznaczonych do pracy z programem .NET Framework 4 i .NET Framework 4.5. 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ę tego typu używanego w projektach przeznaczonych do działania z programem .NET Framework 3.5, zobacz następującą sekcję informacyjną w dokumentacji programu Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.