AddCaretAnnotation

Ek açıklamalar ve etkin nokta bağlantıları

Açıklama

Seçili sayfaya düzeltme işareti biçiminde bir işaretleme açıklaması (PDF /Subtype /Caret) ekler. Caret açıklaması, metnin veya içeriğin eklendiği, atlandığı ya da başka bir nedenle gözden geçirenin dikkatini gerektiren sayfa konumunu geleneksel olarak işaretleyen görsel bir semboldür. İki sembol biçimi vardır: düzeltme işareti (None) veya paragraf işareti (Paragraph). Renk bileşenleri ve opaklık 0–1 ölçeğinde ifade edilir; Transparency 0–100 ölçeğinde verilir (0 = tamamen opak, 100 = tamamen saydam). Kitaplık, daha düşük bir asgari sürüm kilidi altında Caret açıklaması oluşturulduğunda belge sürümünü PDF 1.5 düzeyine yükseltir. ISO 32000-1 §12.5.6.11 içinde tanımlanmıştır

Sözdizimi

Delphi

Function TPDFlib.AddCaretAnnotation(Left, Top, Width, Height: Double; SymbolType: Integer; ColorRed, ColorGreen, ColorBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametreler

Left — Geçerli birimlerde, ek açıklama dikdörtgeni'nin sol alt köşesinin yatay koordinatı

Top — Geçerli birimlerde ek açıklama dikdörtgeni'nin sol alt köşesinin dikey koordinatı

Width — ek açıklama dikdörtgeninin genişliği

Height — Açıklama dikdörtgeninin yüksekliği

SymbolType — Şapka işareti simgesi stili:

0 = None (düzeltmesiz metin imleci "^")

1 = Paragraf (paragraf işareti "¶")

Diğer tüm değerler 0 (None) olarak değerlendirilir

ColorRed, ColorGreen, ColorBlue — şapka işareti renginin /C içine yazılan RGB bileşenleri (0–1)

Title — Ek açıklamanın' /T girdisine yazılan yazar adı. Atlamak için boş bir dize geçirin

Contents — Ek açıklamayla ilişkili açılır pencerenin gövdesi. Atlamak için boş dize geçirin

Transparency — saydamlık yüzdesi olarak ifade edilen opaklık (0–100). Kitaplık bunu PDF /CA = 1 - Transparency/100 değerine dönüştürür ve aralığa sınırlar

Dönüş Değeri

Başarı durumunda 1, belge seçili değilse veya ek açıklama oluşturulamadıysa 0

Açıklamalar

Açıklama /Type /Annot, /Subtype /Caret, /Rect, /Sy (sembol adı), /C, /CA, /F = 4 (yazdırılabilir), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Caret" ve /P ile oluşturulur. İsteğe bağlı /RD alanı (/Rect içindeki düzeltme işareti uzaklığı) oluşturulmaz; okuyucular bu değeri varsayılan olarak tamamen sıfır kabul ettiğinden düzeltme işareti açıklama dikdörtgeninin tamamını kaplar

Oluşturma sonrasında ek açıklama dikdörtgenini, rengini veya içeriğini değiştirmek için SetAnnotRect, SetAnnotBorderColor ve SetAnnotContents kullanın