C++ Builder 参考手册 ➙ Vcl::Forms ➙ TApplication
Vcl::Forms::TApplication 是 VCL 应用程序类
- 简介
- 成员
• 属性
• 方法
• 事件
• 数据
一. Vcl::Forms::TApplication 简介
- 继承关系：
System::TObject
⠀╙ System::Classes::TPersistent
⠀⠀⠀┗ System::Classes::TComponent
⠀⠀⠀⠀⠀└ Vcl::Forms::TApplication - 头文件：
#include - 命名空间：
Vcl::Forms - Vcl::Forms::TApplication 是 VCL 应用程序类，每个应用程序都有一个 TApplication 全局变量指针 Application，用于应用程序的消息和事件处理，应用程序的一些属性等。
二. Vcl::Forms::TApplication 成员
1. Vcl::Forms::TApplication 属性
| 属性 | 类型 | 说明 |
|---|---|---|
| public: | ||
| ActionUpdateDelay | int | 延时更新 Action，为了避免 CPU 使用率太高 |
| Active | bool | 应用程序是否被激活并且获得了输入焦点 |
| ActiveFormHandle | HWND | 应用程序当前活动窗口的句柄 |
| AllowTesting | bool | VCL 内部使用的属性，调试程序时使用的 |
| AutoDragDocking | bool | 拖拽的窗口是否自动停放 |
| BiDiKeyboard | UnicodeString | 是否使用中东语言的键盘 (从右到左方向书写文字) |
| BiDiMode | TBiDiMode | 是否运行在中东地区的系统 (从右到左方向书写文字) |
| CurrentHelpFile | UnicodeString | 应用程序当前使用的帮助说明文件 |
| DefaultFont | TFont * | 应用程序默认的字体 |
| DialogHandle | HWND | 用于处理非 VCL 对话框消息 |
| EnumAllWindowsOnActivateHint | bool | VCL 内部使用的属性，用于处理鼠标悬停提示信息 |
| ExeName | UnicodeString | 应用程序 (.exe 文件) 完整的路径和文件名 |
| Handle | HWND | 应用程序内部使用的用于处理应用程序消息的窗口句柄 |
| HelpFile | UnicodeString | 应用程序默认的帮助说明文件 |
| HelpSystem | _di_IHelpSystem | 应用程序帮助管理 IHelpSystem 接口 |
| Hint | UnicodeString | 鼠标悬停时的提示信息 |
| HintColor | TColor | 鼠标悬停提示信息框的颜色 |
| HintHidePause | int | 鼠标移出隐藏悬停提示信息的延时时间 |
| HintPause | int | 鼠标移入显示悬停提示信息的延时时间 |
| HintShortCuts | bool | 鼠标悬停提示信息是否包含快捷键提示 |
| HintShortPause | int | 如果已经显示了其他鼠标悬停信息，这个悬停信息延时多长时间显示 |
| Icon | TIcon * | 应用程序在任务栏上显示的图标 |
| IsMetropolisUI | bool | 是否仿 Windows 8 的 Metro 风格界面 |
| MainForm | TForm * | 主窗口 |
| MainFormHandle | HWND | 主窗口句柄 |
| MainFormOnTaskBar | bool | 在任务栏上显示主窗口 |
| ModalLevel | int | 当前显示了多少个模态窗口 |
| ModalPopupMode | TPopupMode | 模态窗口显示方式 |
| NonBiDiKeyboard | UnicodeString | 非 BiDiMode 的键盘 (不是中东地区的从右到左书写文字) |
| PopupControlWnd | HWND | 处理弹出窗口消息的窗口句柄 |
| ShowHint | bool | 启用或禁用鼠标悬停的提示信息 |
| ShowMainForm | bool | 在应用程序启动时是否显示主窗口 |
| Terminated | bool | 应用程序是否正在退出 |
| Title | UnicodeString | 应用程序显示在任务栏上的标题内容 |
| UpdateFormatSettings | bool | 当系统参数设置改变时是否自动更新格式参数 |
| UpdateMetricSettings | bool | 当系统参数设置改变时是否自动更新提示信息的字体和标题的字体 |
| TComponent:: | 从 System::Classes::TComponent 继承过来的 | |
| __published: | 从 System::Classes::TComponent 继承过来的 | |
| Name | TComponentName | 组件的名称 |
| Tag | NativeInt | 储存一个 NativeInt 类型的数据 |
| public: | 从 System::Classes::TComponent 继承过来的 | |
| ComObject | _di_IInterface | 控件的 COM 接口对象 |
| Components | TComponent *[int Index] | 这个组件容纳的第 Index 个子组件 |
| ComponentCount | int | 这个组件容纳的子组件的个数 |
| ComponentIndex | int | 这个控件是他的拥有者的第几个子组件 |
| ComponentState | TComponentState | 组件的状态 |
| ComponentStyle | TComponentStyle | 组件的样式 |
| DesignInfo | int | 提供给画面编辑器的信息 (设计时的位置) |
| Observers | TObservers * | 组件 LiveBindings 的 TObservers 对象 |
| Owner | TComponent | 组件的拥有者 |
| VCLComObject | void * | 组件的 COM 组件对象 |
2. Vcl::Forms::TApplication 方法
| 方法 | 说明 |
|---|---|
| public: | |
| ActivateHint | 弹出一个屏幕坐标点位置的控件的提示信息 |
| AddPopupForm | 把一个 Form 添加为应用程序的弹出窗口 |
| ApplyBiDiKeyboardLayout | 应用中东地区从右到左书写文字的键盘 |
| ApplyNonBiDiKeyboardLayout | 应用普通的从左到右书写文字的键盘 |
| BringToFront | 把这个应用程序的窗口提到其他应用程序的前面 |
| CancelHint | 取消显示提示信息 |
| ControlDestroyed | 通知应用程序控件被销毁了 |
| CreateForm | 创建一个新的 Form |
| CreateHandle | 生成一个主窗口，如果没有 |
| DoApplicationIdle | 在一些事件里面处理消息队列里面的消息使用的 |
| ExecuteAction | 产生一个 OnActionExecute 消息 |
| HandleException | 应用程序默认的异常处理 |
| HandleMessage | 从消息队列里面提取出来一个消息来执行 |
| HelpCommand | 执行显示帮助说明的命令 |
| HelpContext | 根据 ID 显示帮助说明 |
| HelpJump | 根据名称显示帮助说明 |
| HelpKeyword | 根据关键字显示帮助说明 |
| HelpShowTableOfContents | 显示帮助的目录 |
| HideHint | 隐藏当前显示的提示信息 |
| HintMouseMessage | 用于鼠标在控件上移动时处理提示信息 |
| HookMainWindow | 用于把对话框的消息传递给主窗口 |
| HookSynchronizeWakeup | 用于线程同步，应用程序内部调用 |
| Initialize | 应用程序初始化 |
| IsRightToLeft | 是否使用中东地区的从右到左方向书写文字来调整界面显示 |
| MessageBox | 显示提示信息对话框 |
| Minimize | 应用程序最小化 |
| ModalFinished | 当模态窗口关闭时调用的 |
| ModalStarted | 当模态窗口打开时调用的 |
| NormalizeAllTopMosts | 所有总在最前端窗口变成普通位置窗口 |
| NormalizeTopMosts | 用于显示对话框时把总在最前端窗口变成普通位置窗口 |
| ProcessMessages | 处理消息队列里面的消息，在长时间循环里面调用这个方法可以避免界面卡住 |
| RemovePopupForm | 移除添加为应用程序弹出窗口的 Form |
| Restore | 应用程序窗口状态从最小化或最大化状态复原 |
| RestoreTopMosts | 恢复总在最前端属性的 Form 为总在最前端位置 |
| Run | 执行应用程序，处理消息循环，直到消息循环结束 |
| ShowException | 显示捕获到的异常 |
| TApplication | 构造函数 |
| ~TApplication | 析构函数 |
| Terminate | 应用程序结束运行 |
| UnhookMainWindow | 对话框处理结束，不需要让主窗口处理消息了 |
| UnhookSynchronizeWakeup | 结束处理线程同步 |
| UpdateAction | 产生一个 OnActionUpdate 事件，应用程序内部调用 |
| UseMetropolisUI | 使用仿 Windows 8 的 Metro 风格界面 |
| UseRightToLeftAlignment | 是否使用中东地区从右到左的对齐方式 |
| UseRightToLeftReading | 是否使用中东地区的从右到左的阅读方式 |
| UseRightToLeftScrollBar | 是否使用中东地区的从右到左的阅读方式的滚动条 |
| protected: | |
| Idle | 当应用程序进入空闲状态时，调用这个方法产生 OnIdle 事件 |
| IsDlgMsg | 一个消息是否为对话框消息 |
| IsHintMsg | 一个消息是否为提示信息消息 |
| IsKeyMsg | 一个消息是否为键盘消息 |
| IsMDIMsg | 一个消息是否为 MDI 消息 |
| IsPreProcessMessage | 一个消息是否为预处理消息 |
| IsShortCut | 一个消息是否为键盘快捷键 |
| TComponent:: | 从 System::Classes::TComponent 继承过来的 |
| public: | 从 System::Classes::TComponent 继承过来的 |
| BeforeDestruction | 检查并调用 Destroying 方法 |
| BeginInvoke | 异步调用 AProc 或 AFunc |
| DestroyComponents | 销毁所有容纳的子组件 |
| Destroying | 指示这个组件和它所有的子组件都将被销毁 |
| EndFunctionInvoke | 等待异步执行的函数的返回值 |
| EndInvoke | 等待异步执行完成 |
| ExecuteAction | 执行一个 Action |
| FindComponent | 通过名称查找子组件 |
| FreeNotification | 把这个组件将要被销毁的信息通知给 AComponent |
| FreeOnRelease | 调用 COM 接口的 Release 方法时，会调用这个方法 |
| GetEnumerator | 返回一个可以枚举子组件的对象 |
| GetParentComponent | 返回 Parent (容器) 组件 |
| GetNamePath | 返回在 Object Inspector 属性面板里面的名称 |
| HasParent | 获取这个组件是否放在了容器里面 |
| InsertComponent | 添加一个子组件 |
| IsImplementorOf | 返回当前组件所支持的 COM 接口的引用 |
| operator () | 类型转换操作符，转为 _di_IInterface 类型 或者 _di_IInterfaceComponentReference 类型 |
| ReferenceInterface | 建立或移除内部链接来通知这个组件 |
| RemoveComponent | 移除一个子组件 |
| RemoveFreeNotification | 把 FreeNotification 的通知信息去掉 |
| SafeCallException | 处理 COM 接口的异常 |
| SetSubComponent | 设置或清除 ComponentStyle 里面的 csSubComponent 样式 |
| UpdateAction | 更新 Action 的状态 |
| protected: | 从 System::Classes::TComponent 继承过来的 |
| _AddRef | 增加 COM 接口的引用计数 |
| AsyncSchedule | 把异步执行添加到主线程的队列里 |
| CanObserve | 返回 LiveBindings 的数据绑定类型是否支持 |
| ChangeName | 给组件改名 |
| DefineProperties | 把非 __published: 属性和数据存入流中 |
| GetChildren | 枚举所有的子组件 |
| GetChildOwner | 返回子组件的 Owner |
| GetChildParent | 返回子组件的 Parent |
| GetDeltaStreams | 初始化从父类继承过来的组件成员时使用。 |
| GetIDsOfNames | 通过名字获取 DISPID，用于调用 Invoke 方法 |
| GetTypeInfoCount | 返回 IDispatch 的类型信息个数 |
| GetTypeInfo | 返回 IDispatch 的类型信息 |
| GetObservers | Observers 属性利用这个方法返回属性值 |
| GetOwner | 返回对象的拥有者 |
| Invoke | 访问 COM 对象的属性和调用 COM 对象的方法 |
| Loaded | 当 Form 读取到内存的时候，初始化这个组件 |
| Notification | AComponent 发过来的创建或移除消息，会调用这个方法 |
| ObserverAdded | 添加 LiveBindings 数据绑定时会调用这个方法 |
| PaletteCreated | 组件在组件面板里面创建的时候，会调用这个方法 |
| QueryInterface | 返回当前组件所支持的 COM 接口的引用 |
| ReadState | 从流中读取组件的状态 |
| _Release | 减少 COM 接口的引用计数 / 销毁对象 |
| RemoveFreeNotifications | 通知所有的 Owner 这个组件要被销毁了 |
| SetAncestor | 清除或设置 ComponentState 属性里面的 csAncestor 状态 |
| SetChildOrder | 调整子组件的顺序 |
| SetDesigning | 清除或设置 ComponentState 属性里面的 csDesigning 状态 |
| SetDesignInstance | 清除或设置 ComponentState 属性里面的 csDesignInstance 状态 |
| SetInline | 清除或设置 ComponentState 属性里面的 csInline 状态 |
| SetName | 给属性 Name 赋值调用这个方法来修改组件名 |
| SetParentComponent | 设置组件的 Parent (容器组件) |
| Updated | 清除 ComponentState 属性里面的 csUpdating 状态 |
| Updating | 设置 ComponentState 属性里面的 csUpdating 状态 |
| UpdateRegistry | 在注册表里面添加 COM 组件类型库信息 |
| ValidateContainer | 检查组件是否可以放入一个组件当作子组件 |
| ValidateInsert | 检查一个组件是否可以放入当前的组件作为子组件 |
| ValidateRename | 给组件改名时调用，检查名称是否有效 |
| WriteState | 把组件的状态写入流中 |
| TPersistent:: | 从 System::Classes::TPersistent 继承过来的 |
| public: | 从 System::Classes::TPersistent 继承过来的 |
| Assign | 把 Source 对象的所有的属性和数据赋值到当前对象 |
| protected: | 从 System::Classes::TPersistent 继承过来的 |
| AssignTo | 把当前对象的所有属性和数据都赋值到 Dest 对象 |
| TObject:: | 从 System::TObject 继承过来的 |
| public: | 从 System::TObject 继承过来的 |
| AfterConstruction | 在构造函数结束的时候会自动调用 AfterConstruction |
| ClassInfo | 返回运行时类型信息表 (RTTI table) |
| ClassName | 获取类名，不包含命名空间的类名字符串 |
| ClassNameIs | 判断类名是否为参数指定的字符串 |
| ClassParent | 返回父类的类型信息 |
| ClassType | 返回类的类型信息 |
| CleanupInstance | 清除长字符串、Variants、接口变量等 |
| DefaultHandler | 默认的消息处理 |
| Dispatch | 处理消息的函数 |
| DisposeOf | 强制销毁对象 |
| Equals | 比较当前对象和 Obj 对象是否相同 |
| FieldAddress | 通过成员名称返回成员的地址 |
| Free | 销毁对象 (Delphi) |
| FreeInstance | 释放 NewInstance 分配的内存 |
| GetHashCode | 返回对象的 hash 值 |
| GetInterface | 获取指定的接口 |
| GetInterfaceEntry | 获取接口项目 |
| GetInterfaceTable | 获取接口表 |
| InheritsFrom | 当前对象的类是否从 AClass 继承过来的 |
| InitInstance | 初始化成员，给他们清零 |
| InstanceSize | 返回给实例数据分配内存需要多少字节数 |
| MethodAddress | 通过名称返方法的地址 |
| MethodName | 通过方法的地址返回名称 |
| NewInstance | 给实例分配内存，并且返回新的实例的地址 |
| QualifiedClassName | 返回包含命名空间的类名 |
| ToString | 转为字符串 |
| UnitName | 返回类所在的命名空间 |
| UnitScope | 返回类所在的命名空间 |
3. Vcl::Forms::TApplication 事件
| 事件 | 说明 |
|---|---|
| public: | |
| OnActionExecute | 当一个 Action 执行 Execute 方法时，Action 并没有处理 OnExecute 事件时 TApplication 产生的事件 |
| OnActionUpdate | 当一个 Action 执行 Update 方法时，Action 并没有处理 OnUpdate 事件时 TApplication 产生的事件 |
| OnActivate | 应用程序为活动状态，由其他应用程序切换到这个应用程序 |
| OnDeactivate | 应用程序不在活动状态，由这个应用程序切换到其他应用程序了 |
| OnException | 应用程序有未捕获的异常 |
| OnGetActiveFormHandle | 读取 ActiveFormHandle 属性时产生的事件 |
| OnGetMainFormHandle | 读取 MainFormHandle 属性时产生的事件 |
| OnHelp | 当需要显示帮助说明时产生的事件 |
| OnHint | 当鼠标悬停在控件上需要显示提示信息时产生的事件 |
| OnIdle | 当应用程序进入空闲状态时产生的事件 |
| OnMessage | 当应用程序收到 Windows 消息时产生的事件 |
| OnMinimize | 当应用程序最小化时产生的事件 |
| OnModalBegin | 当模态对话框打开时产生的事件 |
| OnModalEnd | 当模态对话框关闭时产生的事件 |
| OnRestore | 当应用程序从最小化或最大化状态恢复时产生的事件 |
| OnSettingChange | 当收到操作系统发来的系统参数改变消息时产生的事件 |
| OnShortCut | 当用户键入快捷键时产生的事件 |
| OnShowHint | 当应用程序需要显示提示信息时产生的事件 |
| TComponent:: | 从 System::Classes::TComponent 继承过来的 |
| protected: | 从 System::Classes::TComponent 继承过来的 |
| OnGetDeltaStreams | 初始化从父类继承过来的组件成员时产生的事件 |
4. Vcl::Forms::TApplication 数据成员
| 数据 | 类型 | 说明 |
|---|---|---|
| TComponent:: | 从 System::Classes::TComponent 继承过来的 | |
| protected: | 从 System::Classes::TComponent 继承过来的 | |
| FComponentStyle | TComponentStyle | 储存组件样式，由组件内部使用 |
相关：
- Vcl::Forms::Application
- Vcl::Forms::Screen
- Vcl::Forms::TForm
- Vcl::Forms::TScreen
- Vcl::Forms::TMonitor
- Vcl::Clipbrd::TClipboard
- System::Sysutils::FormatSettings
- System::Sysutils::Languages
- System::Classes::TComponent
- System::Classes::TPersistent
- System::TObject
- VCL 类继承关系
C++ Builder 参考手册 ➙ Vcl::Forms ➙ TApplication