WPF - 9.内容控件

摘要

内容控件(content control)是更特殊的控件类型，他们可包含并显示一块内容。从技术角度看内控控件是可以包含单个嵌套元素的控件。与布局控件不同的是，内容控件只能包含一个子元素，而布局容器只要愿意可以包含任意多个嵌套元素。 当然仍可以在当个元素中放置大量内容，诀窍是使用单个容器，比如StackPanel或Grid面板来封装所有内容。 所有内容控件都继承自ContentControl。

正文

在容器中对齐内容用HorizontalAlignment和VerticalAlignment来对齐控件，然而一旦控件包含了内容，就需要考虑另一个组织级别。需要决定内容控件中的内容和边框对齐，这是通过使用
HorizontalContentAlignment和VerticalContentAlignment属性来实现的。

<Grid>
    <Grid.RowDefinitions>
        <RowDefinition Height="auto"></RowDefinition>
        <RowDefinition></RowDefinition>
    </Grid.RowDefinitions>
    <Button Content="Hello" HorizontalAlignment="Left" ></Button>
</Grid>

标签具有记忆符，记忆符是能够为连接的控件设置焦点的快捷键。 如果需要显示不需要记忆符内容，使用更轻量级的TextBlock元素。TextBlock元素通过它的TextWrapping属性支持换行。 下划线_=alt+键

• IsCancel属性，true按钮就成为窗口的取消按钮。在当前窗口的任何位置如果按下Esc键，就会触发该按钮。
• IsDefault属性，true,按钮就会成为默认按钮。默认按钮具有蓝色阴影。如果焦点位于非按钮控件上，按enter就会触发默认按钮。如果焦点在按钮上就会触发当前按钮。
• GridViewColumnHeader类，当使用基于网格的ListView控件时，该类可以表示一列可以单击的标题。
• RepeatButton类，只要按钮保存按下的状态，该类就不断地触发Click事件。
• ToggleButton类，改类表示有两个状态(按下按钮和未按下按钮)。当单击ToggleButton时，它会保持按下状态，直到再次单击改按钮以释放它为止。

<Grid HorizontalAlignment="Center">
    <Grid.RowDefinitions>
        <RowDefinition>
        </RowDefinition>
    </Grid.RowDefinitions>
    <Grid.ColumnDefinitions>
        <ColumnDefinition></ColumnDefinition>
        <ColumnDefinition></ColumnDefinition>
    </Grid.ColumnDefinitions>
    <Button Content="Default" IsDefault="True"  HorizontalAlignment="Left" Grid.Column="0" Margin="20 0 20 0" Padding="5" Name="btnDefault" Click="btnDefault_Click"></Button>
    <Button Content="Cancel" IsCancel="True" HorizontalAlignment="Right" Grid.Column="1" Margin="20 0 20 0" Padding="5" Name="btnCancel" Click="btnCancel_Click"></Button>
</Grid>

private void btnDefault_Click(object sender, RoutedEventArgs e)
{
    MessageBox.Show("Default Click");
}

private void btnCancel_Click(object sender, RoutedEventArgs e)
{
    MessageBox.Show("Cancel Click");
}

CheckBox

继承自ToggleButton,有"开关"行为。 IsChecked:true、false、null。null表示不确定的状态，带有阴影的复选框。

<CheckBox x:Name="chk1" IsChecked="{x:Null}" IsThreeState="True" Content="Chk1" Click="chk1_Click"></CheckBox>
<CheckBox x:Name="chk2" Content="Chk2"></CheckBox>

private void chk1_Click(object sender, RoutedEventArgs e)
{
    if (chk1.IsChecked == null)
    {
        txt1.Text = "Chk1 Is Three Status";
    }
    else
    {
        if ((bool)chk1.IsChecked)
        {
            txt1.Text = "Chk1 Is Checked";
        }
        else
        {
            txt1.Text = "Chk1 Is UnChecked";
        }
    }
}

RadioButton

RadioButton类也继承自ToggleButton类。增加了GroupName属性，改属性用于控制如何对单选按钮进行分组。 单选按钮通常由它们的容器就行分组。这意味着，如果StackPanel面板中放置三个单选按钮，那么这三个单选按钮就形成了一组，而且只能选择这三个按钮中的一个。

<StackPanel x:Name="stp1">
    <RadioButton Name="rdo1" IsChecked="True" GroupName="A">A</RadioButton>
    <RadioButton Name="rdo2" GroupName="A">B</RadioButton>
    <RadioButton Name="rdo3" GroupName="A">C</RadioButton>
    <Button x:Name="btnSubmit" Content="提交" Margin="10" Click="btnSubmit_Click"></Button>
    <StackPanel>
        <RadioButton Name="rdo4" GroupName="A">我不知道</RadioButton>
    </StackPanel>
</StackPanel>

GroupName 可以设置跨容器分组

private void btnSubmit_Click(object sender, RoutedEventArgs e)
{
    string selected = "";
    foreach (var item in stp1.Children)
    {
        if(item is RadioButton)
        {
            RadioButton radio= (RadioButton)item;
            if(radio.IsChecked == true)
            {
                selected += radio.Content;
            }
        }
        if(item is StackPanel)
        {
            foreach (var it in ((StackPanel)item).Children)
            {
                RadioButton radio = (RadioButton)it;
                if (radio.IsChecked == true)
                {
                    selected += radio.Content;
                }
            }
        }
    }
    MessageBox.Show(selected);
}

ToolTip

WPF工具提示提供了一个灵活的模型。因为WPF中工具提示是内容控件，所以可在工具提示中放置任何可视化元素。还可以改变各种时间设置来控制工具提示的显示和隐藏速度。 可为可视化元素设置ToolTip属性。ToolTip属性实在FrameworkElement类中定义的，所以有能放到WPF窗口上的元素都可以使用该属性。

<StackPanel>
    <Button Content="Tooltip" Margin="30">
        <Button.ToolTip>
            <ToolTip Background="Red" Placement="Mouse" HorizontalOffset="30" VerticalOffset="-10" 
                     ToolTipService.ShowDuration="5000"
                     ToolTipService.HasDropShadow="True"
                     >
                <TextBlock>哈哈哈，我是一个Tips</TextBlock>
            </ToolTip>
        </Button.ToolTip>
    </Button>
</StackPanel>

ToolTipService主要属性

ToolTipService.InitialShowDelay="1000" //获取或设置工具提示打开前的时间长度

ToolTipService.ShowDuration="7000" //显示时间

ToolTipService.BetweenShowDelay="2000"//获取或设置两个工具提示显示之间的最大时间（第二个工具提示不经延迟即会出现）。

ToolTipService.Placement="Right"//工具提示相对原控件打开时的方向，并指定工具提示在与屏幕边界重叠时的行为。

ToolTipService.PlacementRectangle="50,0,0,0"//获取或设置相对于其来放置工具提示的矩形区域。

ToolTipService.HorizontalOffset="10"//获取或设置由 PlacementRectangle 和 PlacementTarget 属性为工具提示指定的区域的左侧偏移量。

ToolTipService.VerticalOffset="20"//获取或设置由 PlacementRectangle 和 PlacementTarget 属性为工具提示指定的区域的顶部距离。

ToolTipService.HasDropShadow="False"//获取或设置工具提示是否显示投影效果。

ToolTipService.IsEnabled="True"//获取或设置是否显示工具提示。

Popup

Popup控件只能包含单一内容，该单一内容可以包含任何WPF元素，改内容存储在Popup.Child属性中，而不像ToolTip.Content属性中。

Popup永远不会自动提示。为显示Popup控件，必须设置IsOpen属性。 默认情况下，如果PopUp.StaysOpen属性被设置为true,并且PopUp会一直提示，知道明确的将IsOpen属性设置为False为止，如果PopUp.StaysOpen属性被设置为false.那么当用户在其他地方点击鼠标时，那么Popup就会消失。

Popup控件提供了PopupAnimation属性，当IsOpen属性设置为true时，通过该属性可控制Popup控件进入视野的方式。需设置AllowsTransparency属性设置为true。

None 默认值 Fade弹出窗口的透明度逐渐增加

Scroll 弹出窗口将从窗口的左上角滑入。

Slide弹出窗口将从上向下滑入。

Popup控件可接收焦点。

因此，可在其内部放置与用户交互的控件，该功能是使用Popup控件而不使用Tooltip控件的主要原因之一。

<StackPanel>
    <Popup x:Name="pop" StaysOpen="False" Placement="Mouse" PopupAnimation="Slide" AllowsTransparency="True">
        <Border BorderBrush="Beige" BorderThickness="2" Background="White">
            <TextBlock Margin="10" TextWrapping="Wrap">
                 这是一个Pop测试
            </TextBlock>
        </Border>
    </Popup>
    <Button Content="Pop" Name="btnPop" Click="btnPop_Click"></Button>
</StackPanel>

private void btnPop_Click(object sender, RoutedEventArgs e)
{
    pop.IsOpen = true;
}