RegisterFigure
標籤式 PDF
描述
設定下一張繪製影像要攜帶的描述
語法
Delphi
Function TPDFlib.RegisterFigure(Const Description: WideString): Integer;參數
| Description | 以文字說明圖片呈現的內容。空描述會被拒絕。 |
|---|
傳回值
| 1 | 描述已被取用。 |
|---|---|
| 0 | 描述為空，未記錄任何內容。 |
備註
閱讀器會朗讀這段描述來代替圖片，對視障讀者而言這就是圖片傳達的全部資訊。請描述圖片呈現的內容，而不是只說「這裡有一張圖」
描述只用在下一張繪製的影像，之後的影像不會繼承。只有 SetAutoTagMode 涵蓋 figure 時才會生效；沒有的話影像會以未標記的方式繪出，描述直接丟棄。
不帶任何語義的分隔線、框線或背景，請改用 RegisterDecoration：一個沒什麼好說的圖形比沒有圖形更糟，因為閱讀器會為它停下來。
範例
PDF.SetAutoTagMode(AUTOTAG_DEFAULT);
PDF.RegisterFigure('Quarterly revenue, rising from 2024 to 2026');
PDF.DrawImage(72, 100, 300, 200); // a Figure carrying that description
PDF.RegisterDecoration;
PDF.DrawImage(72, 320, 300, 4); // a rule: an artifact a reader skips另見
RegisterDecoration, SetAutoTagMode, RegisterHeading, BeginTagEx