Class MessageBoxComponent

消息框组件类 - 用于显示确认、警告等消息对话框

这个类继承自基础对话框组件，专门用于显示需要用户确认的消息。它提供了标准的"是/否/取消"按钮组合，并处理用户的选择结果。

主要功能：

显示消息内容和确认按钮
处理用户的选择（是/否/取消）
支持键盘快捷键操作
返回用户的选择结果

MessageBox

Hierarchy (View Summary)

BaseDialogComponent
- MessageBoxComponent

Index

Constructors

constructor

new MessageBoxComponent(): MessageBoxComponent
构造函数 - 初始化消息框组件

调用父类构造函数并初始化消息框特有的属性：
- result: 用户选择的结果（"yes"/"no"/undefined）
- message: 要显示的消息内容
Returns MessageBoxComponent
Overrides BaseDialogComponent.constructor
- Defined in ui/DialogMessage.ts:593

Properties

`Static`styles

styles: r = ...

定义组件样式 - 使用静态属性

`Static`properties

properties: {
dialogTitle: { type: StringConstructor };
draggable: { type: BooleanConstructor };
} = ...

定义响应式属性 - 使用静态属性

dialogTitle

dialogTitle: string

draggable

draggable: boolean

The draggable property of the HTMLElement interface gets and sets a Boolean primitive indicating if the element is draggable.

MDN Reference

isDragging

isDragging: boolean

dragStartX

dragStartX: number

dragStartY

dragStartY: number

dialogStartX

dialogStartX: number

dialogStartY

dialogStartY: number

offsetX

offsetX: number

offsetY

offsetY: number

mouseX

mouseX: number

mouseY

mouseY: number

result

result: string

message

message: string

renderRoot

renderRoot: any

Accessors

isSuspended

get isSuspended(): boolean
检查对话框是否处于暂停状态

Returns boolean
Inherited from BaseDialogComponent.isSuspended
- Defined in ui/DialogMessage.ts:459

`Static`observedAttributes

get observedAttributes(): any[]
Returns any[]
Inherited from BaseDialogComponent.observedAttributes
- Defined in vendor/lit-element-base.ts:103

updateComplete

get updateComplete(): any
Returns any
Inherited from BaseDialogComponent.updateComplete
- Defined in vendor/lit-element-base.ts:306

Methods

mousemove_callback

mousemove_callback(event: MouseEvent): void
鼠标移动事件回调 - 跟踪鼠标位置

当鼠标在对话框内移动时，记录当前鼠标的屏幕坐标。这些坐标用于在对话框关闭后恢复鼠标位置，确保用户体验的连续性。
Parameters
- event: MouseEvent
  鼠标移动事件对象
Returns void
Inherited from BaseDialogComponent.mousemove_callback
- Defined in ui/DialogMessage.ts:145

top_mousedown_callback

top_mousedown_callback(event: MouseEvent): void
顶部标题栏鼠标按下事件 - 开始拖拽

当用户在对话框顶部标题栏按下鼠标时触发，初始化拖拽操作的相关状态。
Parameters
- event: MouseEvent
  鼠标按下事件对象
Returns void
Inherited from BaseDialogComponent.top_mousedown_callback
- Defined in ui/DialogMessage.ts:163

globalMouseMove

globalMouseMove(event: MouseEvent): void
全局鼠标移动事件 - 处理拖拽移动
Parameters
- event: MouseEvent
  鼠标移动事件对象
Returns void
Inherited from BaseDialogComponent.globalMouseMove
- Defined in ui/DialogMessage.ts:200

globalMouseUp

globalMouseUp(event: MouseEvent): void
全局鼠标释放事件 - 结束拖拽
Parameters
- event: MouseEvent
  鼠标释放事件对象
Returns void
Inherited from BaseDialogComponent.globalMouseUp
- Defined in ui/DialogMessage.ts:211

handleDragMove

