RibbonButton.ControlSize-Eigenschaft (2007 System)

Artikel
08/23/2008

Aktualisiert: November 2007

Ruft die Größe der Schaltfläche ab oder legt sie fest.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Syntax

Public Property ControlSize As RibbonControlSize

Dim instance As RibbonButton
Dim value As RibbonControlSize

value = instance.ControlSize

instance.ControlSize = value

public RibbonControlSize ControlSize { get; set; }

Eigenschaftenwert

Typ: Microsoft.Office.Core.RibbonControlSize

Eine Microsoft.Office.Core.RibbonControlSize, die die Größe der Schaltfläche darstellt.

Hinweise

Diese Eigenschaft besitzt keine Auswirkung, falls die Schaltfläche Teil eines Menüs ist. Eine Schaltfläche, die Teil eines Menüs ist, wird immer so angezeigt, als ob die ControlSize-Eigenschaft auf den Wert der ItemSize-Eigenschaft des übergeordneten Menüs festgelegt ist. Wenn Sie Schaltflächen in einem Menü vergrößert anzeigen möchten, legen Sie die ItemSize-Eigenschaft von RibbonMenu auf Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge fest.

Beispiele

Im folgenden Beispiel wird eine Schaltfläche vergrößert angezeigt. Zum Ausführen dieses Codebeispiels müssen zuerst die folgenden Schritte ausgeführt werden:

Fügen Sie einem Visual Studio Tools for Office-Projekt ein Element von Multifunktionsleiste (Visual Designer) hinzu.
Fügen Sie der benutzerdefinierten Registerkarte eine Gruppe hinzu.
Fügen Sie der Gruppe eine Schaltfläche hinzu.

Private Sub SetButtonProperties()
    Button1.ControlSize = _
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge
    button1.Description = "My Ribbon Button"
End Sub

private void SetButtonProperties()
{
    button1.ControlSize = 
        Microsoft.Office.Core.RibbonControlSize.RibbonControlSizeLarge;
    button1.Description = "My Ribbon Button";
}

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.