TXTextControl.LoadSaveAttribute Property

Determines the attribute that is to be changed or returned. Possible values are listed in Constants.

Loads or saves a document width in twips. When this property is set before a document is loaded, it is used to calculate width values contained in the document which are relative to the document's width. After a document has been loaded, this property returns the width, contained in the document, or -1 if the document does not contain a width. When a document is saved and this property has not been set, Text Control saves the value of the PageWidth property instead, except this property has been set to -1 previously.

Loads or saves a document height in twips. It is used in the same manner as described for the txDocWidth attribute.

Loads or saves a left document margin in twentieths of a point. After a document has been loaded, this property returns the margin contained in the document, or -1 if the document does not contain the margin. When a document is saved and this property has not been set, Text Control saves the value of the PageMarginL property instead, except this property has been set to -1 previously.

Loads or saves a top document margin in twentieths of a point. It is used in the same manner as described for the txDocLeftMargin attribute.

Loads or saves a right document margin in twentieths of a point. It is used in the same manner as described for the txDocLeftMargin attribute.

Loads or saves a bottom document margin in twentieths of a point. It is used in the same manner as described for the txDocLeftMargin attribute.

Loads or saves a document title. After a document has been loaded, this property returns the document title contained in the document, or an empty string if the document does not contain a title.

Loads or saves a document background color as a RGB value. After a document has been loaded, this property returns the background color contained in the document, or -1, if the document does not contain a background color.

HTML only. Specifies a full or relative path and filename for a CSS file. This file is only used if txCSSSaveMode determines that stylesheet data is saved in a file.

HTML only. Determines how to save stylesheets in HTML format. It can be one of the following values:

PDF only. Specifies how a document can be accessed after it has been opened. This property has only an effect, if also a password has been specified with the txMasterPassword setting. If no password has been specified, the document can be accessed without any restrictions. The settings value can be a bitwise combination of more than one of the following values.

PDF only. Specifies the password for the document's access permissions. If the password is an empty string, accessing the document is not restricted. If a password is specified, the access permissions are given through the txDocAccessPermissions setting.

PDF only. Specifies the password for the user to open the document. If the password is an empty string, the document can be opened by every user.

Sets a value between 1 and 100, which is the quality of a lossy image compression used when a document is saved. It is used for all images in the document the data of which is compressed with a lossy compression algorithm. A value of 100 indicates the maximum quality, a value of 1 indicates the minimum quality. A value of zero selects a compression specific default value. For a single image the value of this property can be overwritten using the ImageExportCompressionQuality property.

Sets the maximum resolution for all images in the document in dots per inch when the document is saved. If an image's resolution is larger than this property's value, it is reduced, otherwise it is not changed. If this property's value is zero, which is the default value, the default resolution of each image is used. For a single image the value of this property can be overwritten using the ImageExportMaxResolution property.

MS Word and RTF only. Converts MS Word fields into marked text fields of the type txFieldMSWord. The FieldTypeData property can be used to get the field's data.

MS Word and RTF only. Converts Heiler HighEdit fields into marked text fields of the type txFieldHighEdit. The FieldTypeData property can be used to get the field's data.

Specifies a character string specifying the types of MS Word fields to be loaded. This attribute is only used when the txLoadMSWordFields attribute is set to true. The string can contain several type names that must be separated with tab (09) characters. When a document is saved, this attribute is not used.

Determines whether the document's images are stored through its data or through its file reference. By default images are stored through a file reference, when a file reference exists. Otherwise, if an image has been pasted from the clipboard, it is stored with its binary data. For a single image the value of this attribute can be overwritten with the ImageSaveMode property. It can be one of the following values:

Sets the format used for saving all images contained in the document. The attribute's value is is the number of the filter in the string returned through the ImageExportFilters property, beginning with number one. For a single image the value of this attribute can be overwritten with the ImageExportFormat property.

Specifies the name of a certificate file containing a X.509 certificate. This certificate can be used to digitally sign a PDF or a PDF/A file. For other formats this property has no meaning. When the certificate file contains a private key, a password must be specified with the txCertificatePassword attribute to decrypt the private key.

Specifies the password to decrypt the private key of a certificate file. A certificate file can be specified with the txCertificateFileName attribute. When a file name is not specified, this attribute has no meaning.

Specifies the URL of a time server which is used to get a time stamp for a certification. If this attribute is not specified, the current date and time on the computer is used. When a certificate file is not specified with the txCertificateFileName attribute, this attribute has no meaning.

Specifies a character string containing Javascript. The string can contain several scripts which must be separated with 01 control characters. The scripts are embedded in a PDF document at document level and they are executed, when the PDF document is opened. When the document is saved as PDF/A the scripts are not embedded.

MS Word and RTF only. Converts MS Word fields into TextControl formfields. This attribute overwrites the txLoadMSWordFields attribute. When both attributes are set to True, checkboxes, form textfields, comboboxes, dropdown lists and date fields are converted to TextControl formfields, all other fields are converted to text fields of the type txFieldMSWord.

Specifies a string consisting of substrings separated through 09 (TAB) control characters. The substrings are the name of a certificate file containing a X.509 certificate, the password for this file, the name of a signature field and the URL of a time server. The certificates are used to digitally sign a PDF or a PDF/A file. For other formats this property has no meaning. Each certificate is associated with a signature field in the PDF document. When the document has more than one signature field the four substrings of the second field must follow the four substrings of the first field and so on. The name of the signature field must be specified with the ObjectName property.

Specifies a character string that is used to search for resources like images or destinations of hypertext links. When a document is loaded, this path is used to locate a resource. It is only used for resources which are specified through an absolute location. In this case the absolute resource location is completely replaced through the path specified through this property. When a document is saved, this attribute is not used.

Specifies a character string that is used to search for resources given through a relative location. When a document is loaded, this path is added to the relative location of a resource. When a document is saved the string can only be a file path. All files in the document are saved relative to this path.

HTML only. Specifies a base font size in points and is used to convert percentage font sizes to absolute font sizes. When not set, a value of 10 points is used. This attribute is only used when a document is loaded.

HTML only. Defines a proportional font name when not specified in the document. When not set, Text Control uses a default font. This attribute is only used when a document is loaded.

HTML only. Defines a mono-spaced font name when not specified in the document. When not set, Text Control uses a default mono-spaced font. This attribute is only used when a document is loaded.

HTML only. Defines a text color. This attribute is only used when a document is loaded. When the txOverwriteTextColor attribute is set to True, this color is used for text coloring. Otherwise when not set to overwrite, this color is only used when no text color is specified in the document.

HTML only. Sets the txTextColor attribute to overwrite or not to overwrite.

HTML only. Defines a text background color. This attribute is only used when a document is loaded. When the txOverwriteTextBkColor attribute is set to True, this color is used for text background coloring. Otherwise, when not set to overwrite, this color is only used when no text background color is specified in the document.

HTML only. Sets the txTextBkColor attribute to overwrite or not to overwrite.

HTML only. Specifies whether or not images are loaded. When not set, images are replaced by its alternate text or a special link text. For all other formats images are always loaded.

HTML, RTF and Word only. Converts source and target fields of hypertext links to appropriate marked text fields.

RTF only. Converts all '\cbN' keywords into marked text fields of the type txFieldHighlight.

RTF only. Converts all '\sect' keywords into marked text fields of the type txFieldTopic.

Loads or saves the author of the document. After a document has been loaded, this property returns the author contained in the document, or an empty string if the document does not contain an author.

Loads or saves the creation date of the document. After a document has been loaded, this property returns the creation date contained in the document, or midnight, 30 December 1899, if the document does not contain a creation date. The time must be an UTC time (Coordinated Universal Time).

Loads or saves the keywords contained in the document. The string can contain several keywords which must be separated with 09 (TAB) control characters. After a document has been loaded, this property returns the keywords contained in the document, or an empty string, if the document does not contain keywords.

Loads or saves the date of last modification. After a document has been loaded, this property returns the date of last modification contained in the document, or midnight, 30 December 1899, if the document does not contain such a date. The time must be an UTC time (Coordinated Universal Time).

Loads or saves the subject of the document. After a document has been loaded, this property returns the subject contained in the document, or an empty string if the document does not contain a subject.

Loads or saves the creator application of the document. After a document has been loaded, this property returns the creator application contained in the document, or an empty string if the document does not contain a creator application.

SpreadsheetML only. Sets a value specifying how documents with several parts are loaded. Each SpreadsheetML document can contain multiple worksheets. The following values are possible:

Read only. Returns the document's file name. After a document has been loaded or saved with a built-in dialogbox, this property returns the filename selected through the user.

Read only. Returns the document's file format. After a document has been loaded or saved with a built-in dialogbox, this property returns the file format selected through the user. The returned value is one of the format specifiers described for the Format parameter of the Load and Savemethods.

HTML only. Defines a text color for pieces of text which function as hypertext links. This attribute is only used when a document is loaded. When the txOverwriteLinkColor attribute is set to True, this color is used to color hypertext links. Otherwise when not set to overwrite, this color is only used when no color for links is specified in the document.

HTML only. Sets the txLinkColor attribute to overwrite or not to overwrite.

HTML only. Specifies whether or not hypertext links are underlined. This attribute is only used when a document is loaded. When set to False, hypertext links are only underlined when specified in the document.

Specifies the default file format used in the built-in Open... and Save As... dialogboxes. The specified value must be one of the format specifiers described for the Format parameter of the Load and Save methods.