颜色命令
重要
新式打印平台是 Windows 与打印机通信的首选方式。 建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (PSA) 来自定义 Windows 10 和 11 中的打印体验，以便进行打印机设备开发。
有关详细信息，请参阅新式打印平台和打印支持应用设计指南。
本主题介绍用于打印的颜色命令，其中包括以下部分：
用于选择主要背景色的命令
用于控制打印机调色板的命令
用于选择模式画笔的命令
所有命令都使用命令条目格式来指定。
用于选择主要背景色的命令
下表中的打印机命令适用于不支持可编程调色板的打印机，如平面彩色打印机（如点阵打印机）和某些调色板打印机（如早期的喷墨打印机）。
| 命令 | 说明 | 注释 |
|---|---|---|
| CmdSelectBlackColor | 用于选择黑色背景色的命令。 | 可选 |
| CmdSelectBlueColor | 用于选择蓝色背景色的命令。 | 可选 |
| CmdSelectCyanColor | 用于选择青色背景色的命令。 | 可选 |
| CmdSelectGreenColor | 用于选择绿色背景色的命令。 | 可选 |
| CmdSelectMagentaColor | 用于选择洋红色背景色的命令。 | 可选 |
| CmdSelectRedColor | 用于选择红色背景色的命令。 | 可选 |
| CmdSelectYellowColor | 用于选择黄色背景色的命令。 | 可选 |
| CmdSelectWhiteColor | 用于选择白色背景色的命令。 | 可选 |
用于控制打印机调色板的命令
下表中的打印机命令被支持可编程调色板的打印机用于前景（文本和矢量）打印和光栅打印。
| 命令 | 说明 | 注释 |
|---|---|---|
| CmdBeginPaletteDef | 用于初始化调色板定义的命令。 | 可选。 如未指定，则无需初始化调色板定义。 |
| CmdEndPaletteDef | 用于结束调色板定义的命令。 | 可选。 如未指定，则不需要命令来结束调色板定义。 可以指定 Order 属性。 如果未使用，则使用与最近为 ColorMode 功能执行的选项选择命令相关联的 Order 属性。 |
| CmdBeginPaletteReDef | 用于初始化调色板重新定义的命令。 | 可选。 如未指定，则无需初始化调色板重新定义。 |
| CmdEndPaletteReDef | 用于结束调色板重新定义的命令。 | 可选。 如未指定，则不需要命令来结束调色板重新定义。 |
| CmdDefinePaletteEntry | 用于定义调色板项的命令。 | 如果打印机支持调色板，则其为必填。 在 24 BPP 模式下，Unidrv 允许 PaletteSize 为 1 的调色板。 这样，GPD 开发人员就可以为他们的设备直接执行 RGB 颜色选择命令。 为此，请将 PaletteSize 设置为 1，并在 CmdDefinePaletteEntry 命令中指定选择颜色命令。 还必须指定 CmdSelectPaletteEntry 命令，但可以定义为 NULL 命令。 |
| CmdRedefinePaletteEntry | 用于重新定义调色板项的命令。 | 可选。 如未指定，则 CmdDefinePaletteEntry 将被用于重新定义调色板条目。 |
| CmdSelectPaletteEntry | 用于选择一个调色板条目作为当前颜色的命令。 | 如果打印机支持调色板，则其为必填。 |
用于选择模式画笔的命令
下表中的打印机命令由支持下载和选择图案画笔的打印机使用。
| 命令 | 说明 | 注释 |
|---|---|---|
| CmdDownloadPattern | 用于将画笔图案传送到打印机的命令。 | 可选。 如已指定，则还必须指定 CmdSelectPattern。 |
| CmdSelectBlackBrush | 用于将纯黑色画笔作为当前画笔的命令。 | 如果打印机支持画笔，则此项为必填。 |
| CmdSelectPattern | 用于选择下载的画笔模式的命令。 | 可选。 如已指定，则还必须指定 CmdDownloadPattern。 |
| CmdSelectWhiteBrush | 用于选择纯白色画笔作为当前画笔的命令。 | 可选 |