Windows 窗体组件 > 产品 > XtraTreeList > 功能中心 > 数据呈现 > 预览区

预览区

XtraTreeList 提供了预览功能，允许每个节点显示预览区。预览区适用于显示给定记录的备注字段或自定义数据。预览区横跨树状列表的所有列，占用节点的整个宽度。预览区是只读的，不能被最终用户编辑。

下面的插图展示了一个显示了预览区的树状列表。

要显示预览区，则执行下列操作：

把 TreeListOptionsView.ShowPreview 属性设置为 true。
把 TreeList.PreviewFieldName 属性设置为提供预览区数据的字段。

预览区的高度 (以行表示) 是由 TreeList.PreviewLineCount 属性指定的。在下面的插图中，此属性值被设置为 2。

可以根据其内容自动计算预览区的高度。要执行此任务，则把 TreeListOptionsView.AutoCalcPreviewLineCount 属性设置为 true (请参阅第一幅插图)。

自定义预览

XtraTreeList 允许在预览区中显示自定义文本。要执行此任务，则接管 TreeList.GetPreviewText 事件。此事件的 GetPreviewTextEventArgs.PreviewText 参数允许为个别预览区指派自定义文本。

当打印 TreeList 控件时要提供预览区文本，则使用 TreeList.GetPrintPreviewText 事件。

也可以通过接管 TreeList.CustomDrawNodePreview 事件自定义绘制预览区。在预览区被绘制之前，此事件发生。要获得更多关于自定义绘制的信息，请参阅自定义绘制。

示例

下面的示例代码接管了 TreeList.GetPreviewText 事件。用于在节点的预览区中显示 Location 和 Budget 字段的取值。

下面的插图说明了示例代码的执行结果。

C#	复制代码
using DevExpress.XtraTreeList; private void treeList1_GetPreviewText(object sender, GetPreviewTextEventArgs e) { e.PreviewText = "Office Location: " + e.Node["Location"].ToString() + "; Phone: " + e.Node["Phone"].ToString(); }

复制代码

using DevExpress.XtraTreeList;

private void treeList1_GetPreviewText(object sender, GetPreviewTextEventArgs e) {
   e.PreviewText = "Office Location: " + e.Node["Location"].ToString() + "; Phone: " + 
     e.Node["Phone"].ToString();
}

Visual Basic	复制代码
Private Sub TreeList1_GetPreviewText(ByVal sender As Object, _ ByVal e As GetPreviewTextEventArgs) Handles TreeList1.GetPreviewText e.PreviewText = "Office Location: " + e.Node("Location") + "; Phone: " + e.Node("Phone") End Sub

Visual Basic

复制代码

Private Sub TreeList1_GetPreviewText(ByVal sender As Object, _
ByVal e As GetPreviewTextEventArgs) Handles TreeList1.GetPreviewText
   e.PreviewText = "Office Location: " + e.Node("Location") + "; Phone: " + e.Node("Phone")
End Sub

参阅

自定义绘制

就此主题发送反馈意见。