handleDragMove(event: MouseEvent): void
处理拖拽移动 - 更新对话框位置
Parameters
- event: MouseEvent
  鼠标事件对象
Returns void
Inherited from BaseDialogComponent.handleDragMove
- Defined in ui/DialogMessage.ts:226

isDraggableArea

isDraggableArea(element: Element): boolean
检查元素是否为可拖拽区域
Parameters
- element: Element
  要检查的元素
Returns boolean
是否为可拖拽区域
Inherited from BaseDialogComponent.isDraggableArea
- Defined in ui/DialogMessage.ts:251

waitUpdated

waitUpdated(): Promise<void>
等待组件更新完成 - 异步等待DOM更新

返回一个Promise，该Promise在组件完成下一次更新后resolve。这对于需要确保DOM已经更新的操作非常有用。

Returns Promise<void>
在组件更新完成后resolve的Promise
Inherited from BaseDialogComponent.waitUpdated
- Defined in ui/DialogMessage.ts:271

_startBaseDialog

_startBaseDialog(e: any): Promise<void>
启动基础对话框 - 对话框显示的主要流程

这是对话框显示的核心方法，处理完整的对话框生命周期：
1. 设置对话框标题
2. 将对话框添加到指定容器
3. 记录当前鼠标位置
4. 等待DOM更新完成
5. 显示对话框
6. 清理和恢复鼠标事件
Parameters
- e: any
Returns Promise<void>
Inherited from BaseDialogComponent._startBaseDialog
- Defined in ui/DialogMessage.ts:296

fireMouseMove

fireMouseMove(): void
触发鼠标移动事件 - 恢复鼠标状态

在对话框关闭后，模拟一个鼠标移动事件来恢复画布的鼠标状态。这确保了对话框关闭后，画布能够正确响应鼠标位置。

Returns void
Inherited from BaseDialogComponent.fireMouseMove
- Defined in ui/DialogMessage.ts:313

showBaseDialog

showBaseDialog(): Promise<boolean>
显示基础对话框 - 显示模态对话框并等待关闭

这个方法负责实际显示对话框并返回一个Promise，该Promise在对话框关闭时resolve。这允许调用者异步等待对话框的完成。

Returns Promise<boolean>
在对话框关闭时resolve为true的Promise
Inherited from BaseDialogComponent.showBaseDialog
- Defined in ui/DialogMessage.ts:333

close_click_callback

close_click_callback(): void
关闭按钮点击回调 - 处理对话框关闭按钮点击

当用户点击对话框右上角的关闭按钮时调用。它会派发一个"escape"事件（表示用户取消操作），然后关闭对话框。

Returns void
Inherited from BaseDialogComponent.close_click_callback
- Defined in ui/DialogMessage.ts:354

close

close(): void
关闭对话框 - 程序化关闭对话框

提供一个简单的方法来程序化地关闭对话框，不派发任何额外的事件。

Returns void
Inherited from BaseDialogComponent.close
- Defined in ui/DialogMessage.ts:368

open

open(): void
打开对话框 - 程序化打开模态对话框

提供一个简单的方法来程序化地打开对话框，使用 HTML
元素的 showModal() 方法。

Returns void
Inherited from BaseDialogComponent.open
- Defined in ui/DialogMessage.ts:381

suspend

suspend(): void
暂停对话框 - 临时关闭模态对话框，允许用户操作CAD界面

使用场景：在对话框中需要让用户在CAD界面上选择实体或拾取点时调用。暂停后对话框会关闭，用户可以与CAD界面交互。交互完成后调用 resume() 恢复对话框。

Returns void
Example
```
// 暂停对话框
this.baseDialog?.suspend();

// 让用户在CAD界面选择实体
const result = await Engine.editor.getSelections(options);

// 恢复对话框
this.baseDialog?.resume();
```
Inherited from BaseDialogComponent.suspend
- Defined in ui/DialogMessage.ts:417

resume

resume(): void
恢复对话框 - 重新以模态方式打开对话框

在调用 suspend() 后，用户完成CAD界面交互后调用此方法恢复对话框。对话框会恢复到暂停前的位置。

Returns void
Inherited from BaseDialogComponent.resume
- Defined in ui/DialogMessage.ts:438

cleanupDragState

cleanupDragState(): void
清理拖拽状态 - 移除全局事件监听器

在对话框关闭时调用，确保不会遗留全局事件监听器

Returns void
Inherited from BaseDialogComponent.cleanupDragState
- Defined in ui/DialogMessage.ts:468

firstUpdated

firstUpdated(): void
首次更新完成后的回调

Returns void
Overrides BaseDialogComponent.firstUpdated
- Defined in ui/DialogMessage.ts:602

updated

updated(): void
组件更新完成回调 - 在组件DOM更新后触发

重写父类的updated方法，在消息框组件更新完成后派发"updated"事件通知外部。

Returns void
Overrides BaseDialogComponent.updated
- Defined in ui/DialogMessage.ts:617

yesClick_callback

yesClick_callback(): void
"是"按钮点击回调 - 处理确认操作

当用户点击"是"按钮时，设置结果为"yes"并关闭对话框。这表示用户确认了操作。

Returns void
- Defined in ui/DialogMessage.ts:628

yesKeyDown_callback

yesKeyDown_callback(e: KeyboardEvent): void
"是"按钮键盘事件回调 - 处理空格键确认

当"是"按钮获得焦点时，用户按下空格键也可以触发确认操作。这提供了更好的键盘可访问性。
Parameters
- e: KeyboardEvent
  键盘事件对象
Returns void
- Defined in ui/DialogMessage.ts:642

noClick_callback

noClick_callback(): void
"否"按钮点击回调 - 处理拒绝操作

当用户点击"否"按钮时，设置结果为"no"并关闭对话框。这表示用户拒绝了操作。

Returns void
- Defined in ui/DialogMessage.ts:657

cancelClick_callback

cancelClick_callback(): void
"取消"按钮点击回调 - 处理取消操作

当用户点击"取消"按钮时，设置结果为undefined并关闭对话框。这表示用户取消了操作，不做任何改变。

Returns void
- Defined in ui/DialogMessage.ts:669

showMessageBox

showMessageBox(e: any): Promise<string>
显示消息框 - 消息框的主要显示方法

这是消息框组件的核心方法，负责完整的消息框显示流程：
1. 设置消息内容
2. 将组件添加到对话框容器
3. 等待DOM更新并设置消息文本
4. 启动基础对话框显示
5. 清理并返回用户选择结果
Parameters
- e: any
Returns Promise<string>
用户选择结果："yes"/"no"/undefined
- Defined in ui/DialogMessage.ts:689

keyDown_callback

keyDown_callback(e: KeyboardEvent): Promise<void>
键盘按键事件回调 - 处理键盘快捷键

支持以下键盘快捷键：
- S键或Y键：相当于点击"是"按钮
- N键：相当于点击"否"按钮
这提供了更快速的用户交互方式。
Parameters
- e: KeyboardEvent
  键盘事件对象
Returns Promise<void>
- Defined in ui/DialogMessage.ts:715

initKeyEvent

initKeyEvent(): void
初始化键盘事件 - 预留的键盘事件初始化方法

这个方法目前为空，可能用于未来扩展键盘事件的初始化逻辑。

Returns void
- Defined in ui/DialogMessage.ts:732

render

render(): { _$litType$: any; strings: any; values: any[] }
渲染消息框模板 - 定义消息框的HTML结构

返回消息框的HTML模板，包括：
1. 基础对话框容器
2. 消息显示区域
3. 按钮操作区域（保存、不保存、取消）
注意：模板中包含键盘事件监听，支持快捷键操作。
Returns { _$litType$: any; strings: any; values: any[] }
消息框的HTML模板
Overrides BaseDialogComponent.render
- Defined in ui/DialogMessage.ts:746

`Static`addInitializer

