RibbonToggleButton Interfejs

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Ribbon

Zestaw:

Microsoft.Office.Tools.Common.dll

Reprezentuje kontrolkę przycisku przełącznika na wstążce.

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

[System.Runtime.InteropServices.Guid("fc50977f-187c-4082-ab53-087e81f4ded1")]
public interface RibbonToggleButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("fc50977f-187c-4082-ab53-087e81f4ded1")>]
type RibbonToggleButton = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonToggleButton
Implements IComponent, IDisposable, RibbonControl

Atrybuty

GuidAttribute

Implementuje

RibbonComponent RibbonControl IComponent IDisposable

Uwagi

Element RibbonToggleButton może służyć do pokazywania, czy element jest zaznaczony.

Można utworzyć obiekt RibbonToggleButton w czasie wykonywania przy użyciu CreateRibbonToggleButton 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

Checked	Pobiera lub ustawia wartość wskazującą, czy przycisk przełącznika jest naciskany, czy też nie jest naciśnięty.
ControlSize	Pobiera lub ustawia rozmiar kontrolki RibbonToggleButton .
Description	Pobiera lub ustawia tekst wyświetlany w tej RibbonToggleButton kontrolce w menu.
Enabled	Pobiera lub ustawia wartość wskazującą, czy jest włączona RibbonControl . (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 procedurze LoadImage obsługi zdarzeń, aby zidentyfikować obraz kontrolki.
KeyTip	Pobiera lub ustawia skrót klawiaturowy przycisku przełącznika.
Label	Pobiera lub ustawia tekst na przycisku przełącznika.
Name	Pobiera lub ustawia nazwę tego RibbonComponentelementu . (Odziedziczone po RibbonComponent)
OfficeImageId	Pobiera lub ustawia obraz do wyświetlenia na obiekcie RibbonToggleButton, jeśli chcesz użyć wbudowanej ikony pakietu Microsoft Office.
Parent	Pobiera element RibbonComponent reprezentujący element nadrzędny tego RibbonComponentelementu . (Odziedziczone po RibbonComponent)
Position	Pobiera lub ustawia położenie kontrolki RibbonToggleButton, 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 dostarczone 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 nad przyciskiem przełącznika.
ShowImage	Pobiera lub ustawia wartość wskazującą, czy obraz skojarzony z elementem RibbonToggleButton jest widoczny.
ShowLabel	Pobiera lub ustawia wartość wskazującą, czy etykieta dla elementu jest widoczna RibbonToggleButton .
SuperTip	Pobiera lub ustawia tekst wielowierszowej końcówki, który pojawia się, gdy użytkownik przenosi wskaźnik nad kontrolką RibbonToggleButton .
Tag	Pobiera lub ustawia dane specyficzne dla aplikacji skojarzone z tym RibbonComponentplikiem . (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 element nadrzędny ma dynamiczny element nadrzędny, taki jak menu dynamiczne, i układ nie jest zawieszony. (Odziedziczone po RibbonComponent)
PerformLayout()	Wywołuje metodę Microsoft.Office.Core.IRibbonUI.InvalidateControl, jeśli element RibbonComponent 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ę RibbonToggleButton .