PowerBuilder中自定义纸张功能的纯代码实现

本文还有配套的精品资源，点击获取

简介：在PowerBuilder开发中，自定义纸张功能对于满足特定打印需求至关重要。本文将详细介绍如何通过纯代码方式实现自定义纸张的读取、设置、增加和删除操作。涵盖了调用Windows API读取系统纸张列表，设置数据窗口对象的纸张大小，添加和删除自定义纸张规格等要点。同时，也会探讨相关的数据窗口和打印机对象代码的使用和编译。

1. 系统纸张列表的读取

在信息系统中，读取系统纸张列表是一项基础而关键的操作。它不仅涉及到硬件层面，也与软件的纸张管理模块紧密相连。本章旨在解释如何从系统层面获取纸张列表，并为后续章节中纸张的设置和管理奠定基础。

1.1 理解系统纸张列表的概念

系统纸张列表是操作系统中预定义纸张尺寸和自定义纸张规格的集合。它为应用程序提供了纸张选择的依据。每个纸张规格都包含了纸张的尺寸、来源（如纸盒）等信息。

1.2 纸张列表读取的实现

从系统读取纸张列表通常涉及调用特定的API函数。例如，在Windows系统中，可以利用 EnumPrintProcessorDatatypes 函数来枚举打印机支持的纸张类型。这一过程的代码示例如下：

HANDLE hPrinter;
DWORDLevels = 1, 
        cbNeeded, 
        pcDatatypes, 
        cbDatatypes = 0, 
        cbReturned = 0;

// 打开打印机句柄
OpenPrinter(..., &hPrinter);

// 首先调用一次EnumPrintProcessorDatatypes以获取所需缓冲区大小
EnumPrintProcessorDatatypes(..., NULL, 0, &cbNeeded, &pcDatatypes);

if (cbNeeded != 0)
{
    LPBYTE pDatatypes = (LPBYTE)LocalAlloc(LPTR, cbNeeded);
    if (pDatatypes != NULL)
    {
        // 再次调用函数来填充缓冲区
        if (EnumPrintProcessorDatatypes(..., pDatatypes, cbNeeded, &cbReturned, &pcDatatypes))
        {
            // 此处添加处理纸张列表的代码
        }

        LocalFree(pDatatypes);
    }
}

ClosePrinter(hPrinter);

在这段代码中， EnumPrintProcessorDatatypes 函数第一次调用是为了确定所需缓冲区的大小，第二次调用则是为了实际获取纸张列表信息。开发者需要根据实际需求对获取到的纸张信息进行解析和处理。

2. 数据窗口纸张大小设置

在现代企业中，为了满足各种文档和报告的输出需求，对数据窗口中纸张大小的配置变得至关重要。纸张大小设置不仅仅是选择预设的A4或Letter格式，更包括了自定义纸张尺寸的增加以及对这些尺寸的管理。本章节将深入探讨数据窗口纸张大小设置的基本步骤，以及如何通过用户界面实现纸张设置。

2.1 数据窗口纸张设置的基本步骤

在数据窗口组件中设置纸张大小，首先需要了解如何访问数据窗口的属性，并在属性中配置纸张大小。这个过程可以分为两个主要步骤：访问数据窗口属性和纸张大小的配置方法。

2.1.1 数据窗口属性的访问

在PowerBuilder中，数据窗口对象的属性可以通过对象的属性编辑器进行访问和修改。用户可以通过以下步骤来访问数据窗口属性：

1. 首先在应用的画布上选中需要设置纸张大小的数据窗口控件。
2. 点击属性编辑器，可以在其中找到“纸张”相关的属性，例如纸张大小、纸张方向等。
3. 通过属性编辑器可以修改数据窗口的纸张设置，但这些设置目前只是在设计时的属性，并不会影响运行时的行为。

2.1.2 纸张大小的配置方法

要在运行时改变数据窗口的纸张大小，需要使用PowerBuilder提供的函数和属性。以下是一个基本的示例，展示如何使用PowerBuilder脚本语言来动态地设置纸张大小：

// 假设 dw_report 是数据窗口对象的名称
// 设置为A4纸张大小和纵向
dw_report.SetPaperSize('A4')
dw_report.SetPaperOrientation(1)

在这段代码中， SetPaperSize 函数用于设置纸张大小， SetPaperOrientation 用于设置纸张方向。这里的参数'1'代表纵向（Portrait），若要设置为横向（Landscape），可以使用参数'2'。

2.2 纸张设置的用户界面实现

用户界面（UI）是与用户交互的直接通道，提供一个直观易用的界面来完成纸张设置是用户体验的关键。用户界面的实现步骤可以分为两个主要部分：设计用户界面的逻辑和用户交互与纸张配置的关联。

