128 lines
2.8 KiB
Markdown
128 lines
2.8 KiB
Markdown
# DialogHelper 使用指南
|
||
|
||
## 文件位置
|
||
|
||
`src/Utils/DialogHelper.cs`
|
||
|
||
## 用途
|
||
|
||
统一处理对话框的 Owner 设置和置顶显示，解决 Navisworks 插件环境中的窗口焦点问题。
|
||
|
||
## 核心方法
|
||
|
||
### 1. SetOwnerSafely - 安全设置Owner（推荐）
|
||
|
||
```csharp
|
||
// 场景：在 ViewModel 中创建对话框
|
||
var dialog = new MyDialog();
|
||
DialogHelper.SetOwnerSafely(dialog);
|
||
dialog.Show(); // 或 dialog.ShowDialog();
|
||
```
|
||
|
||
**特点**：
|
||
- 自动查找可用的 Owner 窗口
|
||
- 处理 Navisworks 插件环境的特殊情况
|
||
- 捕获异常，不会导致程序崩溃
|
||
|
||
### 2. ShowDialog - 显示模态对话框（完整处理）
|
||
|
||
```csharp
|
||
// 场景：显示需要返回结果的模态对话框
|
||
var dialog = new MyInputDialog();
|
||
bool? result = DialogHelper.ShowDialog(dialog);
|
||
```
|
||
|
||
### 3. ShowMessageBox - 显示消息框
|
||
|
||
```csharp
|
||
// 场景：显示错误提示或确认对话框
|
||
DialogHelper.ShowMessageBox(
|
||
"操作成功完成",
|
||
"提示",
|
||
MessageBoxButton.OK,
|
||
MessageBoxImage.Information
|
||
);
|
||
```
|
||
|
||
### 4. SetWin32Owner - 强制置顶到Navisworks主窗口
|
||
|
||
```csharp
|
||
// 场景：对话框必须置顶到Navisworks主窗口（极少数情况）
|
||
var dialog = new MyDialog();
|
||
DialogHelper.SetWin32Owner(dialog);
|
||
dialog.Show();
|
||
```
|
||
|
||
## 使用示例
|
||
|
||
### 示例1：ViewModel中显示非模态对话框
|
||
|
||
```csharp
|
||
private MyDialog _myDialog;
|
||
|
||
private void ShowMyDialog()
|
||
{
|
||
if (_myDialog != null && _myDialog.IsVisible)
|
||
{
|
||
_myDialog.Activate();
|
||
return;
|
||
}
|
||
|
||
_myDialog = new MyDialog();
|
||
DialogHelper.SetOwnerSafely(_myDialog); // ✅ 使用工具方法
|
||
_myDialog.Show();
|
||
|
||
_myDialog.Closed += (s, e) => _myDialog = null;
|
||
}
|
||
```
|
||
|
||
### 示例2：显示确认对话框
|
||
|
||
```csharp
|
||
private bool ConfirmDelete()
|
||
{
|
||
var result = DialogHelper.ShowMessageBox(
|
||
"确定要删除此路径吗？",
|
||
"确认删除",
|
||
MessageBoxButton.YesNo,
|
||
MessageBoxImage.Warning
|
||
);
|
||
|
||
return result == MessageBoxResult.Yes;
|
||
}
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **不要在构造函数中设置 Owner**：
|
||
```csharp
|
||
// ❌ 错误
|
||
public MyDialog()
|
||
{
|
||
InitializeComponent();
|
||
this.Owner = Application.Current.MainWindow; // 可能抛出异常
|
||
}
|
||
|
||
// ✅ 正确：在外部设置
|
||
var dialog = new MyDialog();
|
||
DialogHelper.SetOwnerSafely(dialog);
|
||
```
|
||
|
||
2. **非模态对话框也需要设置 Owner**：
|
||
```csharp
|
||
// 即使是 Show() 而非 ShowDialog()，也需要设置 Owner
|
||
var dialog = new MyDialog();
|
||
DialogHelper.SetOwnerSafely(dialog); // 确保正确置顶
|
||
dialog.Show();
|
||
```
|
||
|
||
3. **XAML 中不要设置 Owner**：
|
||
```xml
|
||
<!-- ❌ 错误 -->
|
||
<Window ...
|
||
Owner="{x:Static Application.Current.MainWindow}">
|
||
|
||
<!-- ✅ 正确：XAML中不设置，代码中设置 -->
|
||
<Window ...>
|
||
```
|