DialogPropertyValueEditor 类

项目
05/28/2012

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

PropertyEntry 对象的所有对话框编辑逻辑的容器。

继承层次结构

System.Object
Microsoft.Windows.Design.PropertyEditing.PropertyValueEditor
Microsoft.Windows.Design.PropertyEditing.DialogPropertyValueEditor

命名空间： Microsoft.Windows.Design.PropertyEditing
程序集： Microsoft.Windows.Design.Interaction（在 Microsoft.Windows.Design.Interaction.dll 中）

语法

声明
Public Class DialogPropertyValueEditor _
    Inherits PropertyValueEditor

public class DialogPropertyValueEditor : PropertyValueEditor

public ref class DialogPropertyValueEditor : public PropertyValueEditor

type DialogPropertyValueEditor =  
    class
        inherit PropertyValueEditor
    end

public class DialogPropertyValueEditor extends PropertyValueEditor

DialogPropertyValueEditor 类型公开以下成员。

构造函数

	名称	说明
	DialogPropertyValueEditor()	初始化 DialogPropertyValueEditor 类的新实例。
	DialogPropertyValueEditor(DataTemplate, DataTemplate)	初始化 DialogPropertyValueEditor 类的新实例。

页首

属性

	名称	说明
	DialogEditorTemplate	获取或设置 DataTemplate，它由特定于宿主的对话框承载，并且其 DataContext 设置为 PropertyValue。
	InlineEditorTemplate	获取或设置用于内联编辑器的 DataTemplate。（继承自 PropertyValueEditor。）

页首

方法

	名称	说明
	Equals	确定指定的 Object 是否等于当前的 Object。（继承自 Object。）
	Finalize	允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。（继承自 Object。）
	GetHashCode	用作特定类型的哈希函数。（继承自 Object。）
	GetType	获取当前实例的 Type。（继承自 Object。）
	MemberwiseClone	创建当前 Object 的浅表副本。（继承自 Object。）
	ShowDialog	当 DialogEditorTemplate 为 nulla null reference (Nothing in Visual Basic) 并且用户已经调用对话框时调用。
	ToString	返回表示当前对象的字符串。（继承自 Object。）

页首

备注

使用 DialogPropertyValueEditor 类可显示一个具有关联对话框编辑器的内联编辑器。

DialogPropertyValueEditor 类可以包含一个用于对话框编辑器的 DataTemplate，或包含在调用对话框时要调用的自定义逻辑。

使用 DataTemplate 中的 EditModeSwitchButton 来调用自定义 DialogPropertyValueEditor 类。

可以提供在宿主对话框中显示的 DataTemplate，也可重写 ShowDialog 方法，这允许重用现有对话框或系统对话框。

下面的列表显示用来确定是使用 DataTemplate 还是 ShowDialog 方法的规则。

如果 DialogEditorTemplate 属性不为 nulla null reference (Nothing in Visual Basic)，则该 DataTemplate 承载在特定于宿主的对话框中，该对话框提供宿主样式。不调用 ShowDialog。
如果 DialogEditorTemplate 属性为 nulla null reference (Nothing in Visual Basic)，则调用 ShowDialog 虚方法并且您可以重写此方法来显示任何对话框。

示例

下面的代码示例演示如何创建一个对话框属性值编辑器，当在“属性”窗口中单击自定义的**“文件名”**属性时，该编辑器将显示一个“打开文件”对话框。有关更多信息，请参见如何：创建对话框属性值编辑器。

using System;
using System.ComponentModel;
using System.Windows;
using Microsoft.Windows.Design.Metadata;
using Microsoft.Windows.Design.PropertyEditing;
using Microsoft.Win32;

namespace CustomControlLibrary.Design
{
    public class FileBrowserDialogPropertyValueEditor : DialogPropertyValueEditor
    {
        private EditorResources res = new EditorResources();

        public FileBrowserDialogPropertyValueEditor()
        {
            this.InlineEditorTemplate = res["FileBrowserInlineEditorTemplate"] as DataTemplate;
        }

        public override void ShowDialog(
            PropertyValue propertyValue,
            IInputElement commandSource)
        {
            OpenFileDialog ofd = new OpenFileDialog();
            ofd.Multiselect = false;

            if (ofd.ShowDialog() == true)
            {
                propertyValue.StringValue = ofd.FileName;
            }
        }
    }
}

<ResourceDictionary xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:PropertyEditing="clr-namespace:Microsoft.Windows.Design.PropertyEditing;assembly=Microsoft.Windows.Design.Interaction"
                    xmlns:Local="clr-namespace:CustomControlLibrary.Design"
                    x:Class="CustomControlLibrary.Design.EditorResources">

    <DataTemplate x:Key="FileBrowserInlineEditorTemplate">
        <Grid>
            <Grid.ColumnDefinitions>
                <ColumnDefinition Width="1*"/>
                <ColumnDefinition Width="Auto"/>
            </Grid.ColumnDefinitions>
            <TextBox Grid.Column="0" Text="{Binding StringValue}"/>
            <PropertyEditing:EditModeSwitchButton Grid.Column="1"/>
        </Grid>
    </DataTemplate>

</ResourceDictionary>