WPF button textwrap style

Question

How do I change the default textwrapping style of a button in WPF?

The obvious solution of:

<Style x:Key="MyButtonStyle" TargetType="{x:Type Button}">
    <Setter Property="TextWrapping" Value="Wrap"></Setter>
</Style>

doesn't work, because Textwrapping isn't a settable property here, apparently.

If I try:

<Style x:Key="MyButtonStyle" TargetType="{x:Type Button}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type Button}">
                <TextBlock Text="{Binding}" Foreground="White" FontSize="20" FontFamily="Global User Interface" TextWrapping="Wrap"/>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

I just get a worthless response from the compiler:

Error   5   After a 'SetterBaseCollection' is in use (sealed), it cannot be modified.

Removing the ControlTemplate tag keeps the error.

The following attempt yields a different error:

    <Setter Property="TextBlock">
        <TextBlock Text="{Binding}" Foreground="White" FontSize="20" FontFamily="Global User Interface" TextWrapping="Wrap"/>
    </Setter>

Error   5   The type 'Setter' does not support direct content.

I see that I can set the textwrapping for each button individually, but that's pretty asinine. How can I do it as a style? What are the magic words?

And for future reference, where can I find a list of these magic words, so I can just do this on my own? The MSDN entry is pretty useless when I try to find out about which properties can be set by the setter.

score 69 · Answer 1 · answered Sep 19 '13 at 01:21

69

To expand Eric's answer with an example:-

<Button Name="btnName" Width="50" Height="40">
   <TextBlock Text="Some long text" TextWrapping="Wrap" TextAlignment="Center"/>
</Button>

answered Sep 19 '13 at 01:21

Rob

793
1
7
8

I didn't have a width and height on the button, instead I used MaxWidth on the text - limits the size and it wraps nicely! – imekon Mar 21 '18 at 16:03
2

Change `TextBlock` to `AccessText` if you want to be able to specify access keys (`Text="_Some long text"`). – fadden Mar 01 '20 at 22:31
Make sure to change the Height or Width of `Button` to Auto depending on winch way you want the `TextBlock` to expand the button to fit the text. – ojonasplima Mar 24 '23 at 14:18

score 49 · Answer 2 · edited Aug 30 '14 at 18:51

49

I solved this problem by adding a TextBlock to the button, and using it to display the button text instead of the button's Content property. Be sure to set the TextBlock's height property to Auto, so that it grows in height to accommodate the number of lines of text as it wraps.

edited Aug 30 '14 at 18:51

Danny Beckett

20,529
24
107
134

answered Dec 17 '10 at 01:08

Eric

726
6
6

6

This is definitely easier/cleaner than the accepted answer, but his way does work too. – John B Mar 29 '12 at 21:00
See the below answers for examples of the code needed. – Danny Beckett Aug 30 '14 at 18:51
Thank you SO much for mentioning the height=Auto.... – Lynn Crumbling Dec 17 '21 at 23:31

score 32 · Accepted Answer · answered Apr 15 '09 at 23:45

Your second version should work, and does for me, with the caveat that you need to change the TextBlock Text binding:

<!-- in Window.Resources -->
<Style x:Key="fie" TargetType="Button">
  <Setter Property="Template">
    <Setter.Value>
      <ControlTemplate TargetType="{x:Type Button}">
        <TextBlock Text="{TemplateBinding Content}" FontSize="20" TextWrapping="Wrap"/>
      </ControlTemplate>
    </Setter.Value>
  </Setter>
</Style>

<!-- then -->
<Button Style="{StaticResource fie}">verylongcaptiongoeshereandwraps/Button>

Note this completely replaces the button style (i.e. you will need to create your own button chrome if you want it).

Regarding your second question, all writeable dependency properties can be set using a Setter. The reason you were unable to set TextWrapping on a Button via a style is that Button does not have a TextWrapping dependency property (or indeed any TextWrapping property). There are no "magic words," just the names of dependency properties.

No, there are magic words. In this case, the magic words were "TemplateBinding Content." Thanks for letting me know. — mmr, Apr 16 '09 at 00:39

score 10 · Answer 4 · answered Jul 11 '17 at 21:25

10

<Style TargetType="Button">
    <Setter Property="ContentTemplate">
        <Setter.Value>
            <DataTemplate>
                <TextBlock Text="{TemplateBinding Content}" TextWrapping="Wrap" />
            </DataTemplate>
        </Setter.Value>
    </Setter>
</Style>

answered Jul 11 '17 at 21:25

Mike Eshva

1,078
15
17

This is the answer people should choose if they are looking to universally make all of their buttons wrap text without destroying the chrome. – Jerry Dec 19 '21 at 20:04

score 6 · Answer 5 · answered Aug 30 '14 at 18:47

Here's an example of Eric's answer in C# code-behind:

var MyButton = new Button();

MyButton.Content = new TextBlock() {
    FontSize        = 25,
    Text            = "Hello world, I'm a pretty long button!",
    TextAlignment   = TextAlignment.Center,
    TextWrapping    = TextWrapping.Wrap
};

score 0 · Answer 6 · answered Nov 01 '21 at 07:52

0

To expand @Rob's answer with @fadden's comment:

<Button Width="50" Height="40">
   <AccessText Text="_Some long text" TextWrapping="Wrap" TextAlignment="Center"/>
</Button>

The TextBlock control does not support keyboard hotkeys (_).

answered Nov 01 '21 at 07:52

slfan

8,950
115
65
78

WPF button textwrap style

6 Answers6

Linked