如何仿照Revit API的TaskDialog类为实例化后的窗口编程添加按钮

实现方案说明 #

优先推荐你采用预定义通用按钮+Flags枚举控制可见性的方案，维护成本更低，也完全适配WPF的数据绑定需求，你要的Revit TaskDialog调用体验也可以1:1复现。如果有特殊自定义按钮需求，再补充动态生成按钮的能力即可。

步骤1：定义基础枚举 #

首先封装通用按钮枚举和返回结果枚举，和Revit API的使用习惯对齐：

// 按钮枚举，带Flags特性支持位运算组合
[Flags]
public enum CustomDialogButtons
{
    None = 0,
    Ok = 1 << 0,
    Cancel = 1 << 1,
    Close = 1 << 2,
    Apply = 1 << 3,
    // 可按需扩展其他通用按钮
}

// 窗口返回结果枚举
public enum CustomDialogResult
{
    None,
    Ok,
    Cancel,
    Close,
    Apply
}

步骤2：WPF窗口XAML布局 #

提前把所有通用按钮放到布局容器中，默认设为隐藏，同时预留自定义按钮的占位容器：

<Window x:Class="YourNamespace.CustomDialog"
        Title="{Binding Title}"
        SizeToContent="WidthAndHeight">
    <Grid Margin="16">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*" MinHeight="100"/>
            <RowDefinition Height="Auto"/>
        </Grid.RowDefinitions>
        <!-- 主文本内容区 -->
        <TextBlock Grid.Row="0" Text="{Binding MainContent}" TextWrapping="Wrap" Margin="0 0 0 12"/>
        <!-- 列表框区，支持绑定业务数据 -->
        <ListBox Grid.Row="1" ItemsSource="{Binding ListItems}" Margin="0 0 0 16" MinWidth="300"/>
        <!-- 按钮容器 -->
        <StackPanel Grid.Row="2" Orientation="Horizontal" HorizontalAlignment="Right" Spacing="8">
            <Button x:Name="OkBtn" Content="确定" Visibility="Collapsed" Click="OkBtn_Click"/>
            <Button x:Name="CancelBtn" Content="取消" Visibility="Collapsed" Click="CancelBtn_Click"/>
            <Button x:Name="CloseBtn" Content="关闭" Visibility="Collapsed" Click="CloseBtn_Click"/>
            <Button x:Name="ApplyBtn" Content="应用" Visibility="Collapsed" Click="ApplyBtn_Click"/>
            <!-- 自定义按钮占位容器，动态添加的按钮放在这里 -->
            <StackPanel x:Name="CustomButtonContainer" Orientation="Horizontal" Spacing="8"/>
        </StackPanel>
    </Grid>
</Window>

步骤3：窗口后台逻辑实现 #

编写依赖属性关联枚举值和按钮可见性，同时暴露自定义按钮添加方法：

public partial class CustomDialog : Window
{
    // 通用按钮依赖属性，值变更时自动刷新按钮可见性
    public static readonly DependencyProperty CommonButtonsProperty = DependencyProperty.Register(
        nameof(CommonButtons), typeof(CustomDialogButtons), typeof(CustomDialog), 
        new PropertyMetadata(CustomDialogButtons.None, OnCommonButtonsChanged));

    public CustomDialogButtons CommonButtons
    {
        get => (CustomDialogButtons)GetValue(CommonButtonsProperty);
        set => SetValue(CommonButtonsProperty, value);
    }

    public string MainContent { get; set; }
    public IEnumerable ListItems { get; set; }
    public CustomDialogResult Result { get; private set; } = CustomDialogResult.None;

    public CustomDialog(string title)
    {
        InitializeComponent();
        Title = title;
        DataContext = this;
    }

    private static void OnCommonButtonsChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is not CustomDialog dialog) return;
        var buttons = (CustomDialogButtons)e.NewValue;
        // 按枚举值控制对应按钮可见性
        dialog.OkBtn.Visibility = buttons.HasFlag(CustomDialogButtons.Ok) ? Visibility.Visible : Visibility.Collapsed;
        dialog.CancelBtn.Visibility = buttons.HasFlag(CustomDialogButtons.Cancel) ? Visibility.Visible : Visibility.Collapsed;
        dialog.CloseBtn.Visibility = buttons.HasFlag(CustomDialogButtons.Close) ? Visibility.Visible : Visibility.Collapsed;
        dialog.ApplyBtn.Visibility = buttons.HasFlag(CustomDialogButtons.Apply) ? Visibility.Visible : Visibility.Collapsed;
    }

    // 暴露自定义按钮添加方法，业务侧可按需调用
    public void AddCustomButton(string content, Action clickAction)
    {
        var btn = new Button { Content = content };
        btn.Click += (s, e) => clickAction?.Invoke();
        CustomButtonContainer.Children.Add(btn);
    }

    // 通用按钮点击逻辑
    private void OkBtn_Click(object sender, RoutedEventArgs e)
    {
        Result = CustomDialogResult.Ok;
        DialogResult = true;
        Close();
    }

    private void CancelBtn_Click(object sender, RoutedEventArgs e)
    {
        Result = CustomDialogResult.Cancel;
        DialogResult = false;
        Close();
    }

    // 其他按钮点击逻辑同理实现即可
}

步骤4：业务侧调用方式 #

和Revit TaskDialog的使用习惯完全一致：

var dialog = new CustomDialog("示例窗口");
dialog.MainContent = "这是测试的窗口内容";
dialog.ListItems = new List<string> { "选项1", "选项2", "选项3" };
// 组合需要显示的通用按钮
dialog.CommonButtons = CustomDialogButtons.Ok | CustomDialogButtons.Cancel;
// 按需添加自定义按钮
dialog.AddCustomButton("导出数据", () => { /* 自定义业务逻辑 */ });

if (dialog.ShowDialog() == true)
{
    var res = dialog.Result;
    // 处理窗口返回结果
}

两种实现方案对比 #

• 预定义按钮+控制可见性：优点是样式统一，不需要额外处理Tab顺序、焦点、绑定逻辑，维护成本极低，覆盖90%以上的通用场景，是优先选择的方案
• 完全动态生成按钮：仅适合需要大量非通用自定义按钮、枚举无法覆盖所有场景的情况，需要额外处理样式、事件绑定、布局逻辑，开发成本更高，一般不需要采用

如果考虑WinForms实现，逻辑完全一致，仅控件的可见性属性、布局API有差异，你有数据绑定需求的话优先选择WPF即可。

内容的提问来源于stack exchange，提问作者pmackni