Udostępnij przez


RibbonCheckBox Interfejs

Definicja

Reprezentuje kontrolkę pola wyboru na wstążce.

public interface class RibbonCheckBox : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")]
public interface RibbonCheckBox : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")>]
type RibbonCheckBox = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonCheckBox
Implements IComponent, IDisposable, RibbonControl
Atrybuty
Implementuje

Uwagi

Możesz utworzyć wystąpienie tej kontrolki w czasie wykonywania i dodać je do menu dynamicznego. Menu jest dynamiczne, jeśli ustawisz jego Dynamic właściwość na true.

Niektóre właściwości tej kontrolki można ustawić tylko przed załadowaniem wstążki do aplikacji pakietu Office lub przed dodaniu kontrolki do menu dynamicznego w czasie wykonywania. Aby uzyskać informacje na temat ustawiania tych właściwości, zobacz Temat Omówienie modelu obiektów wstążki.

Obiekt można utworzyć RibbonCheckBox w czasie wykonywania przy użyciu CreateRibbonCheckBox 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 jest to RibbonCheckBox zaznaczone.

Description

Pobiera lub ustawia opis tego RibbonCheckBox elementu, który pojawia się, gdy właściwość kontrolki nadrzędnej jest ustawiona ItemSize na RibbonControlSizeLargewartość .

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)
KeyTip

Pobiera lub ustawia skrót klawiaturowy dla tego RibbonCheckBox.

Label

Pobiera lub ustawia tekst wyświetlany w tym RibbonCheckBoxobiekcie .

Name

Pobiera lub ustawia nazwę tego RibbonComponentelementu .

(Odziedziczone po RibbonComponent)
Parent

Pobiera element RibbonComponent reprezentujący element nadrzędny tego RibbonComponentobiektu .

(Odziedziczone po RibbonComponent)
Position

Pobiera lub ustawia położenie pola wyboru, jeśli pole wyboru 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 porad, który pojawia się, gdy użytkownik przenosi wskaźnik na RibbonCheckBox.

SuperTip

Pobiera lub ustawia tekst wielowierszowej porady, który pojawia się, gdy użytkownik przesuwa wskaźnik nad RibbonCheckBox.

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

Click

Występuje, gdy użytkownik kliknie to pole wyboru.

Dotyczy