RibbonButton.ControlSize-Eigenschaft

Artikel
08/10/2011

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

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

Syntax

'Declaration
Property ControlSize As RibbonControlSize
    Get
    Set

RibbonControlSize ControlSize { get; set; }

Eigenschaftswert

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 ein Menüband (Visual Designer)-Element zu einem Projekt hinzu, in dem Sie die Office-Entwicklungstools in Visual Studio verwenden.
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";
}

.NET Framework-Sicherheit

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.