RegisterFigure

Etiketli PDF

Açıklama

Bir sonraki çizilecek görüntünün taşıyacağı açıklamayı verir

Sözdizimi

Delphi

Function TPDFlib.RegisterFigure(Const Description: WideString): Integer;

Parametreler

DescriptionResmin gösterdiği şeyin sözcüklerle açıklaması. Boş açıklama reddedilir

Dönüş değerleri

1Açıklama alındı
0Açıklama boştu ve hiçbir şey kaydedilmedi

Açıklamalar

Okuyucu bu açıklamayı resim yerine okur; dolayısıyla görmeyen okuyucunun resimden aldığı her şey budur. Bir resim bulunduğunu söylemek yerine resmin ne gösterdiğini belirtin

Açıklama, çizilen bir sonraki görüntüde tüketilir; bu nedenle daha sonraki bir görüntü onu hiçbir zaman devralmaz. Yalnızca SetAutoTagMode şekilleri kapsarken etkili olur; aksi hâlde görüntü etiketsiz çizilir ve açıklama atılır

Anlam taşımayan bir çizgi, kenarlık veya arka plan için bunun yerine RegisterDecoration kullanın: hakkında söylenecek değerli hiçbir şey olmayan bir şekil, hiç şekil olmamasından daha kötüdür; çünkü okuyucu onun için duraklar

Örnek

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

Ayrıca bkz

RegisterDecoration, SetAutoTagMode, RegisterHeading, BeginTagEx