Práce s nastavením dokumentu

Práce s nastavením dokumentu

Kromě obsahu Word dokument obsahuje nastavení na úrovni aplikace – přepínače pro zpětnou kompatibilitu, preference dělení slov, uloženou konfiguraci hromadné korespondence, možnosti zobrazení a stav ochrany proti zápisu. Aspose.Words FOSS pro .NET zveřejňuje je prostřednictvím Aspose.Words.Settings jmenného prostoru a několika vlastností na Document. Tato stránka popisuje každou skupinu nastavení a co ovlivňuje a co neovlivňuje.

Možnosti kompatibility

Document.CompatibilityOptions je instance CompatibilityOptions obsahující desítky booleanových přepínačů, které reprodukují specifické starší chování rozvržení a mezery ve Wordu – např. GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout a BalanceSingleByteDoubleByteWidth. Nastavte přímo vlastnosti, které potřebujete, aby odpovídaly specifickým renderovacím zvláštnostem konkrétní verze Wordu v následných nástrojích, které dokument čtou.

Předvolby dělení slov

Document.HyphenationOptions je instance HyphenationOptions (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone), která ukládá předvolby dělení slov ve Wordu pro dokument. Tyto vlastnosti zajišťují obousměrný přenos požadavku; protože tato edice neobsahuje engine pro rozvržení stránky, Aspose.Words FOSS sama nevypočítává místa dělení slov – Word je aplikuje při otevření a stránkování souboru.

Konfigurace hromadné korespondence

Document.MailMergeSettings je MailMergeSettings instance, která ukládá konfiguraci hromadné korespondence zaznamenanou v dokumentu: MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord a ViewMergedData, plus Clear() a Clone(). Pro externí datové zdroje připojené prostřednictvím mechanismu Office Data Source Object ve Wordu, MailMergeSettings.Odso vystavuje Odso instanci (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames), jejíž FieldMapDatas (OdsoFieldMapDataCollection z OdsoFieldMapData: Name, MappedName, Column, Type) a RecipientDatas (OdsoRecipientDataCollection z OdsoRecipientData: Active, Column, Hash, UniqueTag) popisují mapování polí a seznam příjemců.

Nastavení zobrazení dokumentu

Document.ViewOptions je ViewOptions instance, která řídí, jak Word zobrazuje soubor při otevření: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries a FormsDesign. Tyto vlastnosti ovlivňují pouze vlastní zobrazení dokumentu ve Wordu – nemají žádný vliv na to, jak Aspose.Words FOSS sám dokument zpracovává.

Ochrana proti zápisu

Document.WriteProtection je WriteProtection instance (IsWriteProtected, ReadOnlyRecommended) s SetPassword() pro nastavení ochranného hesla a ValidatePassword() pro ověření zadaného hesla.

Měřicí jednotky

Výčet MeasurementUnits určuje jednotku měření, kterou by Word měl používat ve svém rozhraní pro dokument.

Tipy a osvědčené postupy

• CompatibilityOptions.OptimizeFor(MsWordVersion) je přítomen ve třídě, ale jeho implementace v tomto sestavení není kompletní – vyhazuje NotImplementedException. Nastavte jednotlivé booleovské vlastnosti CompatibilityOptions, které potřebujete, přímo místo spoléhaní se na OptimizeFor, který by aplikoval celý profil verze najednou.
• MailMergeSettings and Odso uložit hromadnou korespondenci configuration která byla zaznamenána v dokumentu – čtení a zápis této konfigurace jsou podporovány, ale provádění hromadné korespondence (naplnění polí z živého datového zdroje) není zahrnuto v této open-source edici.
• HyphenationOptions a ViewOptions jsou oba zobrazovací/UI preference, které Word sám aplikuje – neočekávejte, že volání Document.Save() změní způsob zalamování textu nebo jeho vzhled podle těchto nastavení, protože tato edice neobsahuje engine pro rozvržení stránky.
• Zavolejte WriteProtection.SetPassword() před povolením IsWriteProtected a použijte ValidatePassword() k ověření kandidátního hesla místo toho, abyste si sami ukládali nebo porovnávali surový řetězec.
• CompatibilityOptions, HyphenationOptions, MailMergeSettings, ViewOptions a WriteProtection jsou všechny přístupné přímo z Document – není nutné je hledat ve stromu uzlů.

Časté problémy

FAQ

Mohu použít Aspose.Words FOSS k provedení skutečné hromadné korespondence?

Ne. MailMergeSettings a Odso vám umožňují číst a zapisovat konfiguraci sloučení uloženou v dokumentu, ale provedení hromadné korespondence – vyplňování polí z datového zdroje – není v této open-source edici zahrnuto.

Funguje CompatibilityOptions.OptimizeFor()?

Ne – v této verzi vyhazuje NotImplementedException. Místo toho nastavte přímo jednotlivé požadované vlastnosti CompatibilityOptions.

Jak mohu dokument chránit heslem proti úpravám?

Zavolejte WriteProtection.SetPassword() na Document.WriteProtection, pak nastavte IsWriteProtected pro povolení ochrany.

Mění HyphenationOptions a ViewOptions rozložení dokumentu?

Ne. Obě jsou uloženými předvolbami, které Microsoft Word použije při otevření a zobrazení souboru. Tato edice neobsahuje engine pro rozvržení stránky, takže tato nastavení projdou dál, aniž by Aspose.Words FOSS samotné vypočítalo rozložení z nich.

API Reference Shrnutí

Viz také:

• Aspose.Words for .NET — Enterprise Documentation