HtmlSaveOptions

HtmlSaveOptions class

Html formatına dışa aktarma seçeneklerini kaydedin

public class HtmlSaveOptions : UnifiedSaveOptions, IPageSetOptions, IPipelineOptions

yapıcılar

İsimTanım
HtmlSaveOptions()Yeni bir örneğini başlatırHtmlSaveOptions sınıf.
HtmlSaveOptions(bool)Yeni bir örneğini başlatırHtmlSaveOptions sınıf.
HtmlSaveOptions(HtmlDocumentType)Yeni bir örneğini başlatırHtmlSaveOptions sınıf.
HtmlSaveOptions(HtmlDocumentType, bool)Yeni bir örneğini başlatırHtmlSaveOptions sınıf.

Özellikleri

İsimTanım
BatchSize { get; set; }Kaynak ve hedef biçim çiftine toplu dönüştürme uygulanabilir ise parti boyutunu tanımlar.
CloseResponse { get; set; }Belge yanıta kaydedildikten sonra Response nesnesinin kapatılacağını belirten boole değerini alır veya ayarlar.
CompressSvgGraphicsIfAny { get; set; }SVG grafiklerinin (varsa) bulunup bulunmadığını belirten bayrağı alır veya ayarlar.
ConvertMarkedContentToLayers { get; set; }ConvertMarkedContentToLayers özniteliği true olarak ayarlanırsa, PDF’de içerik (katman) olarak işaretlenen tüm öğeler, bir katman adı belirten “data-pdflayer” özniteliğiyle bir HTML div’ine konur. Bu katman adı, PDF’nin isteğe bağlı özelliklerinden çıkarılacaktır. işaretli içerik. Bu özellik yanlışsa (varsayılan olarak), PDF işaretli içerikten herhangi bir katman oluşturulmaz.
DefaultFontName { get; set; }Sistemde yerleşik olmayan ve yüklü olmayan herhangi bir belge yazı tipini değiştirmek için kullanılan yüklü bir yazı tipinin adını belirtir. Boş ise varsayılan ikame yazı tipi kullanılır.
DocumentType { get; set; }Alır veya ayarlarHtmlDocumentType .
ExplicitListOfSavedPages { get; set; }Bu özellik ile belgenin hangi sayfalarının dönüştürüleceğini açıkça tanımlayabilirsiniz. Bu listedeki sayfalar 1 tabanlı sayılara sahip olmalıdır. Yani, aralıktan geçerli sayıda sayfa alınmalıdır (1…[NumberOfPagesInConvertedDocument]) Bu listedeki sayfaların görünme sırası, sonuçtaki HTML sayfalarının sırasını etkilemez - sonuç sayfalarında her zaman sırayla gider kaynak PDF’de bulunurlar. Bu liste boşsa (varsayılan olarak olduğu gibi), tüm sayfalar dönüştürülür. Bu listenin herhangi bir sayfa numarası mevcut sayfaların aralığının dışına çıkarsa(1-[ miktarOfPagesInDocument]) istisnası atılacak.
ExtractOcrSublayerOnly { get; set; }Bu özellik, OCR alt katmanına sahip PDF belgeleri için resim veya metin çıkarma işlevini açtı .
FixedLayout { get; set; }HTML’nin sabit düzen olarak oluşturulup oluşturulmadığını belirten bir değer alır veya ayarlar.
FlowLayoutParagraphFullWidth { get; set; }Bu öznitelik, Akış modu için tam genişlikte paragraf metnini belirtir, FixedLayout = false
FontSources { get; }Önceden kaydedilmiş yazı tiplerinin yazı tipi kaynakları.
ImageResolution { get; set; }Görüntü işleme için çözünürlüğü alır veya ayarlar.
MinimalLineWidth { get; set; }Bu özellik, grafik yolu çizgisinin minimum genişliğini ayarlar. Çizginin kalınlığı 1 pikselden azsa Adobe Acrobat onu bu değere yuvarlar. Dolayısıyla bu özellik, HTML tarayıcıları için bu davranışı taklit etmek için kullanılabilir .
PreventGlyphsGrouping { get; set; }Bu özellik, metin gliflerinin kelimeler ve dizeler halinde gruplandırılmayacağı modu açar Bu mod, gliflerin sayfada konumlandırılması sırasında maksimum hassasiyetin korunmasına izin verir ve ayrı olarak yerleştirilmesi gereken müzik notaları veya glifleri olan belgeleri dönüştürmek için kullanılabilir. birbirini. Bu parametre, yalnızca FixedLayout özniteliğinin değeri true olduğunda belgeye uygulanacaktır.
RenderTextAsImage { get; set; }RenderTextAsImage özniteliği true olarak ayarlanırsa, kaynaktan gelen metin HTML’de bir resim olur. Metni seçilemez yapmak için yararlı olabilir veya HTML metni düzgün şekilde oluşturulmaz.
SaveFormat { get; }Veri kaydetme biçimi.
SimpleTextboxModeGrouping { get; set; }Bu öznitelik, gliflerin ve sözcüklerin dizeler halinde sıralı bir şekilde gruplandırılmasını belirtir Örneğin, etiketler ve sözcüklerin dönüştürülen HTML’de farklı sıraları vardır ve bunların eşleşmesini istiyorsunuz. Bu parametre, yalnızca FixedLayout özniteliğinin değeri true olduğunda belgeye uygulanacaktır.
SplitCssIntoPages { get; set; }Çoklu sayfa modu seçildiğinde (yani ‘SplitIntoPages’ ’true’ olur), o zaman bu öznitelik, her sonuç HTML sayfası için ayrı CSS dosyası oluşturulup oluşturulmayacağını tanımlar. Varsayılan olarak bu öznitelik yanlıştır, bu nedenle, oluşturulacaktır bir oluşturulan tüm sayfalar için büyük ortak CSS. Bu modda oluşturulan tüm CSS’lerin özet boyutu (sayfa başına bir CSS) genellikle büyük bir CSS dosyasının boyutundan çok daha fazladır, çünkü önceki durumda CSS sınıfları bu durumda her sayfa için birkaç CSS dosyasında kopyadır. Yani, bu ayarın yalnızca, her HTML sayfasının gelecekte bağımsız olarak işlenmesiyle ilgilendiğinizde kullanılması daha kötüdür ve bu nedenle, her bir sayfanın CSS’sinin size kısmının ayrılması en kritik konudur.
SplitIntoPages { get; set; }Kaynak belgesinin her sayfasının kendi hedef HTML belgesine dönüştürülüp dönüştürülmeyeceğini, yani sonuç HTML’sinin birkaç HTML sayfasına bölünüp bölünmeyeceğini gösteren bayrağı alır veya ayarlar.
UseZOrder { get; set; }UseZORder özelliği true olarak ayarlanırsa, elde edilen HTML belgesine grafikler ve metinler eklenir ve buna göre orijinal PDF belgesinde Z-sıralanır. Bu öznitelik yanlışsa, tüm grafikler tek katman olarak put ‘dir, bu da çakışan nesneler için bazı gereksiz etkilere neden olabilir.
WarningHandler { get; set; }Oluşturulan uyarıları işlemek için geri arama. WarningHandler, Continue veya Abort’u belirten ReturnAction numaralandırma öğesini döndürür. Devam, varsayılan eylemdir ve Kaydetme işlemi devam eder, ancak kullanıcı ayrıca Durdur’a da dönebilir, bu durumda Kaydetme işlemi sona ermelidir.