2.2.1 设计用户界面的逻辑

在设计用户界面时，需要考虑以下几个关键元素：

• 纸张预设选择器：下拉列表框（DropDownList）或选项按钮组（RadioButtonGroup）可用来选择预设的纸张大小。
• 自定义纸张输入字段：文本输入框（UITextField）可以用来输入自定义纸张的宽度和高度。
• 预览按钮：用来预览当前纸张设置下的数据窗口外观。
• 应用按钮：用来确认纸张设置并应用到数据窗口。

2.2.2 用户交互与纸张配置的关联

为了将用户操作与纸张配置关联起来，需要使用事件处理程序。以下是一些核心步骤：

1. 当用户选择预设纸张大小时，触发一个事件，读取选择的纸张大小并将其应用到数据窗口。
2. 当用户输入自定义纸张尺寸时，需要进行有效性验证，然后将这些尺寸应用到数据窗口。
3. 在用户点击预览按钮时，应显示一个对话框或新窗口，展示数据窗口在所选纸张大小下的外观。
4. 用户点击应用按钮时，需要保存用户选择的纸张设置，并确保在打印预览和打印时使用正确的纸张参数。

为了实现以上功能，需要编写相应的事件处理脚本。例如，为预设选择器添加事件处理代码：

// 当用户选择下拉列表中的纸张大小时触发的事件处理代码
//假设下拉列表的名字是ddPaperSize
string ls_paper_size
ddPaperSize当选中项改变
    ls_paper_size = ddPaperSize.GetSelectedText()
    // 根据ls_paper_size的值设置纸张大小
    // 此处代码省略
end当选中项改变

在这一部分，我们讨论了数据窗口纸张大小设置的基本步骤，包括通过数据窗口属性的访问和纸张大小的配置方法，以及如何设计用户界面实现纸张设置，并关联用户交互。

下一部分将深入探讨如何添加自定义纸张规格，包括其基本逻辑和校验机制。

3. 自定义纸张规格的增加

3.1 添加自定义纸张的基本逻辑

3.1.1 认识自定义纸张的存储结构

在深入了解如何添加自定义纸张之前，我们需要先了解自定义纸张在系统中的存储结构。自定义纸张的信息通常存储在某个配置文件中，或者在数据库的特定表中。了解了存储结构，我们就可以按照这个结构来设计我们的添加逻辑。

示例存储结构 ：

1. 配置文件： custom_paper.cfg

   • paper_id ：纸张的唯一标识符。
   • name ：纸张的名称。
   • width ：纸张的宽度，通常以毫米为单位。
   • height ：纸张的高度，同样以毫米为单位。

2. 数据库表： custom_paper

   • paper_id ：整型字段，作为主键。
   • name ：字符型字段，存储纸张名称。
   • width ：浮点型字段，存储纸张宽度。
   • height ：浮点型字段，存储纸张高度。

3.1.2 编写添加自定义纸张的代码

在了解了存储结构之后，我们可以开始编写添加自定义纸张的代码。以下是一个简单的示例，演示如何向配置文件中添加一个新的自定义纸张规格。

示例代码 ：

import configparser

# 定义一个函数用于添加自定义纸张
def add_custom_paper(config, paper_id, name, width, height):
    # 确认配置文件已经加载
    if config.has_section('CustomPaper'):
        config['CustomPaper'][f'paper_id'] = paper_id
        config['CustomPaper'][f'name'] = name
        config['CustomPaper'][f'width'] = str(width)
        config['CustomPaper'][f'height'] = str(height)
    else:
        config.add_section('CustomPaper')
        add_custom_paper(config, paper_id, name, width, height)
    # 保存配置文件的改动
    with open('custom_paper.cfg', 'w') as configfile:
        config.write(configfile)

# 实例化配置解析器
config = configparser.ConfigParser()

# 调用函数，添加自定义纸张
add_custom_paper(config, '001', 'A4+', 216, 330)

代码逻辑解读 ：

• 首先导入 configparser 模块，用于解析和修改配置文件。
• 定义了 add_custom_paper 函数，它接受配置对象、纸张ID、名称、宽度和高度作为参数。
• 函数检查配置文件中是否已存在 CustomPaper 部分，如果不存在，则添加该部分。
• 更新 CustomPaper 部分的相应字段。
• 将更新后的配置信息写回文件。

3.2 自定义纸张的校验机制

3.2.1 纸张尺寸的有效性检查

在添加新的自定义纸张规格时，必须对输入的纸张尺寸进行有效性检查。以下是一个简单的示例，说明如何检查纸张尺寸的有效性。

示例代码 ：

