SetAnnotCloudyEffect

註解與熱點連結

描述

此頁面描述 PDF Library for Delphi 在「註解與熱點連結」主題下的 SetAnnotCloudyEffect。API 名稱、參數、類別名稱、檔案名稱與字面量（literals）皆完全保留其在 Delphi 程式庫與 DLL 進入點中的原始樣貌。

SetAnnotCloudyEffect 會在註解上寫入邊框效果字典（ISO 32000-1 §12.5.4），使其邊框渲染為由半圓相連的「修訂雲」，這是用於標記圖面與計畫圖的樣式。它會在 Square、Circle、Polygon 與 FreeText 註解上設定 /BE << /S /C /I n >>。

語法

Delphi

Function TPDFlib.SetAnnotCloudyEffect(Index, Intensity: Integer): Integer;

參數

Index 是所選頁面上註解的 1-based 索引。Intensity 選取雲朵尺寸：1 或 2（對應至 Acrobat 使用者介面提供的 Cloudy 1/2 樣式）；傳入 0 則會再次移除該邊框效果。

傳回值

成功時傳回 1；若註解不存在、其子類型不支援邊框效果（僅 Square、Circle、Polygon 與 FreeText 支援），或者 Intensity 不在 0..2 範圍內，則傳回 0。

備註

邊框效果字典是一項 PDF 1.5 功能；套用此效果時，文件版本會自動提升。由 PDF Library for Delphi 建立的註解不帶有預先渲染的外觀串流，因此檢視器會根據註解字典重新產生視覺效果，並自動呈現雲朵樣式。請使用 GetAnnotCloudyEffect 讀回設定值。