wpf 的 xaml 中,給button增加背景圖片

1 篇文章 0 订阅

在wpf的xaml中,給button加背景圖片時,總是無法正常顯示。最後通過修改模板的方式才正常顯示。踩坑步驟記錄如下:

不可行的是:

            <Button xxx>
                <Button.Background>
                    <!--<ImageBrush ImageSource="../../Images/播放未按下.png" Stretch="Fill" />-->
                    <!--<ImageBrush ImageSource="Pack://Application:,,,/Resources/userff.png" Stretch="Fill" />-->
                    <!--<ImageBrush ImageSource="/DCW;component/Images/播放未按下.png" Stretch="Fill"/>-->
                </Button.Background>
            </Button>

 

可行的是:

            <Button xxx>
                <Button.Template>
                    <ControlTemplate>
                        <Image Source="Pack://Application:,,,/Resources/userff.png" Stretch="Fill" />
                    </ControlTemplate>
                </Button.Template>
            </Button>

 

以下為找尋到的資源(copy自:https://blog.csdn.net/zzzwwwppp11199988899/article/details/78182986)

在wpf中,如果要想给按钮控件Button加上图片,最直接的做法是修改控件模板,在模板中加入想要的图片,代码如下图所示:

           <Button x:Name="m_HelpButton" IsEnabled="True" Width="23" Height="23" Click="m_Click">
                <Button.Template>
                    <ControlTemplate>
                        <Grid>
                            <Image Margin="2" Source="Image/help1.png" />
                        </Grid>
                    </ControlTemplate>
                </Button.Template>
            </Button>

 

       但是这样做有一个弊端——每次需要用到图片按钮的时候都要去修改模板。因为上面的示例代码中,模板代码过于精简,所以乍看之下似乎这种做法也没有什么不好。但是在实际的应用中,按钮控件的模板往往复杂得多,比如,有很多的Trigger事件,往往需要根据鼠标或按钮的状态来调整控件的图片、字体、背景灯状态。因此,如果每次应用图片控件的时候都修改模板,很可能会导致xaml文件的代码量爆炸。


       一个好的解决方案为,封装一个用于图片按钮的自定义控件,该控件继承自Button控件,但是额外增加了一些用户图片绑定的依赖属性,同时在控件的默认外观模板中,通过TemplateBinding的方式绑定到依赖属性上,这样在使用的时候便可以直接通过绑定的方式设置图片按钮需要显示的图片。


       具体方式如下:


       一  代码结构

       如图所示,采用自定义控件(CustomControl)的方式对Button控件进行封装。其中ImageButton.xaml为默认控件模板,ImageButton.cs为控件的逻辑控制文件,其中包含了ImageButton控件所需要的新的依赖属性,包括图片源属性等。

       


       二 模板代码

    <ResourceDictionary
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:CustomControl">
     
        <Style TargetType="{x:Type local:ImageButton}">
            <Setter Property="Cursor" Value="Hand"/>
            <Setter Property="Template">
                <Setter.Value>
                    <ControlTemplate TargetType="{x:Type local:ImageButton}">
     
                        <Border Background="{TemplateBinding Background}"
                                BorderBrush="{TemplateBinding BorderBrush}"
                                BorderThickness="{TemplateBinding BorderThickness}">
                            <Grid x:Name="grid" Background="{TemplateBinding Background}">
                                <Border x:Name="PART_Border" Background="{TemplateBinding Background}" BorderBrush="{TemplateBinding BorderBrush}" BorderThickness="{TemplateBinding BorderThickness}" CornerRadius="{TemplateBinding CornerRadius}"/>
     
                                <Grid HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}">
                                    <StackPanel HorizontalAlignment="Center" Orientation="{TemplateBinding IconContentOrientation}" VerticalAlignment="Center" Margin="{TemplateBinding Padding}">
                                        <Grid HorizontalAlignment="Center" VerticalAlignment="{TemplateBinding VerticalContentAlignment}">
                                            <Image x:Name="PART_Icon" Source="{TemplateBinding Icon}" Height="{TemplateBinding IconHeight}" Width="{TemplateBinding IconWidth}"/>
                                            <Image x:Name="PART_MouseOverIcon" Visibility="Collapsed" Source="{TemplateBinding IconMouseOver}"  Height="{TemplateBinding IconHeight}" Width="{TemplateBinding IconWidth}"/>
                                            <Image x:Name="PART_PressIcon" Visibility="Collapsed" Source="{TemplateBinding IconPress}"  Height="{TemplateBinding IconHeight}" Width="{TemplateBinding IconWidth}"/>
                                        </Grid>
                                        <TextBlock x:Name="PART_Content" Text="{TemplateBinding Content}"
                                                   HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
                                                   VerticalAlignment="{TemplateBinding VerticalContentAlignment}"
                                                   SnapsToDevicePixels="{TemplateBinding SnapsToDevicePixels}"  
                                                   Margin="{TemplateBinding IconContentMargin}"
                                                   Foreground="{TemplateBinding Foreground}"
                                                   TextTrimming="CharacterEllipsis"/>
                                    </StackPanel>
                                </Grid>
                            </Grid>
                        </Border>
     
                        <ControlTemplate.Triggers>
     
                            <Trigger Property="IsMouseOver" Value="True">
                                <Setter Property="Foreground" TargetName="PART_Content" Value="{Binding MouseOverForeground,RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type local:ImageButton}}}"/>
                                <Setter Property="Background" TargetName="PART_Border" Value="{Binding MouseOverBackground,RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type local:ImageButton}}}"/>
                                <Setter Property="BorderBrush" TargetName="PART_Border" Value="{Binding MouseOverBorderBrush,RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type local:ImageButton}}}"/>
                                <Setter Property="Visibility" TargetName="PART_MouseOverIcon" Value="Visible"/>
                                <Setter Property="Visibility" TargetName="PART_Icon" Value="Collapsed"/>
                                <Setter Property="Visibility" TargetName="PART_PressIcon" Value="Collapsed"/>
                            </Trigger>
     
                            <Trigger Property="IsPressed" Value="True">
                                <Setter Property="Foreground" TargetName="PART_Content" Value="{Binding MouseDownForeground,RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type local:ImageButton}}}"/>
                                <Setter Property="Background" TargetName="PART_Border" Value="{Binding MouseDownBackground,RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type local:ImageButton}}}"/>
                                <Setter Property="BorderBrush" TargetName="PART_Border" Value="{Binding MouseDownBorderBrush,RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type local:ImageButton}}}"/>
                                <Setter Property="Visibility" TargetName="PART_PressIcon" Value="Visible"/>
                                <Setter Property="Visibility" TargetName="PART_Icon" Value="Collapsed"/>
                                <Setter Property="Visibility" TargetName="PART_MouseOverIcon" Value="Collapsed"/>
                            </Trigger>
     
                            <Trigger Property="IsEnabled" Value="False">
                                <Setter Property="Opacity" Value="0.5" />
                            </Trigger>
     
                            <Trigger Property="Text" SourceName="PART_Content" Value="">
                                <Setter Property="Visibility" TargetName="PART_Content" Value="Collapsed"/>
                            </Trigger>
     
                            <Trigger Property="Text" SourceName="PART_Content" Value="{x:Null}">
                                <Setter Property="Visibility" TargetName="PART_Content" Value="Collapsed"/>
                            </Trigger>
                        </ControlTemplate.Triggers>
                    </ControlTemplate>
                </Setter.Value>
            </Setter>
        </Style>
    </ResourceDictionary>

       在模板中,通过TemplateBinding 的方式绑定了控件中的自定义属性,并默认显示给定的图标和文字。

       然后通过触发器,当鼠标悬停或按下的时候,控制相关图标的显示隐藏以及文字的背景色、前景色和边框颜色。


       三 自定义依赖属性

       在ImageButton.cs中定义依赖属性,这些依赖属性包含了图片按钮控件的边框、前景色、背景色,图片等属性。在复写的OnApplyTemplate方法中,会判断如果某些依赖属性的值为null,则使用默认属性。

        public class ImageButton : Button
        {
            static ImageButton()
            {
                DefaultStyleKeyProperty.OverrideMetadata(typeof(ImageButton), new FrameworkPropertyMetadata(typeof(ImageButton)));
            }
     
            public override void OnApplyTemplate()
            {
                base.OnApplyTemplate();
                if (this.MouseOverBackground == null)
                {
                    this.MouseOverBackground = Background;
                }
                if (this.MouseDownBackground == null)
                {
                    if (this.MouseOverBackground == null)
                    {
                        this.MouseDownBackground = Background;
                    }
                    else
                    {
                        this.MouseDownBackground = MouseOverBackground;
                    }
                }
                if (this.MouseOverBorderBrush == null)
                {
                    this.MouseOverBorderBrush = BorderBrush;
                }
                if (this.MouseDownBorderBrush == null)
                {
                    if (this.MouseOverBorderBrush == null)
                    {
                        this.MouseDownBorderBrush = BorderBrush;
                    }
                    else
                    {
                        this.MouseDownBorderBrush = MouseOverBorderBrush;
                    }
                }
                if (this.MouseOverForeground == null)
                {
                    this.MouseOverForeground = Foreground;
                }
                if (this.MouseDownForeground == null)
                {
                    if (this.MouseOverForeground == null)
                    {
                        this.MouseDownForeground = Foreground;
                    }
                    else
                    {
                        this.MouseDownForeground = this.MouseOverForeground;
                    }
                }
            }
     
            #region Dependency Properties
     
            /// <summary>
            /// 鼠标移上去的背景颜色
            /// </summary>
            public static readonly DependencyProperty MouseOverBackgroundProperty
                = DependencyProperty.Register("MouseOverBackground", typeof(Brush), typeof(ImageButton));
     
            /// <summary>
            /// 鼠标按下去的背景颜色
            /// </summary>
            public static readonly DependencyProperty MouseDownBackgroundProperty
                = DependencyProperty.Register("MouseDownBackground", typeof(Brush), typeof(ImageButton));
     
            /// <summary>
            /// 鼠标移上去的字体颜色
            /// </summary>
            public static readonly DependencyProperty MouseOverForegroundProperty
                = DependencyProperty.Register("MouseOverForeground", typeof(Brush), typeof(ImageButton), new PropertyMetadata(null, null));
     
            /// <summary>
            /// 鼠标按下去的字体颜色
            /// </summary>
            public static readonly DependencyProperty MouseDownForegroundProperty
                = DependencyProperty.Register("MouseDownForeground", typeof(Brush), typeof(ImageButton), new PropertyMetadata(null, null));
     
            /// <summary>
            /// 鼠标移上去的边框颜色
            /// </summary>
            public static readonly DependencyProperty MouseOverBorderBrushProperty
                = DependencyProperty.Register("MouseOverBorderBrush", typeof(Brush), typeof(ImageButton), new PropertyMetadata(null, null));
     
            /// <summary>
            /// 鼠标按下去的边框颜色
            /// </summary>
            public static readonly DependencyProperty MouseDownBorderBrushProperty
                = DependencyProperty.Register("MouseDownBorderBrush", typeof(Brush), typeof(ImageButton), new PropertyMetadata(null, null));
     
            /// <summary>
            /// 圆角
            /// </summary>
            public static readonly DependencyProperty CornerRadiusProperty
                = DependencyProperty.Register("CornerRadius", typeof(CornerRadius), typeof(ImageButton), null);
     
            //图标
            public static readonly DependencyProperty IconProperty
                = DependencyProperty.Register("Icon", typeof(ImageSource), typeof(ImageButton), null);
     
            //鼠标移上去的图标图标
            public static readonly DependencyProperty IconMouseOverProperty
                = DependencyProperty.Register("IconMouseOver", typeof(ImageSource), typeof(ImageButton), null);
     
            //鼠标按下去的图标图标
            public static readonly DependencyProperty IconPressProperty
                = DependencyProperty.Register("IconPress", typeof(ImageSource), typeof(ImageButton), null);
     
            //图标高度
            public static readonly DependencyProperty IconHeightProperty
                = DependencyProperty.Register("IconHeight", typeof(double), typeof(ImageButton), new PropertyMetadata(24.0, null));
     
            //图标宽度
            public static readonly DependencyProperty IconWidthProperty
                = DependencyProperty.Register("IconWidth", typeof(double), typeof(ImageButton), new PropertyMetadata(24.0, null));
     
            //图标和内容的对齐方式
            public static readonly DependencyProperty IconContentOrientationProperty
                = DependencyProperty.Register("IconContentOrientation", typeof(Orientation), typeof(ImageButton), new PropertyMetadata(Orientation.Horizontal, null));
     
            //图标和内容的距离
            public static readonly DependencyProperty IconContentMarginProperty
                = DependencyProperty.Register("IconContentMargin", typeof(Thickness), typeof(ImageButton), new PropertyMetadata(new Thickness(0, 0, 0, 0), null));
     
            #endregion
     
            #region Property Wrappers
     
            public Brush MouseOverBackground
            {
                get
                {
                    return (Brush)GetValue(MouseOverBackgroundProperty);
                }
                set { SetValue(MouseOverBackgroundProperty, value); }
            }
     
            public Brush MouseDownBackground
            {
                get
                {
                    return (Brush)GetValue(MouseDownBackgroundProperty);
                }
                set { SetValue(MouseDownBackgroundProperty, value); }
            }
     
            public Brush MouseOverForeground
            {
                get
                {
                    return (Brush)GetValue(MouseOverForegroundProperty);
                }
                set { SetValue(MouseOverForegroundProperty, value); }
            }
     
            public Brush MouseDownForeground
            {
                get
                {
                    return (Brush)GetValue(MouseDownForegroundProperty);
                }
                set { SetValue(MouseDownForegroundProperty, value); }
            }
     
            public Brush MouseOverBorderBrush
            {
                get { return (Brush)GetValue(MouseOverBorderBrushProperty); }
                set { SetValue(MouseOverBorderBrushProperty, value); }
            }
     
            public Brush MouseDownBorderBrush
            {
                get { return (Brush)GetValue(MouseDownBorderBrushProperty); }
                set { SetValue(MouseDownBorderBrushProperty, value); }
            }
     
            public CornerRadius CornerRadius
            {
                get { return (CornerRadius)GetValue(CornerRadiusProperty); }
                set { SetValue(CornerRadiusProperty, value); }
            }
     
            public ImageSource Icon
            {
                get { return (ImageSource)GetValue(IconProperty); }
                set { SetValue(IconProperty, value); }
            }
     
            public ImageSource IconMouseOver
            {
                get { return (ImageSource)GetValue(IconMouseOverProperty); }
                set { SetValue(IconMouseOverProperty, value); }
            }
     
            public ImageSource IconPress
            {
                get { return (ImageSource)GetValue(IconPressProperty); }
                set { SetValue(IconPressProperty, value); }
            }
     
            public double IconHeight
            {
                get { return (double)GetValue(IconHeightProperty); }
                set { SetValue(IconHeightProperty, value); }
            }
     
            public double IconWidth
            {
                get { return (double)GetValue(IconWidthProperty); }
                set { SetValue(IconWidthProperty, value); }
            }
     
            public Orientation IconContentOrientation
            {
                get { return (Orientation)GetValue(IconContentOrientationProperty); }
                set { SetValue(IconContentOrientationProperty, value); }
            }
     
            public Thickness IconContentMargin
            {
                get { return (Thickness)GetValue(IconContentMarginProperty); }
                set { SetValue(IconContentMarginProperty, value); }
            }
     
            #endregion
        }

 

       四 控件的应用

     <control:ImageButton x:Name="btn_Image"
                                 HorizontalContentAlignment="Center"
                                 VerticalContentAlignment="Center"
                                 Background="Red"
                                 Margin="5,0,5,0" ToolTip="播放" Content="播放"
                                 Height="30" Width="80"
                                 Icon="{DynamicResource VideoPlayWhite}"
                                 IconMouseOver="{DynamicResource VideoPlayGray}"
                                 IconPress="{DynamicResource RecordBlue}"
                                 IconHeight="24"
                                 IconWidth="24"
                                 FontSize="16"
                                 IconContentMargin="10,0,0,0"
                                 Foreground="{DynamicResource Colorffffff}"
                                 MouseOverForeground="Green"
                                 MouseDownForeground="Blue"/>

 

       如上述代码所示,应用控件的时候,只需要简单的绑定控件的相关属性即可。


       效果图:


       正常状态:

 

       鼠标悬停:

 


       鼠标按下:


 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值