PowerBuilder 中常用全局对象 / 元素的简易列表

PowerBuilder中常用的全局对象/元素可按功能分为以下几类：

一、系统内置全局对象

• SQLCA：默认数据库事务对象，用于数据库操作，包含DBMS、SQLCode等连接参数和执行结果属性，提供Connect()、Disconnect()等方法。
• Message：用于窗口间数据传递，可通过StringParm传递字符串、DoubleParm传递数值，Processed属性控制消息处理状态。
• Error：捕获运行时错误，记录Number（错误号）、Text（错误描述）、Object（错误来源）等信息。
• Application：代表应用程序实例，可设置Title、Icon等属性，通过SetIdleTimeout()设置超时，GetApplication()获取实例。

二、自定义全局用户对象（常用设计）

• n_global：作为全局变量容器，存储系统路径、当前用户信息、配置参数等。
• n_trans：继承自Transaction，扩展数据库事务功能，如自动重连、SQL日志、批量操作函数。
• n_utility：封装通用工具函数，如字符串处理、日期转换、加密解密等。
• n_config：负责配置管理，处理读写.ini文件、注册表操作等。
• n_log：提供日志记录功能，包含WriteLog()、GetLogPath()等方法。
• n_api：用于调用系统API，如获取磁盘ID等Windows API调用。

三、全局数据容器

• 全局结构（Structure）：存储关联数据组，例如s_user（用户ID/姓名/权限）、s_system（系统参数）。
• 全局变量（Global Variable）：保存简单全局状态，如gs_username（当前用户名）、gb_debug（调试开关）。
• 全局数组（Global Array）：用于批量数据存储，如ga_departments（科室列表）。

四、全局函数/方法

• 全局函数（Global Function）：可直接调用，无所属对象，例如gf_connect_db()（数据库连接）、gf_msgbox()（通用提示）。
• 共享函数（Shared Function）：属于用户对象，无需实例化即可调用，如n_string.of_trim()（字符串处理）。

使用原则：

• 优先用自定义用户对象（如n_global）封装全局资源，减少零散变量。
• 系统内置对象（如SQLCA、Message）遵循默认用法，避免过度修改。
• 全局资源需控制访问权限，敏感操作（如数据库连接）通过方法封装。
• 避免大量全局变量，防止命名冲突和状态混乱。