C#之WPF学习之路(5)

目录

内容控件(2)

TextBlock文字块

TextBox文本框

TextBoxBase基类

TextBox控件

RichTextBox富文本框

ToolTip控件(提示工具)

Popup弹出窗口

Image图像控件

属性成员

事件成员


内容控件(2)

TextBlock文字块

TextBlock是用于显示文本的控件,相比Label,它提供了更多的功能和灵活性。

TextBlock的特点和用法:

  • 文本格式化:TextBlock允许我们应用格式化文本,包括设置字体、字号、加粗、斜体等样式。
  • 文本换行:TextBlock可以自动换行长文本,而不会截断内容。
  • 内联元素:TextBlock允许我们在文本中插入内联元素,如超链接、图标等。
  • 富文本支持:TextBlock可以显示富文本内容,包括不同的字体、颜色、下划线等。
  • 高性能:相比Label,TextBlock通常具有更好的性能,特别是在处理大量文本时。

TextBlock提供了丰富的属性来控制文本的外观和布局。下面是对这些属性的简要说明:

  • FontWeight: 控制文本的粗细程度,可以设置为Normal、Bold等。
  • FontStyle: 控制文本的样式,例如斜体、正常。
  • FontFamily: 设置文本的字体系列,如Arial、微软雅黑等。
  • Text: 设置或获取TextBlock中显示的文本内容。
  • ContentEnd: 获取TextBlock内容的末尾位置。
  • Typography: 控制文本的排版变体。
  • FontStretch: 控制文本的拉伸特征,例如Condensed、Expanded等。
  • BaselineOffset: 设置文本每行相对于基线的偏移量。
  • FontSize: 设置文本的字号大小。
  • TextWrapping: 控制文本的换行方式,可以设置为NoWrap、Wrap等。
  • Background: 设置TextBlock的背景颜色。
  • TextEffects: 应用于文本内容的效果,例如阴影、发光等。
  • LineHeight: 设置每行文本的高度。
  • Padding: 设置文本内容与TextBlock边界之间的填充空间。
  • TextAlignment: 控制文本的水平对齐方式,可以设置为Left、Right、Center等。
  • TextTrimming: 在内容超出内容区域时采用的文本剪裁行为,可以设置为None、CharacterEllipsis等。
  • Foreground: 设置文本的前景色,即文本的颜色。
  • Inlines: 一个集合,用于存储内联流内容元素,例如Run对象,可以单独设置每个Run的样式。
  • ContentStart: 获取TextBlock内容的起始位置。

例子:

<Window x:Class="WpfApp2.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfApp2"
        mc:Ignorable="d"
        Title="学习之路" Height="450" Width="800">
    <WrapPanel Margin="10">
        <!-- 使用Label显示静态文本 -->
        <TextBlock Text="这是一个TextBlock文字块" Margin="5"/>

        <!-- 粗体、斜体、字体、字号 -->
        <TextBlock FontWeight="Bold" Text="粗体文字" Margin="5"/>
        <TextBlock FontStyle="Italic" Text="斜体文字" Margin="5"/>
        <TextBlock FontFamily="Microsoft YaHei UI" Text="微软雅黑" Margin="5"/>
        <TextBlock FontSize="30" Text="大号字体" Margin="5"/>

        <!-- 文本颜色、背景颜色 -->
        <TextBlock Foreground="Red" Text="红色文字" Margin="5"/>
        <TextBlock Foreground="Yellow" Background="Red" Text="底色文字" Margin="5"/>

        <!-- 内间距 -->
        <TextBlock Foreground="Yellow" Background="Red" Text="内间距文字" Padding="10" Margin="5"/>

        <!-- 使用Run设置不同颜色的文本 -->
        <TextBlock Background="LightGray" Height="25" Margin="5">
            <Run Foreground="Red">这行文字</Run>
            <Run Foreground="Green">由三部分</Run>
            <Run Foreground="Blue">组成</Run>
        </TextBlock>

        <!-- 文本换行 -->
        <Grid Width="150" Height="100" Background="LightGoldenrodYellow" Margin="5">
            <TextBlock TextWrapping="Wrap" Margin="10" Text="这段文字体现了文字的文本换行属性TextWrapping"/>
        </Grid>

        <!-- 使用Run设置复杂样式的文本 -->
        <Grid Margin="5">
            <TextBlock Width="320" Height="100" FontSize="15" FontFamily="微软雅黑" FontWeight="Black" 
                       Foreground="#dddddd" Background="Teal" TextAlignment="Center" TextWrapping="Wrap" 
                       TextTrimming="CharacterEllipsis" Margin="10" Padding="5">
                <Run Foreground="#CDB632" TextDecorations="Underline">滚滚长江东逝水,浪花淘尽英雄。</Run>
                <Run>白发渔樵江渚上,惯看秋月春风。</Run>
            </TextBlock>
        </Grid>
    </WrapPanel>
