SetStructElemLangA

Etiketli PDF & Erişilebilirlik

Açıklama

Sondaki A, ANSI (char) DLL giriş noktasını belirtir; ActiveX/COM yüzeyi yalnızca Unicode biçimini sunar. Davranış SetStructElemLang ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfasıyla yorumlanır

Etiket yığınında o anda oluşturulan yapı öğesinde /Lang girdisini ayarlar. Dil etiketi bu öğe ve tüm alt öğeleri için belge düzeyi dilini geçersiz kılar; böylece karma dilli belgeler her içerik aralığı için doğru doğal dili bildirebilir

Sözdizimi

Delphi

Function DLSetStructElemLangA(InstanceID: Integer; Lang: PAnsiChar): Integer;

DLL

int DLSetStructElemLangA(int InstanceID, const char * Lang);

Parametreler

Dönüş değeri

Başarı durumunda 1; şu anda açık yapı öğesi yoksa veya belge seçili değilse 0 döndürür

Açıklamalar

Hedef öğe etiket yığınının en üstündeyken bu işlevi BeginTag veya BeginTagEx çağrısından hemen sonra çağırın. Boş olmayan bir Lang bağımsız değişkenini BeginTagEx işlevine geçirmekle eşdeğerdir; ancak dil öğe türünden ayrı belirlendiğinde daha kullanışlı olabilir

Öğe düzeyindeki /Lang girdisi ISO 32000-1 §14.9.2'de tanımlanır. Yapı öğesine ve devralma yoluyla kendi /Lang bildirimine sahip olmayan tüm alt öğelere uygulanır. Ekran okuyucular belgeyi sesli okurken uygun metinden sese sesini veya dil altyapısını seçmek için bu girdiyi kullanır

PDF/UA-1 (ISO 14289-1 §7.3), tüm doğal dil içeriğinin tanımlanmasını gerektirir. SetDocumentLanguage veya SetPDFUAMode tarafından ayarlanan belge düzeyi /Lang birincil dili kapsar; SetStructElemLang ise dili birincil dilden farklı olan bölümleri kapsar

Örnek

// A French phrase embedded in an English document
PDFlib.SetPDFUAMode('en-US');
// ... English content
PDFlib.BeginTag('P', '', '');
PDFlib.SetStructElemLang('fr');
PDFlib.TextOut(x, y, 'Bonjour le monde');
PDFlib.EndTag;

Ayrıca bkz

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics