如何使用PDF格式文件作为图标来源？

福昕PDF SDK 软件开发工具包 | 福昕PDF SDK 软件开发工具包 > 福昕PDF SDK(Plug-in)

标签:
PDF图标,按钮图标,暗黑模式,皮肤

如何使用PDF格式文件作为图标来源？

福昕知识库
2025-10-27

在给按钮添加图标时，除了可以使用常见的位图(比如.bmp\.png等)，也可以将图标导出为PDF格式来使用。

使用.pdf格式作为图标的一个优势，是可以在更改编辑器主题色时，图标颜色可以跟随变化，而位图格式的图标做不到这个效果，差异如下图所示：

使用PDF作为图标来源的步骤如下：

1.PDF图标文件准备:

多页设计：单个 PDF 文件可包含多页，每页对应一个图标；
尺寸要求：建议为每个按钮图标准备两种尺寸 ——32×32 像素（用于常规显示）和 16×16 像素（用于缩略或紧凑显示）；
书签设置：
- 每页 PDF 需添加唯一书签（支持通过书签跳转至对应页）；
- 后续接口将通过传入书签名指定使用 PDF 的某一页作为图标（示例见下图）。

浅色和暗夜：建议为同一个按钮图标，准备浅色和暗夜两种模式

2.通过调用 FRRibbonElementSetPDFImage 接口实现 PDF 图标的设置，示例代码如下

  
   // 1. 创建图标管理器，指定PDF文件来源（需分别设置浅色/暗黑模式的文件路径）
   //同一个图标的浅色和暗夜的图标书签名需要保持一致
FRPDFBitmapMgrCreate("testPDFImage", 
                     L"D:/XXX/RibbonButton_Icon_浅色.pdf", 
                     L"D:/XXX/RibbonButton_Icon_暗夜.pdf");

// 2. 按按钮名称获取Ribbon元素
FR_RibbonElement fr_ElementButtonHighlight = FRRibbonPanelGetElementByName(hRibbonPanel, m_ControlButtonName);

// 3. 为按钮设置PDF图标管理器
FRRibbonElementSetPDFImageParentName(fr_ElementButtonHighlight, "testPDFImage");

// 4. 通过书签名指定使用的PDF页（分别对应32×32和16×16尺寸）
FRRibbonElementSetPDFImage(fr_ElementButtonHighlight, 
                           L"RibbonButton_Icon_001_32", 
                           L"RibbonButton_Icon_001_16");

// （可选）设置鼠标悬停时的图标替换色
// FS_COLORREF color = RGB(255, 215, 0);

PDF文档如何设置数字签名？

如何将彩色PDF一键转为黑白版？

PDF转word因权限限制报错：any unknown error occurs.

PDFViewCtrl中如何隐藏文本选中菜单

PDF文档如何设置数字签名？

如何将彩色PDF一键转为黑白版？

PDF转word因权限限制报错：any unknown error occurs.

PDFViewCtrl中如何隐藏文本选中菜单

【福昕管理控制台】自动停用功能常见问题解答

如何通过示例 Demo生成license-key.js？

如何去除PDF中的水印？

版式识别功能Layout Recognition功能Demo简介

自v2025.2.1和v14.0.1版本开始以及之后的版本，如何获取到msi的包

云文档列表右键菜单与程序语言不一致

PDF文档如何设置数字签名？

如何使用PDF格式文件作为图标来源？

如何将彩色PDF一键转为黑白版？

PDF转word因权限限制报错：any unknown error occurs.

PDFViewCtrl中如何隐藏文本选中菜单

【福昕管理控制台】自动停用功能常见问题解答

如何通过示例 Demo生成license-key.js？

如何去除PDF中的水印？

版式识别功能Layout Recognition功能Demo简介

自v2025.2.1和v14.0.1版本开始以及之后的版本，如何获取到msi的包