</Window>

TextBox文本框

TextBox 控件是 WPF 中用于接受用户输入文本的常用控件之一。它继承自 TextBoxBase,而 TextBoxBase 则继承自 Control。

TextBoxBase基类

TextBoxBase 基类提供了以下属性:

  • VerticalScrollBarVisibility: 获取或设置垂直滚动条是否可见。
  • HorizontalScrollBarVisibility: 获取或设置水平滚动条是否可见。
  • AcceptsReturn: 获取或设置一个值,指示在文本框中按下回车键时是否添加新行。
  • AcceptsTab: 获取或设置一个值,指示在文本框中按下 Tab 键时是否插入制表符。
  • IsReadOnlyCaretVisible: 获取或设置一个值,指示只读文本框中的插入符是否可见。
  • SelectionOpacity: 获取或设置用户选中文本时的透明度。
  • IsUndoEnabled: 获取或设置一个值,指示文本框是否启用撤销支持。
  • UndoLimit: 获取或设置撤销队列中存储的操作数目限制。
  • AutoWordSelection: 获取或设置一个值,指示是否自动选择字词。
  • SelectionBrush: 获取或设置用户选择文本时的画刷。
  • IsReadOnly: 获取或设置一个值,指示文本框是否只读。
  • CaretBrush: 获取或设置用于绘制文本框中插入符的画刷。
  • IsInactiveSelectionHighlightEnabled: 获取或设置一个值,指示当文本框没有焦点时是否显示选定文本的高亮显示。

TextBoxBase 基类还提供了以下事件:

  • TextChanged: 每当文本框中的文本内容发生更改时触发。可以用于监视文本的实时变化,执行验证逻辑或者处理其他业务逻辑。
  • SelectionChanged: 当文本框中的选定文本范围发生更改时触发。可以用于检测用户选择文本的变化,并在需要时进行相应的处理。

TextBox控件

TextBox 类还提供了以下属性:

  • MinLines: 获取或设置 TextBox 控件的最小可见行数。
  • MaxLines: 获取或设置 TextBox 控件的最大可见行数。
  • CharacterCasing: 获取或设置 TextBox 控件中字符的大小写形式。可以设置为 Normal、Lower 或 Upper。
  • MaxLength: 获取或设置 TextBox 控件中允许手动输入的最大字符数。
  • TextAlignment: 获取或设置 TextBox 控件中文本的水平对齐方式,例如左对齐、右对齐、居中对齐和两端对齐。
  • CaretIndex: 获取或设置插入点的插入位置索引。
  • SelectionLength: 获取或设置当前所选内容中的字符数。
  • SelectionStart: 获取或设置当前所选内容的起始位置的字符索引。
  • Typography: 获取 TextBox 控件中的文本内容的当前有效版式变体。
  • LineCount: 获取 TextBox 控件中的总行数。
  • TextDecorations: 获取应用于 TextBox 控件中文本的文本修饰。
  • SelectedText: 获取或设置 TextBox 控件中当前选择的内容。
  • TextWrapping: 获取或设置 TextBox 控件中文本的换行方式。

TextBox文本框本身没有任务事件,都是继承父类的事件。

例子:

<Window x:Class="WpfApp2.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfApp2"
        mc:Ignorable="d"
        Title="学习之路" Height="450" Width="800">
    <Grid Margin="20">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="Auto"/>
        </Grid.RowDefinitions>

        <!-- 第一个文本框 -->
        <TextBox x:Name="textBox1" Grid.Row="0" Margin="5" Width="200" TextAlignment="Center" Text="请输入姓名"
                 GotFocus="TextBox_GotFocus" LostFocus="TextBox_LostFocus"/>

        <!-- 只读文本框 -->
        <TextBox x:Name="textBox2" Grid.Row="1" Margin="5" Width="200" Text="只读文本框" IsReadOnly="True"/>

        <!-- 可以输入多行文本的文本框 -->
        <TextBox x:Name="textBox3" Grid.Row="2" Margin="5" Width="200" Height="80" TextWrapping="Wrap"
                 Text="这是一个可以输入多行文本的 TextBox 控件,你可以在这里输入多行文本。"
                 GotFocus="TextBox_GotFocus" LostFocus="TextBox_LostFocus"/>

        <!-- 限制输入长度的文本框 -->
        <TextBox x:Name="textBox4" Grid.Row="3" Margin="5" Width="200" MaxLength="10" Text="最多输入10个字符"
                 GotFocus="TextBox_GotFocus" LostFocus="TextBox_LostFocus"/>
    </Grid>
</Window>
using System.Windows;
using System.Windows.Controls;

namespace WpfApp2
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private void TextBox_GotFocus(object sender, RoutedEventArgs e)
        {
            TextBox? textBox = sender as TextBox;
            if (textBox != null)
            {
                // 清空文本框
                textBox.Text = "";
            }
        }

        private void TextBox_LostFocus(object sender, RoutedEventArgs e)
        {
            TextBox? textBox = sender as TextBox;
            if (textBox != null)
            {
                // 还原文本框
                if (textBox == textBox1)
                {
                    textBox.Text = "请输入姓名";
                }
                else if (textBox == textBox3)
                {
                    textBox.Text = "这是一个可以输入多行文本的 TextBox 控件,你可以在这里输入多行文本。";
                }
                else if (textBox == textBox4)
                {
                    textBox.Text = "最多输入10个字符";
                }
            }
        }
    }
}

RichTextBox富文本框

RichTextBox 提供了比 TextBox 更丰富的文档编辑功能。它允许用户创建和编辑包含格式、图像、超链接等丰富内容的文档。与简单的 TextBox 不同,RichTextBox 具有更多的属性、方法和事件,使用户能够更灵活地编辑文本内容。

RichTextBox 控件的结构定义包含以下重要成员:

构造函数:

  • public RichTextBox();:无参构造函数用于创建 RichTextBox 控件的实例。
  • public RichTextBox(FlowDocument document);:带有 FlowDocument 参数的构造函数,用于创建 RichTextBox 控件并指定初始文档内容。

属性:

  • public FlowDocument Document { get; set; }:获取或设置 RichTextBox 控件的文档内容,文档类型为 FlowDocument。
  • public bool IsDocumentEnabled { get; set; }:获取或设置一个值,指示是否启用 RichTextBox 的文档模式。
  • public TextSelection Selection { get; }:获取当前文本选择的对象。
  • public TextPointer CaretPosition { get; set; }:获取或设置 RichTextBox 控件中插入符的位置。

方法:

  • public TextPointer GetNextSpellingErrorPosition(TextPointer position, LogicalDirection direction);:获取指定位置之后(或之前)的下一个拼写错误的位置。
  • public TextPointer GetPositionFromPoint(Point point, bool snapToText);:根据指定的屏幕坐标获取 RichTextBox 中的文本位置。
  • public SpellingError GetSpellingError(TextPointer position);:获取指定位置处的拼写错误。
  • public TextRange GetSpellingErrorRange(TextPointer position);:获取包含指定位置的拼写错误的文本范围。
  • public bool ShouldSerializeDocument();:指示是否应序列化文档属性。

其他成员:

  • protected internal override IEnumerator LogicalChildren { get; }:获取 RichTextBox 控件的逻辑子元素的枚举器。
  • protected override Size MeasureOverride(Size constraint);:重写的用于测量控件大小的方法。
  • protected override AutomationPeer OnCreateAutomationPeer();:创建 RichTextBox 控件的自动化对等体。
  • protected override void OnDpiChanged(DpiScale oldDpiScaleInfo, DpiScale newDpiScaleInfo);:处理 DPI 变化的方法。

例子:

<Window x:Class="WpfApp2.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfApp2"
        mc:Ignorable="d"
        Title="学习之路" Height="450" Width="800">
    <Grid>
        <RichTextBox x:Name="richTextBox" Margin="10">
            <FlowDocument>
                <Paragraph>
                    <Run FontWeight="Bold">这是一个 RichTextBox 示例</Run>
                </Paragraph>
                <Paragraph>
                    <Run>RichTextBox 在 WPF 中提供了先进的文本编辑功能。</Run>
                </Paragraph>
                <Paragraph>
                    <Run>您可以在 RichTextBox 中添加中文文本,并且可以使用不同的字体、样式、颜色等。</Run>
                </Paragraph>
            </FlowDocument>
        </RichTextBox>
    </Grid>
</Window>

ToolTip控件(提示工具)

ToolTip 控件继承自 ContentControl,用于显示提示信息。但ToolTip 不能单独存在于 WPF 的视觉树上,必须依附于另一个控件。当鼠标移动到依附的控件上方并悬停一段时间时,ToolTip 将显示其内容。ToolTip 的内容可以是任何类型,包括文本、图像、甚至其他控件。要为控件添加 ToolTip,可以使用控件的 ToolTip 属性,并设置其内容为想要显示的内容。

ToolTip控件的主要成员包括:

属性:

  • IsOpen:获取或设置一个值,指示 ToolTip 是否处于打开状态。
  • StaysOpen:获取或设置一个值,指示 ToolTip 是否始终保持打开状态。
  • CustomPopupPlacementCallback:获取或设置自定义的弹出位置回调函数。
  • Placement:获取或设置 ToolTip 相对于其目标的位置。
  • PlacementRectangle:获取或设置 ToolTip 相对于屏幕的位置和大小。
  • PlacementTarget:获取或设置包含 ToolTip 的 UI 元素。
  • HorizontalOffset:获取或设置 ToolTip 相对于其内容的水平偏移量。
  • VerticalOffset:获取或设置 ToolTip 相对于其内容的垂直偏移量。
  • HasDropShadow:获取或设置一个值,指示是否为 ToolTip 显示阴影效果。

事件:

  • Opened:当 ToolTip 打开时发生。
  • Closed:当 ToolTip 关闭时发生。

例子:

<Window x:Class="WpfApp2.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfApp2"
        mc:Ignorable="d"
        Title="学习之路" Height="450" Width="800">
    <Grid>
        <!-- 定义一个按钮,并设置ToolTip -->
        <Button Content="Hover Me" HorizontalAlignment="Center" VerticalAlignment="Center">
            <Button.ToolTip>
                <!-- ToolTip 的内容可以是任意的,这里设置为一个文本字符串 -->
                <ToolTip Content="This is a ToolTip."/>
            </Button.ToolTip>
        </Button>
    </Grid>
</Window>

Popup弹出窗口

Popup控件在WPF中用于在指定的元素或窗体中弹出一个具有任意内容的窗口。opup继承于FrameworkElement,算得上是独门独户的控件,因为大多数控件都是从Shape、Control或Panel三个类继承而来。与ToolTip不同,Popup可以显示更复杂的内容,包括自定义的用户界面。Popup通常用于创建自定义的弹出菜单、弹出提示、上下文菜单等交互式功能。

下面是对Popup控件主要属性和事件的说明:

属性成员:

  • HasDropShadow: 只读属性,指示控件是否具有投影效果。
  • AllowsTransparency: 获取或设置一个值,指示控件是否包含透明内容。
  • PopupAnimation: 获取或设置控件打开或关闭时的动画效果。可以是None、Fade、Slide、Scroll等不同类型的动画。
  • PlacementRectangle: 获取或设置控件打开时的矩形位置。
  • PlacementTarget: 获取或设置Popup控件在哪个控件旁边打开,这个属性是Popup控件打开的相对位置。
  • VerticalOffset: 获取或设置目标原点和Popup控件对齐点之间的垂直距离。
  • HorizontalOffset: 获取或设置目标原点和Popup控件对齐之间的水平距离。
  • StaysOpen: 默认值为true,表示Popup打开后,如果失去焦点,Popup是否继续显示。
  • Child: 获取或设置Popup控件的内容,类似于ContentControl的Content属性,但是Popup的内容只能是一个元素。
  • IsOpen: 获取或设置Popup控件是否可见。
  • Placement: 枚举类,表示Popup控件显示时的对齐方式。

事件成员:

  • Opened事件: 当Popup控件打开时引发的事件。
  • Closed事件: 当Popup控件关闭时引发的事件。

例子:

<Window x:Class="WpfApp2.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfApp2"
        mc:Ignorable="d"
        Title="学习之路" Height="450" Width="800">
    <StackPanel Orientation="Horizontal" HorizontalAlignment="Center" VerticalAlignment="Center">
        <CheckBox x:Name="checkbox" Content="显示菜单" Height="30" Margin="5" ToolTip="显示菜单" Checked="checkbox_Checked"/>
        <Popup Name="myPopup" 
               IsOpen="{Binding IsChecked, ElementName=checkbox}" 
               PlacementTarget="{Binding ElementName=checkbox}" 
               StaysOpen="True">
            <Border BorderThickness="1" Background="LightBlue">
                <StackPanel>
                    <Button Content="选项 1" Click="MenuItem_Click"/>
                    <Button Content="选项 2" Click="MenuItem_Click"/>
                    <Button Content="选项 3" Click="MenuItem_Click"/>
                </StackPanel>
            </Border>
        </Popup>
    </StackPanel>
</Window>
using System.Windows;
using System.Windows.Controls;

namespace WpfApp2
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private void MenuItem_Click(object sender, RoutedEventArgs e)
        {
            Button clickedButton = sender as Button; // 获取被点击的按钮

            // 根据按钮的内容执行不同的操作或显示不同的信息
            switch (clickedButton.Content.ToString())
            {
                case "选项 1":
                    MessageBox.Show("选项 1 被点击了");
                    myPopup.IsOpen = false; // 选择选项后关闭弹出菜单
                    break;
                case "选项 2":
                    MessageBox.Show("选项 2 被点击了");
                    myPopup.IsOpen = false; // 选择选项后关闭弹出菜单
                    break;
                case "选项 3":
                    MessageBox.Show("选项 3 被点击了");
                    myPopup.IsOpen = false; // 选择选项后关闭弹出菜单
                    break;
                default:
                    // 默认情况下,如果按钮内容不匹配任何选项,显示默认信息
                    MessageBox.Show("未知选项被点击了");
                    break;
            }
        }

        // checkbox_Checked事件处理程序
        private void checkbox_Checked(object sender, RoutedEventArgs e)
        {
            CheckBox? checkBox = sender as CheckBox;
            if (checkBox.IsChecked == true)
            {
                myPopup.IsOpen = true; // 当复选框被选中时,打开Popup
            }
            else
            {
                myPopup.IsOpen = false; // 当复选框被取消选中时,关闭Popup
            }
        }

    }
}

Image图像控件

Image控件是用于显示图像的控件,它继承自FrameworkElement基类。可以使用Image控件来显示各种图像格式,如.bmp、.gif、.ico、.jpg、.png、.wdp 和 .tiff。

在加载.gif动画图片时,WPF默认只显示第一帧。如果需要在WPF中显示.gif动画,可以通过使用第三方库,例如WpfAnimatedGif库来实现。这个库可以让WPF中显示.gif动画图片,而不仅仅是第一帧。您可以通过NuGet来安装WpfAnimatedGif库。

属性成员

1、StretchDirection

说明:枚举类型,表示图像在缩放时的方向条件。可以是以下值之一:

  • UpOnly:表示图像仅在小于父级尺寸时进行缩放。
  • DownOnly:表示图像仅在大于父级尺寸时进行缩放。
  • Both:表示图像可以在满足上述两种条件下进行缩放。

2、Stretch

说明:枚举类型,表示图像的缩放模式。可以是以下值之一:

  • None:保持图像原始大小。
  • Fill:调整图像大小以填充目标尺寸,且不保留纵横比。
  • Uniform:在保持纵横比的前提下缩放图像。
  • UniformToFill:在保持纵横比的前提下缩放图像,同时可以进行裁剪。

3、Source 说明:图像的源,类型为ImageSource。

4、BaseUri 说明:获取或设置图像的基本统一资源标识符(URI)。

事件成员

  • DpiChanged :当显示图像的屏幕的 DPI 发生更改时触发。
  • ImageFailed :在图像加载失败时触发。

例子:

<Window x:Class="WpfApp2.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:WpfApp2"
        mc:Ignorable="d"
        Title="学习之路" Height="450" Width="800">
    <Grid>
        <Image Width="200" Height="150" Stretch="Uniform" Source="/Images/meimei.png" />
    </Grid>
</Window>

注意:一定要将图片属性改成始终复制

  • 25
    点赞
  • 22
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

程序员老李头

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值