AddInkAnnotation

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

Açıklama

Sayfada çizilen bir veya daha fazla el yazısı konturunu, serbest biçimli işareti veya serbest el çizimini temsil eden mürekkep işaretleme ek açıklaması (PDF /Subtype /Ink) ekler. /InkList sözlüğü girdisi bir kontur dizisi içerir; her kontur, bir işaretleme cihazının kalem aşağı ve kalem yukarı olayları arasında izlediği yolu temsil eden dönüşümlü x/y koordinatları dizisidir. Renk bileşenleri ve opaklık 0–1 ölçeğinde, Transparency ise 0–100 ölçeğinde verilir (0 = tamamen opak, 100 = tamamen saydam). Bu giriş noktası PDF 1.4 ek açıklama /CA opaklık anahtarını yayımladığı için kütüphane, kilidi açık daha düşük belgeleri kaydetmeden önce PDF 1.4'e yükseltir; kilitli alt hedefler uyumluluk kapısı tarafından reddedilir. ISO 32000-1 §12.5.6.13'te tanımlanmıştır

Sözdizimi

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametreler

InkPaths — Tek bir dize olarak kodlanmış bir veya daha fazla çizgi. Çizgiler '|' veya yeni satırla ayrılır. Her çizgide koordinat çiftleri AddPolygonAnnotation ile aynı ayırıcı kuralını kullanır: boşluk, virgül, noktalı virgül veya sekmeyle ayrılmış dönüşümlü x/y değerleri. Örnek: "100 100 110 105 120 110 | 200 200 210 205" iki ayrı çizgiyi açıklar. Her çizgi en az iki koordinat çifti ve çift sayıda değer içermelidir; aksi durumda çağrı 0 döndürür

BorderWidth — Geçerli birimlerde mürekkebin kontur genişliği

InkRed, InkGreen, InkBlue — /C içine yazılan mürekkep renginin 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, mürekkep dizesi geçerli kontur listesine ayrıştırılamazsa veya ek açıklama oluşturulamazsa 0

Açıklamalar

Ek açıklamanın /Rect değeri, işlenen çizgilerin ek açıklama sınırlayıcı kutusunun içinde kalması için tüm çizgilerin birleşik kapsamından ve kenarlık genişliğiyle orantılı küçük bir dolgudan otomatik olarak hesaplanır

Bu giriş noktası hem dokunmatik/kalem aygıtından alınan dijital el yazısı hem de karalanmış imzalar veya başka araçlardan içe aktarılan ek açıklamalar gibi programlı serbest el şekilleri için uygundur. Oluşturulduktan sonra mürekkep rengini, kenarlığı, içeriği veya dikdörtgeni değiştirmek için SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents ve SetAnnotRect işlevlerini kullanın