SetInformationA
文件屬性
描述
結尾的 A 表示 ANSI(char)DLL 進入點;ActiveX/COM 介面只提供 Unicode 形式。行為與 SetInformation 完全相同,字串參數依目前 SetAnsiMode 的字碼頁解讀
設定所選文件的屬性
CreationDate 與 ModDate(修改日期)屬性的日期格式應為:
D:YYYYMMDDHHmmSSOHH'mm'
where
YYYY shall be the year
MM 為月份(01-12)DD 為日(01-31)HH 為小時(00-23)
mm 為分鐘(00-59) SS 為秒(00-59)
O 為本地時間與世界時間(UT)的關係,使用 +、- 或 Z 字元
HH 後接所有格符號(APOSTROPHE,U+0027)('),表示與 UT 的時差絕對值,單位小時(00-23)
mm 後可接所有格符號(APOSTROPHE,U+0027)('),表示與 UT 的時差絕對值,單位分鐘(00-59)
語法
Delphi
Function DLSetInformationA(InstanceID, Key: Integer; NewValue: PAnsiChar): Integer;
DLL
int DLSetInformationA(int InstanceID, int Key, const char * NewValue);
參數
| Key | 要設定的屬性:0 = PDF 版本 1 = Author 2 = Title 3 = Subject 4 = Keywords 5 = Creator 6 = Producer 7 = CreationDate 8 = ModDate 9 = XMP dc:subject |
|---|---|
| NewValue | 指定屬性的新值 |
Key 為 0 時,NewValue 選擇完整儲存的 PDF 目標版本。目標為 PDF 1.3、1.4、1.5、1.6 與 1.7 時,SaveToFile、SaveToString 與 SaveToStream 會讓輸出檔案維持在所選版本。文件仍含需要更新 PDF 版本的功能時,儲存會失敗,LastErrorCode 傳回 602。
傳回值
| 0 | 無法設定指定的資訊。請用 LastErrorCode 函式判斷失敗原因。 |
|---|---|
| 1 | 指定的資訊設定成功 |