BinaryRibbonButton

Use it for any one-click command on a ribbon – Paste, New Invoice, Send, Print. It is an ordinary WPF Button, so Click, Command and CommandParameter work exactly as they do anywhere else.

Pictures and caption

Give it a 32 x 32 LargeImage and a 16 x 16 SmallImage, and put the caption in ContentControl.Content. Large, the button shows the large picture over a caption split across two lines at the space nearest its middle; medium, the small picture with the caption beside it; small, the small picture alone. With no small picture the large one is drawn scaled down in its place, and with no picture at all the caption is centred on the button.

Size

The size is the attached BinaryRibbonBarPanel.SizeProperty, which the BinaryRibbonGroup holding the button sets as the window widens and narrows. Limit it with BinaryRibbonBarPanel.MaxSizeProperty and BinaryRibbonBarPanel.MinSizeProperty, or give the exact size for each step of shrinking with BinaryRibbonBarPanel.ResizableSizeProperty. At BinaryRibbonControlSize.Minimized the button is hidden, because its group has folded into a single drop-down.

Keyboard

Set the attached BinaryKeyTip.AccessKeyProperty and, inside a BinaryRibbonWindow, the button shows that letter when the user presses Alt or F10; typing it focuses the button and clicks it.

Appearance

The border and fill come from the skin in force (BinaryRibbonBuiltInSkinController.Skin), through the BinaryRibbonThemeResources.HighlightedBorderBrushKey and BinaryRibbonThemeResources.RibbonButtonGroupBackgroundBrushKey resources; setting Control.BorderBrush or Control.Background on one button overrides them for that button.

A Clipboard group with a large Paste button and three medium buttons beside it, in a ribbon window. The images are resources in the application.

<ribbon:BinaryRibbonWindow x:Class="Invoicing.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:ribbon="clr-namespace:Binarymission.WPF.Controls.Office;assembly=Binarymission.WPF.Controls.BinaryRibbon"
        Title="Invoicing" Width="1000" Height="640">
    <DockPanel>
        <ribbon:BinaryRibbonBarPanel DockPanel.Dock="Top">
            <ribbon:BinaryRibbonTabItem HeaderText="Home">
                <ribbon:BinaryRibbonGroup TitleText="Clipboard">
                    <ribbon:BinaryRibbonButton Content="Paste"
                                               LargeImage="Images/Paste32.png"
                                               SmallImage="Images/Paste16.png"
                                               ribbon:BinaryKeyTip.AccessKey="V"
                                               Command="ApplicationCommands.Paste" />
                    <ribbon:BinaryRibbonButton Content="Cut" SmallImage="Images/Cut16.png"
                                               ribbon:BinaryRibbonBarPanel.MaxSize="Medium"
                                               ribbon:BinaryKeyTip.AccessKey="X"
                                               Command="ApplicationCommands.Cut" />
                    <ribbon:BinaryRibbonButton Content="Copy" SmallImage="Images/Copy16.png"
                                               ribbon:BinaryRibbonBarPanel.MaxSize="Medium"
                                               ribbon:BinaryKeyTip.AccessKey="C"
                                               Command="ApplicationCommands.Copy" />
                    <ribbon:BinaryRibbonButton Content="Duplicate invoice" SmallImage="Images/Duplicate16.png"
                                               ribbon:BinaryRibbonBarPanel.MaxSize="Medium"
                                               Click="OnDuplicateInvoice" />
                </ribbon:BinaryRibbonGroup>
            </ribbon:BinaryRibbonTabItem>
        </ribbon:BinaryRibbonBarPanel>

        <ContentControl x:Name="invoiceView" />
    </DockPanel>
</ribbon:BinaryRibbonWindow>

The same button made in code and added to a group.

using System;
using System.Windows.Media.Imaging;
using Binarymission.WPF.Controls.Office;

BinaryRibbonButton newInvoice = new BinaryRibbonButton
{
    Content = "New Invoice",
    LargeImage = new BitmapImage(new Uri("pack://application:,,,/Images/NewInvoice32.png")),
    SmallImage = new BitmapImage(new Uri("pack://application:,,,/Images/NewInvoice16.png"))
};
BinaryKeyTip.SetAccessKey(newInvoice, "N");
newInvoice.Click += (sender, e) => invoices.CreateDraft();

invoiceGroup.Controls.Add(newInvoice);