def validate_paper_size(width, height):
    # 检查宽度和高度是否大于零
    if width <= 0 or height <= 0:
        raise ValueError("纸张尺寸必须大于零")
    # 检查是否在合理范围内，这里假设合理的尺寸范围为50mm x 50mm 到 1000mm x 1000mm
    if width < 50 or width > 1000 or height < 50 or height > 1000:
        raise ValueError("纸张尺寸超出合理范围")
    return True

# 使用validate_paper_size函数来校验尺寸
try:
    validate_paper_size(216, 330)
    print("尺寸有效")
except ValueError as e:
    print(e)

3.2.2 纸张名称的唯一性校验

除了纸张尺寸，纸张的名称也应该是唯一的。下面的示例代码演示了如何对纸张名称进行唯一性校验。

示例代码 ：

def check_paper_name_uniqueness(config, name):
    # 获取所有的纸张信息
    papers = config['CustomPaper']
    # 检查提供的纸张名称是否已被占用
    for paper_id in papers.keys():
        if papers[paper_id]['name'] == name:
            raise ValueError(f"纸张名称 '{name}' 已被占用，请使用其他名称")
    return True

# 假设我们已经有了config对象并且已经配置了自定义纸张
try:
    check_paper_name_uniqueness(config, 'A4+')
    print("纸张名称是唯一的")
except ValueError as e:
    print(e)

这两个校验步骤是添加自定义纸张过程中不可或缺的，确保了纸张信息的准确性和合法性。通过这些步骤，我们能够有效地维护纸张配置的一致性和有效性。

4. 自定义纸张的删除操作

在实际应用中，我们经常需要删除不再需要的自定义纸张规格。这一章节我们将深入讨论自定义纸张删除操作的实现步骤和异常处理机制。系统用户在删除纸张时可能会遇到各种异常情况，例如错误的纸张规格名称或系统权限限制等。因此，为了保证删除操作的安全性和准确性，必须实施相应的异常处理策略。

4.1 删除操作的实现步骤

4.1.1 定位并选中要删除的自定义纸张

首先，系统需要提供一个用户界面，允许用户通过列表或搜索功能找到他们想要删除的自定义纸张。这通常需要一个纸张列表，其中包含了纸张名称、尺寸等属性。

SELECT * FROM custom_paper_list WHERE name = '用户输入的纸张名称';

上述SQL语句用于从数据库中检索用户指定名称的纸张。在实际操作中，我们还需要确保数据库查询的安全性，防止SQL注入等风险。

4.1.2 执行删除动作并确认

在用户选中要删除的纸张后，系统应该弹出一个确认对话框，提示用户是否真的要删除选定的纸张规格。确认后，系统将调用删除函数，从数据库中移除该纸张的数据。

public void deleteCustomPaper(String paperName) {
    try {
        // 执行删除操作
        boolean success = paperDAO.deletePaperByName(paperName);
        if (success) {
            JOptionPane.showMessageDialog(null, "纸张删除成功");
        } else {
            JOptionPane.showMessageDialog(null, "删除失败，纸张不存在或已被删除");
        }
    } catch (Exception e) {
        // 异常处理
        JOptionPane.showMessageDialog(null, "删除过程中出现错误：" + e.getMessage());
    }
}

在上述Java代码示例中， paperDAO.deletePaperByName(paperName) 是一个DAO方法，负责删除数据库中对应的纸张记录。异常处理部分确保了即使发生错误，用户也会收到相应的提示。

4.2 删除操作的异常处理

4.2.1 处理删除过程中可能出现的错误

在删除操作中可能遇到的错误多种多样，如数据库连接失败、缺少权限等。这些错误都需要通过异常处理来捕获并给用户明确的错误信息。

try {
    // 尝试执行删除操作
} catch (SQLException e) {
    // 处理数据库异常
    if (e.getErrorCode() == 1442) {
        // 该记录已在数据库中删除
        JOptionPane.showMessageDialog(null, "该纸张规格已被其他用户删除");
    } else {
        // 数据库连接或操作出错
        JOptionPane.showMessageDialog(null, "数据库操作错误：" + e.getMessage());
    }
} catch (Exception e) {
    // 处理其他异常
    JOptionPane.showMessageDialog(null, "删除失败，错误：" + e.getMessage());
}

4.2.2 用户提示信息的设计与实现

合理的用户提示信息不仅能够提升用户体验，还能够帮助用户快速定位问题所在。设计提示信息时，应避免使用晦涩的技术术语，保持简洁明了。

// 用户提示信息模板
- 提示信息：{message}
- 错误类型：{errorType}
- 可能的原因：{possibleReason}

// 实现提示信息
private void showErrorDialog(String message, String errorType, String possibleReason) {
    String fullMessage = "发生错误：" + message + "\n错误类型：" + errorType + "\n可能的原因：" + possibleReason;
    JOptionPane.showMessageDialog(null, fullMessage);
}

