SetInformation
文件屬性
描述
設定所選文件的屬性
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 TPDFlib.SetInformation(Key: Integer; Const NewValue: WideString): Integer;ActiveX
Function PDFlib::SetInformation(Key As Long, NewValue As String) As LongDLL
int DLSetInformation(int InstanceID, int Key, const wchar_t * 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。
更新 Info 字典的某個欄位時，即使其他欄位參照同一個字串或串流物件，也只會替換該欄位本身；儲存期間自動更新 ModDate 時，會保留共用的 CreationDate 值
為資訊更新或自動儲存時間戳記初始化 XMP 時，會保留既有的 XMP 屬性與自訂命名空間，包括沒有 xpacket 包裝的 XML 在內；Windows 上的 Free Pascal 建置也提供同樣的同步機制
傳回值
| 0 | 無法設定指定的資訊。請用 LastErrorCode 函式判斷失敗原因。 |
|---|---|
| 1 | 指定的資訊設定成功 |