addInitializer(t: any): void
Parameters
- t: any
Returns void
Inherited from BaseDialogComponent.addInitializer
- Defined in vendor/lit-element-base.ts:100

`Static`createProperty

createProperty(
    t: any,
    e?: {
        attribute: boolean;
        type: StringConstructor;
        converter: {
            toAttribute(t: any, e: any): any;
            fromAttribute(t: any, e: any): any;
        };
        reflect: boolean;
        hasChanged: (t: any, e: any) => boolean;
    },
): void
Parameters
- t: any
- e: {
      attribute: boolean;
      type: StringConstructor;
      converter: {
          toAttribute(t: any, e: any): any;
          fromAttribute(t: any, e: any): any;
      };
      reflect: boolean;
      hasChanged: (t: any, e: any) => boolean;
  } = y
Returns void
Inherited from BaseDialogComponent.createProperty
- Defined in vendor/lit-element-base.ts:106

`Static`getPropertyDescriptor

getPropertyDescriptor(
    t: any,
    e: any,
    s: any,
): {
    get(): any;
    set(e: any): void;
    configurable: boolean;
    enumerable: boolean;
}
Parameters
- t: any
- e: any
- s: any
Returns { get(): any; set(e: any): void; configurable: boolean; enumerable: boolean }
Inherited from BaseDialogComponent.getPropertyDescriptor
- Defined in vendor/lit-element-base.ts:113

`Static`getPropertyOptions

getPropertyOptions(t: any): any
Parameters
- t: any
Returns any
Inherited from BaseDialogComponent.getPropertyOptions
- Defined in vendor/lit-element-base.ts:137

`Static`_$Ei

_$Ei(): void
Returns void
Inherited from BaseDialogComponent._$Ei
- Defined in vendor/lit-element-base.ts:140

`Static`finalize

finalize(): void
Returns void
Inherited from BaseDialogComponent.finalize
- Defined in vendor/lit-element-base.ts:145

`Static`finalizeStyles

finalizeStyles(t: any): any[]
Parameters
- t: any
Returns any[]
Inherited from BaseDialogComponent.finalizeStyles
- Defined in vendor/lit-element-base.ts:165

`Static`_$Eu

_$Eu(t: any, e: any): string
Parameters
- t: any
- e: any
Returns string
Inherited from BaseDialogComponent._$Eu
- Defined in vendor/lit-element-base.ts:173

_$Ev

_$Ev(): void
Returns void
Inherited from BaseDialogComponent._$Ev
- Defined in vendor/lit-element-base.ts:180

addController

addController(t: any): void
Parameters
- t: any
Returns void
Inherited from BaseDialogComponent.addController
- Defined in vendor/lit-element-base.ts:184

removeController

removeController(t: any): void
Parameters
- t: any
Returns void
Inherited from BaseDialogComponent.removeController
- Defined in vendor/lit-element-base.ts:188

_$E_

_$E_(): void
Returns void
Inherited from BaseDialogComponent._$E_
- Defined in vendor/lit-element-base.ts:192

enableUpdating

enableUpdating(t: any): void
Parameters
- t: any
Returns void
Inherited from BaseDialogComponent.enableUpdating
- Defined in vendor/lit-element-base.ts:217

attributeChangedCallback

attributeChangedCallback(t: any, e: any, s: any): void
Parameters
- t: any
- e: any
- s: any
Returns void
Inherited from BaseDialogComponent.attributeChangedCallback
- Defined in vendor/lit-element-base.ts:225

_$EC

_$EC(t: any, e: any): void
Parameters
- t: any
- e: any
Returns void
Inherited from BaseDialogComponent._$EC
- Defined in vendor/lit-element-base.ts:228

_$AK

_$AK(t: any, e: any): void
Parameters
- t: any
- e: any
Returns void
Inherited from BaseDialogComponent._$AK
- Defined in vendor/lit-element-base.ts:237

requestUpdate

requestUpdate(t?: any, e?: any, s?: any): void
Parameters
- Optionalt: any
- Optionale: any
- Optionals: any
Returns void
Inherited from BaseDialogComponent.requestUpdate
- Defined in vendor/lit-element-base.ts:249

P

P(t: any, e: any, s: any): void
Parameters
- t: any
- e: any
- s: any
Returns void
Inherited from BaseDialogComponent.P
- Defined in vendor/lit-element-base.ts:255

_$ET

_$ET(): Promise<boolean>
Returns Promise<boolean>
Inherited from BaseDialogComponent._$ET
- Defined in vendor/lit-element-base.ts:258

scheduleUpdate

scheduleUpdate(): void
Returns void
Inherited from BaseDialogComponent.scheduleUpdate
- Defined in vendor/lit-element-base.ts:268

performUpdate

performUpdate(): void
Returns void
Inherited from BaseDialogComponent.performUpdate
- Defined in vendor/lit-element-base.ts:271

willUpdate

willUpdate(t: any): void
Parameters
- t: any
Returns void
Inherited from BaseDialogComponent.willUpdate
- Defined in vendor/lit-element-base.ts:295

_$AE

_$AE(t: any): void
Parameters
- t: any
Returns void
Inherited from BaseDialogComponent._$AE
- Defined in vendor/lit-element-base.ts:296

_$EU

_$EU(): void
Returns void
Inherited from BaseDialogComponent._$EU
- Defined in vendor/lit-element-base.ts:303

getUpdateComplete

getUpdateComplete(): any
Returns any
Inherited from BaseDialogComponent.getUpdateComplete
- Defined in vendor/lit-element-base.ts:309

shouldUpdate

shouldUpdate(t: any): boolean
Parameters
- t: any
Returns boolean
Inherited from BaseDialogComponent.shouldUpdate
- Defined in vendor/lit-element-base.ts:312

createRenderRoot

createRenderRoot(): ShadowRoot
Returns ShadowRoot
Inherited from BaseDialogComponent.createRenderRoot
- Defined in vendor/lit-element-base.ts:640

update

update(t: any): void
Parameters
- t: any
Returns void
Inherited from BaseDialogComponent.update
- Defined in vendor/lit-element-base.ts:645

connectedCallback

connectedCallback(): void
Returns void
Inherited from BaseDialogComponent.connectedCallback
- Defined in vendor/lit-element-base.ts:657

disconnectedCallback

disconnectedCallback(): void
Returns void
Inherited from BaseDialogComponent.disconnectedCallback
- Defined in vendor/lit-element-base.ts:661

Class MessageBoxComponent

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns MessageBoxComponent

Properties

Staticstyles

Staticproperties

dialogTitle

draggable

isDragging

dragStartX

dragStartY

dialogStartX

dialogStartY

offsetX

offsetY

mouseX

mouseY

result

message

renderRoot

Accessors

isSuspended

Returns boolean

StaticobservedAttributes

Returns any[]

updateComplete

Returns any

Methods

mousemove_callback

Parameters

Returns void

top_mousedown_callback

Parameters

Returns void

globalMouseMove

Parameters

Returns void

globalMouseUp

Parameters

Returns void

handleDragMove

Parameters

Returns void

isDraggableArea

Parameters

Returns boolean

waitUpdated

Returns Promise<void>

_startBaseDialog

Parameters

Returns Promise<void>

fireMouseMove

Returns void

showBaseDialog

Returns Promise<boolean>

close_click_callback

Returns void

close

Returns void

open

Returns void

suspend

Returns void

Example

resume

Returns void

cleanupDragState

Returns void

firstUpdated

Returns void

updated

Returns void

yesClick_callback

`Static`styles

`Static`properties

`Static`observedAttributes

`Static`addInitializer

`Static`createProperty

`Static`getPropertyDescriptor

`Static`getPropertyOptions

`Static`_$Ei

`Static`finalize

`Static`finalizeStyles

`Static`_$Eu