---
name: "KySdkPrint"
section: "3"
platform: "linux"
package: "libkysdk-system"
version: "3.0.1.4-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/KySdkPrint"
---

# KySdkPrint(3)

生成打印信息dbus信息类 主要用来生成本地的所有打印机(包含可用打印机和不可用打印机)、获取本地的所有可用打印机(打印机处于idle状态)、 设置打印参数，每次设置会清除之前设置打印参数,这个设置是全局设置，设置了之后所有打印机都会用这个参数进行打印、 下载网络文件、打印本地文件、清除某个打印机的所有打印队列、获取当前打印机状态(状态不是实时更新)、 获取当前打印任务状态（发送打印任务之后下需要等待一会再获取状态,状态不是实时更新）、获取url内的文件名dbus信息

## NAME

KySdkPrint - 生成打印信息dbus信息类 主要用来生成本地的所有打印机(包含可用打印机和不可用打印机)、获取本地的所有可用打印机(打印机处于idle状态)、 设置打印参数，每次设置会清除之前设置打印参数,这个设置是全局设置，设置了之后所有打印机都会用这个参数进行打印、 下载网络文件、打印本地文件、清除某个打印机的所有打印队列、获取当前打印机状态(状态不是实时更新)、 获取当前打印任务状态（发送打印任务之后下需要等待一会再获取状态,状态不是实时更新）、获取url内的文件名dbus信息

## SYNOPSIS

\#include \<kysdkdbus.h\>

Inherits QObject.

### Public Slots

QStringList **getPrinterList** () const\
 获取本地的所有打印机(包含可用打印机和不可用打印机)  QStringList **getPrinterAvailableList** () const\
 获取本地的所有可用打印机(打印机处于idle状态)  void **setPrinterOptions** (int number\_up, const QString media, const QString number\_up\_layout, const QString sides) const\
 设置打印参数，每次设置会清除之前设置打印参数,这个设置是全局设置，设置了之后所有打印机都会用这个参数进行打印  int **getPrinterPrintLocalFile** (const QString printername, const QString filepath) const\
 打印本地文件  int **getPrinterCancelAllJobs** (const QString printername) const\
 清除某个打印机的所有打印队列  int **getPrinterStatus** (const QString printername) const\
 获取当前打印机状态(状态不是实时更新)  QString **getPrinterFilename** (const QString url) const\
 获取url内的文件名  int **getPrinterJobStatus** (const QString printername, int jobid) const\
 获取当前打印任务状态（发送打印任务之后下需要等待一会再获取状态,状态不是实时更新）  int **getPrinterDownloadRemoteFile** (const QString url, const QString filepath) const\
 下载网络文件

## Detailed Description

生成打印信息dbus信息类 主要用来生成本地的所有打印机(包含可用打印机和不可用打印机)、获取本地的所有可用打印机(打印机处于idle状态)、 设置打印参数，每次设置会清除之前设置打印参数,这个设置是全局设置，设置了之后所有打印机都会用这个参数进行打印、 下载网络文件、打印本地文件、清除某个打印机的所有打印队列、获取当前打印机状态(状态不是实时更新)、 获取当前打印任务状态（发送打印任务之后下需要等待一会再获取状态,状态不是实时更新）、获取url内的文件名dbus信息

## Public Slots

### QStringList KySdkPrint::getPrinterAvailableList () const \[slot\]

获取本地的所有可用打印机(打印机处于idle状态)

**Returns**

QStringList 本地的所有可用打印机名称列表

### int KySdkPrint::getPrinterCancelAllJobs (const QString printername) const \[slot\]

清除某个打印机的所有打印队列

**Parameters**

*printername* 打印机名

**Returns**

int 成功返回0,失败返回-1

### int KySdkPrint::getPrinterDownloadRemoteFile (const QString url, const QString filepath) const \[slot\]

下载网络文件

**Parameters**

*url* 要打印的url \
 *filepath* 保存的文件路径

**Returns**

int 打印作业的id

### QString KySdkPrint::getPrinterFilename (const QString url) const \[slot\]

获取url内的文件名

**Parameters**

*url* 路径

**Returns**

String 解析出来的函数名

### int KySdkPrint::getPrinterJobStatus (const QString printername, int jobid) const \[slot\]

获取当前打印任务状态（发送打印任务之后下需要等待一会再获取状态,状态不是实时更新）

**Parameters**

*printername* 打印机名 \
 *jobid* 打印作业的id

**Returns**

int 状态码

### QStringList KySdkPrint::getPrinterList () const \[slot\]

获取本地的所有打印机(包含可用打印机和不可用打印机)

**Returns**

QStringList 地的所有打印机名称列表

### int KySdkPrint::getPrinterPrintLocalFile (const QString printername, const QString filepath) const \[slot\]

打印本地文件

**Parameters**

*printername* 打印机名 \
 *filepath* 文件绝对路径

**Returns**

int 打印作业的id

@notice 虽然支持多种格式的打印，但是打印除pdf之外的格式打印的效果都不够好，建议打印pdf格式的文件 打印机处于stop状态函数返回0 格式不对的文件可以成功创建打印任务，但是打印不出来。什么叫格式不对，举个例子，比如当前要打印日志文件a.log, 然后把a.log改名叫a.pdf,这个时候a.pdf就变成了格式不对的文件，打印不出来了

### int KySdkPrint::getPrinterStatus (const QString printername) const \[slot\]

获取当前打印机状态(状态不是实时更新)

**Parameters**

*printername* 打印机名

**Returns**

int 状态码

## Author

Generated automatically by Doxygen for kysdkdbus.h from the source code.