AddSoundAnnotationFromFile

注释与热点链接

描述

本页描述了 PDFlibPas 中属于“AddSoundAnnotationFromFile”主题的 注释与热点链接。API 名称、参数、类名、文件名和字面量完全按照它们在 Delphi 库和 DLL 入口点中出现的形式保留。

调用该函数之前，请仔细查阅语法、参数和返回值。

语法

Delphi

Function TPDFlib.AddSoundAnnotationFromFile(Left, Top, Width, Height: Double; Const SoundFileName: WideString; Const Title, Contents: WideString; Options: Integer): Integer;

参数

Left/Top/Width/Height 用于将扬声器图标放置在所选页面上。SoundFileName 是一个未压缩的 PCM WAV 文件，每样本 8 或 16 位，单声道或立体声。Title 和 Contents 为该注释贴上标签。Options 为保留项；请传入 0。

返回值

返回新的 Sound 注释的从 1 开始的索引，如果文件不是未压缩的 PCM WAV，则返回 0。

备注

采样通过 /E /Signed 编码（ISO 32000-1 §13.3）被嵌入到 /Sound 流中：16 位采样以大端（big-endian）存储，8 位采样经中点移位处理为有符号形式。使用 GetAnnotSoundToFile 或 GetAnnotSoundToString 回读声音。需要 PDF 1.2；文档版本会自动提升。