2024年终活动

DevExpress控件使用交流,DevExpress中国社区Dev联系电话 联系电话:023-68661681

打印/导出网格数据时,如何通过PrintCellStyle更改DXGrid数据单元格的外观?

来源:本站原创   发布时间:2012-08-08   浏览:3045次

在许多应用程序中,GridControl都包含被绑定到特定类型(例如Boolean或Image)字段的列。为了显示和编辑这些列,需要进行一些特殊的编辑设置(以便提供最好的数据维护方法):对 Boolean 列设置复选框(CheckBox)和对Image 列设置PopupImageEdit。此外,就GridControl导出和打印而言,通常会提出以下问题:

  • 当打印网格时,我应该怎样让图像显示在PopupImageEdit列中呢?
  • 如何将文本值(而非复选框)显示在打印网格中?
  • 在打印时,有什么方法可以显示所有的MemoEdit文本?

所有这些问题都可以通过一个共同的解决方案得以解决,本文将对这一解决方案进行说明。

在打印某个单元格时,其外观由单元格打印样式中定义的DisplayTemplate进行定义。因此,如果有必要更改单元格的打印外观,您需要为该单元格创建一个新的控件模板,并在自定义打印单元格样式中将其设置为DisplayTemplate。不过,如果您想得到完全自定义的数据打印表示,那么欢迎您使用我们的XtraReports产品,XtraReports可以为您提供强大而灵活的方法创建自定义报表。

例如,如果将PopupImageEdit用作某个列的编辑器,在打印时您可能想要将图像显示在该列的单元格中。我们的想法就是将ImageEdit控件放入单元格显示模板中,并将其源属性绑定到单元格值上。

[XAML]

<Style x:Key="ImageColumnPrintingStyle" TargetType="{x:Type dxe:PopupImageEdit}" BasedOn="{StaticResource {dxgt:TableViewThemeKey ResourceKey=DefaultPrintCellStyle}}">
<Setter Property="dxp:ExportSettings.TargetType" Value="Panel"/>
<Setter Property="DisplayTemplate">
<Setter.Value>
<ControlTemplate TargetType="dxe:PopupImageEdit">
<dxe:ImageEdit Source="{Binding Path=Value}" IsPrintingMode="True"/>
</ControlTemplate>
</Setter.Value>
</Setter>
</Style>

该扩展应用标记语言(xaml)包含了一些重要的细节。首先,这种样式声明具有TargetType 和BasedOn 属性说明语言。新的单元格打印样式必须建立在预定义的DefaultPrintCellStyle 上。TargetType属性必须设置为列(这种样式将应用到该列中)中所用编辑器的属性类型。

第二,该模板中使用的所有控件必须接受打印调整。因此,继承BaseEdit的任何控件必须将IsPrintingMode属性设置为真。

其他控件必须接受通过ExportSettings附加属性执行的打印调整。因此,必须为这些控件提供ExportSettings.TargetType属性值。xmlns:dxp="http://schemas.devexpress.com/winfx/2008/xaml/printing"命名空间中对该属性进行了定义,该属性指定了打印子系统该如何对待这些控件。

例如,如果您想打印TextBlock,有必要将ExportSettings.TargetType指定为Text(文本),然后TextBlock就会被打印出来。如果您想设置某个控件的背景和前景,则需要分别设置ExportSettings.Background和ExportSettings.Foreground。

[XAML]

<TextBlock Text="Textblock text" Margin="10"
Foreground="Red"
dxp:ExportSettings.TargetType="Text"
dxp:ExportSettings.Background="White"
dxp:ExportSettings.Foreground="Red"
/>

形状和复杂控件可导出为图像:

[XAML]

<Ellipse Fill="Yellow" Width="15" Height="15"
dxp:ExportSettings.TargetType="Image"
dxp:ExportSettings.Background="Transparent"
/>

如果打印模板中存在面板,则需将它的ExportSettings.TargetType设置到面板(Panel)中,以便让打印子系统处理子元素。

[XAML]

<StackPanel dxp:ExportSettings.TargetType="Panel">
<TextBlock Text="Property: " Margin="2" dxp:ExportSettings.TargetType="Text"/>
<TextBlock Text="Value" Margin="2" dxp:ExportSettings.TargetType="Text"/>
</StackPanel>