在上述Java代码示例中，我们创建了一个错误信息展示的方法 showErrorDialog ，它接收三个参数：错误消息、错误类型和可能的原因，然后将它们组合成一个完整的错误提示信息展示给用户。

5. Windows API调用及 printer.pbl , printer.pbt , printer.pbw 文件的作用

在自定义纸张设置和管理中，有效地使用Windows API以及理解 printer.pbl , printer.pbt , printer.pbw 文件的作用是至关重要的。这些文件和API调用共同构成了PowerBuilder环境与Windows打印系统交互的基础。

5.1 Windows API在自定义纸张中的应用

5.1.1 API调用的基础知识

Windows API（应用程序编程接口）是一组预定义的函数、协议和工具，允许开发者创建应用程序与Windows操作系统进行交互。在自定义纸张管理中，API调用可以用来访问和配置打印相关的信息，比如添加新的打印驱动，获取系统上已安装的打印机列表等。

例如，Windows提供了 AddPrinterDriver 函数来安装一个打印驱动程序。当在PowerBuilder应用中集成自定义纸张设置时，可以调用该函数来添加支持特定纸张大小的新驱动。

5.1.2 API在纸张设置中的具体应用

具体到代码层面，使用API涉及到调用一系列的函数，比如 GetPrinter 函数可以用来获取打印机的当前配置信息，包括纸张大小和类型。

BOOL GetPrinter(
  HANDLE hPrinter,          // handle to printer
  DWORD Level,              // information level
  LPBYTE pPrinter,          // data buffer
  DWORD cbBuf,              // size of buffer
  LPDWORD pcbNeeded         // bytes returned
);

在PowerBuilder中，可以通过外部函数声明来调用Windows API。需要注意的是，正确设置函数参数和处理返回值对于程序的稳定性和功能实现至关重要。

5.2 printer.pbl , printer.pbt , printer.pbw 文件解析

5.2.1 printer.pbl 文件的功能与作用

printer.pbl 是一个PowerBuilder库文件，包含了专门用于打印操作的函数。这些函数多数会与Windows的打印API进行交互，例如创建打印作业、管理打印机队列等。

5.2.2 printer.pbt 文件的内容与操作

printer.pbt 文件是一个PowerBuilder模板文件，其中包含了用于打印功能的PowerBuilder脚本模板。这些模板可被用来快速生成具有标准打印功能的PowerBuilder对象。

5.2.3 printer.pbw 文件在PowerBuilder中的角色

printer.pbw 文件是PowerBuilder工作区文件，它存储了与打印相关的所有PowerBuilder对象的配置信息。当需要对打印环境进行配置或者部署打印相关的应用程序时， printer.pbw 文件是不可或缺的。

5.3 与Windows打印管理器的集成

5.3.1 打印管理器的访问方式

Windows打印管理器提供了一个集中的用户界面来管理和监控打印操作。通过PowerBuilder与Windows打印管理器的集成，可以实现从应用内部直接访问打印管理器的功能。

5.3.2 集成打印管理器的代码实现

在PowerBuilder中，可以通过执行Windows的 printui.dll 中定义的函数来访问打印管理器。这通常涉及到声明外部函数，然后调用这些函数以显示打印管理器界面。

Function boolean OpenPrinterQueue(string strPrinterName) Library "printui.dll" Alias for "OpenPrinterUIA"
Function boolean ShowPrinterProperties(string strPrinterName) Library "printui.dll" Alias for "ShowPrinterPropertySheetA"

5.3.3 集成过程中可能遇到的问题与解决方案

集成过程中可能遇到的常见问题是权限问题，比如无法显示打印管理器或者对打印机进行配置。解决这类问题，首先需要确保PowerBuilder应用程序以管理员权限运行。其次，要检查在调用函数时参数是否正确，以及是否有正确的权限调用相应的API。

最终，通过上述章节的介绍，我们可以看到在PowerBuilder环境中的自定义纸张管理不仅需要对API有深入的理解，还需要正确使用相关的PowerBuilder文件和对Windows打印管理器有充分的集成。这样的集成不仅使应用在纸张管理方面具有更大的灵活性，而且也为用户提供了更丰富的打印选项。

本文还有配套的精品资源，点击获取

简介：在PowerBuilder开发中，自定义纸张功能对于满足特定打印需求至关重要。本文将详细介绍如何通过纯代码方式实现自定义纸张的读取、设置、增加和删除操作。涵盖了调用Windows API读取系统纸张列表，设置数据窗口对象的纸张大小，添加和删除自定义纸张规格等要点。同时，也会探讨相关的数据窗口和打印机对象代码的使用和编译。

本文还有配套的精品资源，点击获取