Alanlar

İsimTanım
AntialiasingProcessingBu parametre, bileşik arka plan görüntülerinin PDF’den HTML_x000d’ye dönüştürülmesi sırasında gerekli kenar yumuşatma önlemlerini tanımlar.
CssClassNamesPrefixPDFtoHTML dönüştürücü sonuç CSS’leri oluşturduğunda, CSS sınıf adları (".stl_01 {}" … “.stl_NN {} gibi bir şey) oluşturulur ve sonuç CSS’sinde kullanılır. Bu özellik, sınıf adı önekinin zorla ayarlanmasına izin verir Örneğin, tüm sınıf adlarının ‘my_prefix_’ ile başlamasını istiyorsanız (yani ‘my_prefix_1’ … ‘my_prefix_NNN’ gibi bir şeydi), sonra dönüştürmeden önce bu özelliğe ‘my_prefix_’ atayın. Bu özelliğe dokunulmadan kalacaksa (yani boş) value olarak bırakılacak), then dönüştürücü kendisi sınıf adları üretecek (".stl_01 {}” … “.stl_NN {}”) gibi bir şey olacak
CustomCssSavingStrategyBu alan, oluşturulan HTML belgesine veya sayfalarına (birden fazla HTML sayfası oluşturulmuşsa) ilgili CSS’lerin kaydedilmesinin işlenmesi için Pdf’nin Html’ye dönüştürülmesi sırasında (varsa) kullanılması gereken kaydetme stratejisini içerebilir. CSS dosyasını belirli bir şekilde ele alın, bu sadece lütfen ilgili yöntemi oluşturun ve ondan oluşturulan temsilciyi bu özelliğe atayın.
CustomHtmlSavingStrategyDönüştürmenin sonucu bir veya birkaç HTML sayfası içerebilir Bu özelliğe, bir HTML sayfasının işlenmesini uygulayan özel yöntemle oluşturulan temsilciyi atayabilirsiniz (doğru olması için - varsa harici bağlantılı dosyalar olmadan biçimlendirme-HTML) dönüştürme sırasında oluşturuldu. Bu durumda işleme (sayfa HTML’sinin akış veya diske kaydedilmesi gibi) o özel kodda yapılabilir. Böyle bir durumda HTML sayfasının kaydedilmesi için gerekli tüm eylemler, sağlanan yöntemin kodunda gerçekleştirilmelidir, çünkü sonucun dönüştürücü koduna kaydedilmesi kullanımda olmayacaktır. Herhangi bir nedenle şu veya bu durum için işleme dönüştürücünün kodunun kendisi tarafından yapılması gerekiyorsa, özel kodda değil, lütfen ‘htmlSavingInfo’ parametresinin değişkeninin ‘CustomProcessingCancelled’ özel kod bayrağına ayarlayın: dönüştürücüye tüm bu kaynağın işlenmesi için gerekli adımlar, dönüştürücünün kendisinde, aynı şekilde işlemek için herhangi bir harici özel kod yokmuş gibi yapılmalıdır .
CustomProgressHandlerBu işleyici dönüşüm ilerleme olaylarını işlemek için kullanılabilir fe ilerleme çubuğunu veya işlenen sayfaların mevcut miktarı hakkındaki mesajları göstermek için kullanılabilir, konsoldaki ilerlemeyi gösteren işleyici kodunun örneği :
CustomResourceSavingStrategyBu alan, dönüştürme sırasında (varsa) kullanılması gereken kaydetme stratejisini içerebilir, , kaydedilmiş HTML düğümleriyle ilgili oluşturulan başvurulan resource dosyalarının (görüntüler ve yazı tipleri gibi) özelleştirilmiş işlenmesi için. Bu strateji, kaynakları işlemeli ve oluşturulan HTML. içindeki kayıtlı resource için istenen URL’yi temsil eder
CustomStrategyOfCssUrlCreationBu alan, konu CSS’nin URL’sini (Veya çok sayfalı oluşturma açıksa URL şablonu - aşağıdaki ayrıntılara bakın) döndüren özel yöntemi içerebilir, çünkü oluşturulan HTML sonucuna eklenmelidir. Fe Dönüştürücünün standard yerine belirli bir URL koymasını istiyorsanız Oluşturulan CSS’ye CSS dosya adı, ardından, istenen URL’yi üreten method özelliğini oluşturmalı ve bu özelliğe koymalısınız. ‘SplitCssIntoPages’ bayrağı ayarlanırsa, bu özel strateji (varsa) CSS’nin tam URL’sini değil, şablonu döndürmelidir. string that (dönüştürücü içindeki string.Format() işlevi ile sayfa numarası yer tutucunun değiştirilmesinden sonra) bu veya o sayfanın CSS’ URL’si için URL’ye çözümlenebilir. Bu durumda beklenen dönüş dizesi örnekleri şunlardır: ‘SomeTargetLocation-page_{0}.css’,’../PartHandlers/GetCss.aspx?DocumentId=45654&CssPage={0}’)
ExcludeFontNameListHTML’de gömülü olmayan PDF gömülü font adlarının listesi.
FontEncodingStrategyGeçerli belge için PDF kod çözmeyi ayarlamak için kodlama özel kuralını tanımlar
FontSavingModePDF’nin istenen biçimde kaydedilmesi sırasında kullanılacak yazı tipi kaydetme modunu tanımlar
HtmlMarkupGenerationModeBazen HTML işaretlemesi oluşturmak için belirli gereksinimler mevcuttur. Bu parametre, PDF’nin HTML’ye dönüştürülmesi sırasında bu tür özel gereksinimlere uyması için kullanılabilecek HTML hazırlama modlarını tanımlar.
LettersPositioningMethodHTML sonucunda kelimelerdeki harflerin konumlanma modunu ayarlar
PageBorderIfAnyBu öznitelik, kaynak PDF sayfasını temsil eden alanın etrafındaki sonuç HTML belgesinde (varsa) kenarlık çizmek için kullanılan ayarlar kümesini temsil eder. Özünde, sayfanın kağıt kenarlarını göstermekle ilgilidir, PDF sayfasının kendisinde referans verilen sayfa kenarlığı değil.
PageMarginIfAnyBu özellik, kaynak PDF sayfasını temsil eden alanın etrafındaki sonuç HTML belgesinde (varsa) fazladan sayfa kenar boşluğu kümesini temsil eder.
PagesFlowTypeDependsOnViewersScreenSize‘SplitOnPages=false’ özniteliği, tüm girdi PDF sayfalarını temsil eden tüm HTML’den daha büyük bir sonuç HTML dosyasına yerleştirilecektir. Bu işaret, sonuç HTML’sinin, sonuç HTML’sinde PDF sayfalarını temsil eden alanların akışının görüntüleyicinin ekran çözünürlüğüne bağlı olacağı şekilde oluşturulup oluşturulmayacağını tanımlar. İzleyici tarafındaki ekran genişliğinin, 2 veya daha fazla sayfayı biri diğerine yatay yönde yerleştirmek için yeterince büyük olduğunu varsayalım. Bu işaret true olarak ayarlanırsa, bu fırsat kullanılacaktır (birçok sayfa yatay yönde bir diğerinin yanında gösterileceğinden, sonraki yatay sayfa grubu ilkinin altında gösterilecektir). Aksi takdirde sayfalar akacaktır. bu şekilde: sonraki sayfa her zaman bir öncekinin altına gider.
PartsEmbeddingModeBaşvurulan dosyaların (HTML, Yazı Tipleri, Görüntüler, CSS’ler) ana HTML dosyasına mı gömüleceğini yoksa ayrı ikili varlıklar olarak mı oluşturulacağını tanımlar
RasterImagesSavingModeDönüştürülen PDF, raster görüntüler içerebilir Bu parametre, PDF’nin HTML’ye dönüştürülmesi sırasında bunların nasıl işleneceğini tanımlar
RemoveEmptyAreasOnTopAndBottomOluşturulan HTML’de herhangi bir içerik olmadan üst ve alt boş alanın (varsa) kaldırılıp kaldırılmayacağını tanımlar.
SaveFullFontTam fontun kaydedileceğini belirtir, yalnızca True Type Fonts’u destekler. Varsayılan olarak SaveFullFont = false ve dönüştürücü, belge metnini görüntülemek için gereken ilk font alt kümesini kaydeder.
SaveShadowedTextsAsTransparentTextsPdf, başka öğeler tarafından gölgelenen metinler içerebilir (görüntülerle fe), ancak Acrobat Reader’da panoya seçilebilir (genellikle belge, görüntüler ve ondan çıkarılan OCR’li metinler içerdiğinde olur). Bu ayar dönüştürücüye, Acrobat Reader davranışını taklit etmek için bu tür metinleri şeffaf seçilebilir metinler olarak kaydetmeniz gerekir (aksi takdirde bu tür metinler genellikle gizli olarak kaydedilir, panoya kopyalanamaz)
SaveTransparentTextsPdf, panoya seçilebilen şeffaf metinler içerebilir (genellikle belge, görüntüler ve ondan çıkarılan OCRed metinleri içerdiğinde olur). Bu ayarlar dönüştürücüye, bu tür metinleri saydam sonuçta HTML seçilebilir metinler olarak kaydetmemiz gerekip gerekmediğini söyler.
SpecialFolderForAllImagesBelgenin HTML olarak kaydedilmesi sırasında ile karşılaşılırsa, herhangi bir görüntünün kaydedilmesi gereken dizinin yolunu alır veya ayarlar. Parametre boş veya null ise, resim dosyaları (varsa) HTML ile bağlantılı diğer dosyalarla birlikte kaydedilir. CustomImageSavingStrategy özelliğinin ilgili resim dosyasını işlemek için başarıyla kullanılması hiçbir şeyi etkilemez.
SpecialFolderForSvgImagesBelgenin HTML olarak kaydedilmesi sırasında ile karşılaşılırsa, yalnızca SVG görüntülerinin kaydedilmesi gereken dizinin yolunu alır veya ayarlar. Parametre boş veya null ise, SVG dosyaları (varsa) diğer görüntü dosyalarıyla (çıktı dosyasına yakın) veya görüntüler için özel klasöre (SpecialImagesFolderIfAny seçeneğinde belirtilmişse) kaydedilir. Hiçbir şeyi etkilemez. CustomImageSavingStrategy özelliği, ilgili görüntü dosyasını işlemek için başarıyla kullanıldıysa.
TryMergeAdjacentSameBackgroundImagesBazen PDF’ler arka plan görüntülerini (sayfaların veya tablo hücrelerinin) içerir , birbirinin yanına yerleştirilmiş birkaç aynı döşeme arka plan görüntüsünden oluşturulmuştur. Bu durumda hedef biçimlerin oluşturucuları (DOCS biçimi için fe MsWord) bazen arka plan görüntülerinin bölümleri arasında görünür sınırlar oluşturur , görüntü kenar yumuşatma (anti-aliasing) tekniklerinin Acrobat Reader’dan farklı olmasına neden olur. Dışa aktarılan belge, aynı arka plan görüntülerinin bölümleri arasında bu tür görünür sınırlar içeriyor gibi görünüyorsa, bundan kurtulmak için lütfen bu ayarı kullanmayı deneyin istenmeyen etki. DİKKAT! Bu kalite optimizasyonu genellikle dönüşümü yavaşlatır, bu nedenle, lütfen bu seçeneği yalnızca gerçekten gerekli olduğunda kullanın.
TrySaveTextUnderliningAndStrikeoutingInCssPDF’nin kendisi, metinler için alt çizgi işaretleri içermez. Metnin altında yer alan satırla öykünür. Bu seçenek dönüştürücünün şu veya bu satırın bir metnin underlining olduğunu tahmin etmesini ve bu bilgiyi grafiksel olarak altını çizmek yerine CSS’ye koymasını sağlar

Ayrıca bakınız

HtmlPageLayoutOption HtmlSaveOptions.AntialiasingProcessingType