如果控件没有指定ExportSettings.TargetType的附加属性,则该控件会被打印子系统忽略,并且不会出现在打印文档中。这也适用于未设定IsPrintingMode属性的编辑器。

最后需要注意的是,ImageEdit源属性被简单地绑定到单元格值属性(来自数据上下文)上。因此,您可以很容易地获取单元格值。

现在,在设置好样式后,您只需要设置列的PrintCellStyle属性:

[XAML]

<dxg:GridColumn FieldName="Image" PrintCellStyle="{StaticResource ImageColumnPrintingStyle}">
<dxg:GridColumn.EditSettings>
<dxe:PopupImageEditSettings/>
</dxg:GridColumn.EditSettings>
</dxg:GridColumn>

注:每个PrintCellStyle都会影响特定单元格的外观。默认情况下,单元格会在默认行模板中排列成一行。如果您想完全改变打印行的外观,请参阅文章"如何自定义DXGrid打印外观"。

就复选框(CheckBox)而言,如果您想用有意义的文本表示来取代标准的复选框打印外观,则可将TextEdit放入单元格的显示模板内,再通过一个转换器将其文本属性绑定到单元格值上(该转换器会返回适当的文本)。

[XAML]

<local:BoolToTextConverter x:Key="BoolToTextConverter" TrueText="Avaliable" FalseText="NotAvaliable"/>

<Style x:Key="CheckEditColumnPrintingStyle" TargetType="dxe:CheckEdit" BasedOn="{StaticResource {dxgt:TableViewThemeKey ResourceKey=DefaultPrintCellStyle}}">
<Style.Setters>
<Setter Property="dxp:ExportSettings.TargetType" Value="Panel"/>
<Setter Property="DisplayTemplate">
<Setter.Value>
<ControlTemplate TargetType="dxe:CheckEdit">
<dxe:TextEdit Text="{Binding Value, Converter={StaticResource BoolToTextConverter}}"/>
</ControlTemplate>
</Setter.Value>
</Setter>
</Style.Setters>
</Style>

在WPF中完成这项任务的另一种方法就是在显示模板中定义触发器,然后将其绑定到编辑器的IsCheked属性上,再通过触发器setter处理单元格文本。在这种情况下,无需任何后置代码。

[XAML]

<ControlTemplate TargetType="dxe:CheckEdit">
<dxe:TextEdit Name="Text"/>
<ControlTemplate.Triggers>
<Trigger Property="IsChecked" Value="True">
<Setter Property="Text" Value="Avaliable" TargetName="Text"/>
</Trigger>
<Trigger Property="IsChecked" Value="False">
<Setter Property="Text" Value="Not avaliable" TargetName="Text"/>
</Trigger>
</ControlTemplate.Triggers>
</ControlTemplate>

注:在Silverlight中没有触发器。因此,上述方法只能在WPF应用程序中使用。

如果您在某些单元格中使用了多行编辑器(例如MemoEdit),在打印过程中有必要将文本封装到编辑器中,对单元格进行渲染。该解决方案与上文所述的方案类似。您可将TextEdit放入单元格的显示模板中,将其文本属性绑定到单元格值上,然后将编辑器的TextWrapping属性设置为渲染(Wrap)。

[XAML]

<Style x:Key="MemoColumnPrintingStyle" TargetType="dxe:MemoEdit" BasedOn="{StaticResource {dxgt:TableViewThemeKey ResourceKey=DefaultPrintCellStyle}}">
<Style.Setters>
<Setter Property="dxp:ExportSettings.TargetType" Value="Panel"/>
<Setter Property="DisplayTemplate">
<Setter.Value>
<ControlTemplate TargetType="dxe:MemoEdit">
<dxe:TextEdit Text="{Binding Value}"
IsPrintingMode="True"
TextWrapping="Wrap"/>
</ControlTemplate>
</Setter.Value>
</Setter>
</Style.Setters>
</Style>
本站文章除注明转载外,均为本站原创或翻译
欢迎任何形式的转载,但请务必注明出处,尊重他人劳动成果
转载请注明:文章转载自:DevExpress控件中文网 [https://www.devexpresscn.com/]
本文地址:https://www.devexpresscn.com/post/290.html
扫码咨询
电话咨询
023-68661681
返回
顶部