TOC

This article has been localized into Chinese by the community.

杂项控件:

扩展控件

Expander将会提供你能够去隐藏/显示一部分内容。这将通常是一段文字,但是感谢WPF的灵活,它能够用于任何类型混合内容,像文字,图片,甚至其他WPF控件。看看我在说什么,下面是个例子:

注意箭头部分,你点击它之后,Expander 控件将会扩展然后揭示它的内容

它的代码当然非常简单:

<Expander>  
    <TextBlock TextWrapping="Wrap" FontSize="18">  
Here we can have text which can be hidden/shown using the built-in functionality of the Expander control.  
    </TextBlock>  
</Expander>

Expander 默认是不会扩展开来的,所以就想第一张截图所看到那样。用户可以通过点击它扩展或者你能让它通过IsExpanded 属性初始时扩展:

<Expander IsExpanded="True">

你当然也能在运行时读到这个属性,如果你需要知道关于Expander 的当前状态。

高级内容

Expander 的内容只能是一个控件,像我们第一个例子那里使用的是一个TextBlock 控件,但是没有什么能够阻挡你这样做,例如一个Panel,它能够容纳一些你想要加入的子控件。这允许你去在Expander中寄宿富文本,从文本,图片到例如一个ListView 或者其他WPF控件

以下是更高级内容的例子,其中我们使用几个面板,文字和一个图片甚至一个TextBox 控件:

<Expander Margin="10">
    <StackPanel Margin="10">
<DockPanel>
    <Image Source="/WpfTutorialSamples;component/Images/question32.png" Width="32" Height="32" DockPanel.Dock="Right" Margin="10"></Image>
    <TextBlock TextWrapping="Wrap" FontSize="18">
    Did you know that WPF is really awesome? Just enter your e-mail address below and we'll send you updates:
    </TextBlock>
</DockPanel>
<TextBox Margin="10">john@doe.org</TextBox>
    </StackPanel>
</Expander>

扩展方向

默认下,Expander 控件将占据所有它的容器控件的可用空间,然后根据ExpandDirection的属性的值进行扩展,默认设为Down 。你可以看到在截图中看到这点,因为箭头是放置在控件的顶部的,然后它根据控件是否已扩展指向上或下。

如果你改变ExpandDirection属性的值,它将影响Expander 控件的行为和外观。例如,如果你改为Right值,箭头将放置到左边,然后指向左/右来代替上/下。以下是例子:

<Expander Margin="10" ExpandDirection="Right">
    <TextBlock TextWrapping="Wrap" FontSize="18">
    Here we can have text which can be hidden/shown using the built-in functionality of the Expander control.
    </TextBlock>
</Expander>

你当然也能设置该属性为Up或者Left,如果你这么做,按钮将会放置到底部或者右边

自定义标题

在迄今所有的例子中,Expander 控件几乎没有什么外观,除了用来显示/因此内容的按钮外。它绘制为一个在其中间有个箭头的圆形按钮。你能够简单的自定义控件标题区域,通过使用Header属性。以下是我们使用该属性去添加一个说明文本到按钮边的例子:

<Expander Margin="10" Header="Click to show/hide content...">
    <TextBlock TextWrapping="Wrap" FontSize="18">
    Here we can have text which can be hidden/shown using the built-in functionality of the Expander control.
    </TextBlock>
</Expander>

但是你不必满足一段简单的文字,Header属性允许你去添加控件进去,去创建一个更加定制的外观:

<Expander Margin="10">
    <Expander.Header>
<DockPanel VerticalAlignment="Stretch">
    <Image Source="/WpfTutorialSamples;component/Images/bullet_green.png" Height="16" DockPanel.Dock="Left" />
    <TextBlock FontStyle="Italic" Foreground="Green">Click to show/hide content...</TextBlock>
</DockPanel>
    </Expander.Header>
    <TextBlock TextWrapping="Wrap" FontSize="18">
    Here we can have text which can be hidden/shown using the built-in functionality of the Expander control.
    </TextBlock>
</Expander>

注意我如何轻松的添加一个面板作为Header属性的内容,和在其之中,我能做任何我想要的,像添加一个图片和一个自定义格式的TextBlock 控件

小结

Expander 控件是当你需要能去隐藏/显示内容时一个非常棒的小助手,和任何其他在WPF framework中的控件非常像,都能够很容易去使用和自定义。

This article has been fully translated into the following languages: Is your preferred language not on the list? Click here to help us translate this article into your language!