Interfejs RibbonCheckBox

Artykuł
01/08/2014

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	Pobiera lub ustawia wartość wskazującą, czy to RibbonCheckBox jest sprawdzana.
	Description	Pobiera lub ustawia opis dla tej RibbonCheckBox który pojawia się, gdy jego formantu nadrzędnego ItemSize właściwość jest ustawiona na RibbonControlSizeLarge.
	Enabled	Pobiera lub ustawia wartość wskazującą, czy to RibbonControl jest włączona. (Odziedziczone z RibbonControl).
	Id	Pobiera ciąg, program Microsoft Office używa się do identyfikacji, to RibbonControl obiektu. (Odziedziczone z RibbonControl).
	KeyTip	Pobiera lub ustawia skrót klawiaturowy dla tej RibbonCheckBox.
	Label	Zwraca lub ustawia tekst pojawiający się na to RibbonCheckBox.
	Name	Pobiera lub ustawia nazwę tego RibbonComponent. (Odziedziczone z RibbonComponent).
	Parent	Pobiera RibbonComponent reprezentująca nadrzędny to RibbonComponent. (Odziedziczone z RibbonComponent).
	Position	Pobiera lub ustawia pozycję pole wyboru, jeśli pole wyboru w Menu programu Microsoft Office.
	Ribbon	Pobiera najwyższego poziomu Ribbon obiekt, który zawiera hierarchię kontroli. (Odziedziczone z RibbonComponent).
	RibbonUI	Infrastruktura. Pobiera IRibbonUI instancji, która jest dostarczana przez aplikacji Microsoft Office do kodu rozszerzalność wstążki. (Odziedziczone z RibbonComponent).
	ScreenTip	Zwraca lub ustawia tekst porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad RibbonCheckBox.
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	SuperTip	Zwraca lub ustawia tekst wielowierszowy porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad RibbonCheckBox.
	Tag	Pobiera lub ustawia dane specyficzne dla aplikacji, która jest skojarzona z tym RibbonComponent. (Odziedziczone z RibbonComponent).
	Visible	Pobiera lub ustawia wartość wskazującą, czy to RibbonControl jest widoczny. (Odziedziczone z RibbonControl).

Początek

Metody

	Nazwa	Opis
	Dispose	Wykonuje zadania zdefiniowane przez aplikację skojarzone z uwalnianiem, zwalnianiem lub resetowaniem 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()	Cofa efekt SuspendLayout metody. (Odziedziczone z RibbonComponent).
	ResumeLayout(Boolean)	Cofa efekt SuspendLayout metody. (Odziedziczone z RibbonComponent).
	SuspendLayout	Zapobiega aplikacji Microsoft Office odświeżania stanu 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ąpienie tego formantu w czasie wykonywania i dodać go do menu dynamiczne.Menu jest dynamiczne, decydując się na jego Dynamic właściwość, aby true.

Niektóre właściwości tego formantu można ustawić tylko przed Wstążka jest ładowany 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 Model obiektu Wstążka ― Omówienie.

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żyj tego podejścia do kodu w klasie wstążki.
Za pomocą Globals.Factory.GetRibbonFactory metody.Użyj tego podejścia do 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 for Office Runtime ― Przegląd.

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.