Images, Text Frames, Signature Fields and OLE Objects
Images, text frames, signature fields and OLE objects share one set of Object members in TXTextControl: the same properties position, size, scale and name them, whichever kind they are. Each kind has its own methods to insert it anchored to a paragraph, as a character or at a fixed position.
Further properties control how images are displayed, filtered and exported and how text frames look. The events report when an object is created, clicked, double-clicked, right-clicked, moved, sized, deleted, zoomed, printed, scrolled out of view, loaded or saved, and when a text frame is activated or deactivated.
Properties
| Member | Description |
|---|---|
TXTextControl.ImageDisplayMode | Provides several modes to set the way in which images are displayed or refreshed. |
TXTextControl.ImageExportCompressionQuality | Determines a value between 1 and 100, which is the quality of a lossy data compression used, if the image is saved. |
TXTextControl.ImageExportFilename | Determines the file name of an image or signature field used if a document is saved. |
TXTextControl.ImageExportFilters | This property returns a string which specifies the available filters for exporting images. |
TXTextControl.ImageExportFormat | Determines the format used if an image is saved. |
TXTextControl.ImageExportMaxResolution | Determines the maximum resolution in dots per inch used, if the image is saved. |
TXTextControl.ImageFilename | Determines the image file name of an inserted image or signature field. |
TXTextControl.ImageFilters | This property returns a string which specifies the available image filters. |
TXTextControl.ImageSaveMode | Determines whether the image is stored through its data or through its file reference. |
TXTextControl.ObjectCurrent | Returns or sets the current object for setting properties of images, text frames, signature fields or OLE objects. |
TXTextControl.ObjectDescriptiveText | Defines a descriptive text for an image, text frame, signature field or OLE object. |
TXTextControl.ObjectDistance | Specifies the distance (in twips) between an image, text frame, signature field or OLE object and the text that flows around it. |
TXTextControl.ObjectHeight | Returns or sets the natural height, in twips, of an image, text frame, signature field or OLE object. |
TXTextControl.ObjectInsertionMode | Gets or sets an image's, text frame's, signature field's or OLE object's formatting behavior. |
TXTextControl.ObjectItem | Returns a reference to an OLE object. |
TXTextControl.ObjectName | Defines a name for an image, text frame, signature field or OLE object. |
TXTextControl.ObjectPosX | Gets or sets the image's, text frame's, signature field's or OLE object's horizontal position, in twips. |
TXTextControl.ObjectPosY | Gets or sets the image's, text frame's, signature field's or OLE object's vertical position, in twips. |
TXTextControl.ObjectScaleX | Specifies the object's horizontal scaling factor as a percentage. |
TXTextControl.ObjectScaleY | Specifies the object's vertical scaling factor as a percentage. |
TXTextControl.ObjectSizeMode | Specifies whether an inserted image, text frame, signature field or OLE object can be moved or resized at run time. |
TXTextControl.ObjectTextflow | Gets or sets a value in which way text flows around an image, text frame, signature field or OLE object. |
TXTextControl.ObjectTransparency | Specifies the object's transparency. |
TXTextControl.ObjectUserId | Defines a user-defined identifier for an image, text frame, signature field or OLE object. |
TXTextControl.ObjectWidth | Returns or sets the natural width, in twips, of an image, text frame, signature field or OLE object. |
TXTextControl.SignatureFieldSignerData | Defines info data of a suggested signer. |
TXTextControl.TextFrameBackColor | Returns or sets the background color of a text frame. |
TXTextControl.TextFrameBorderWidth | Specifies the width, in twips, of a text frame's border line. |
TXTextControl.TextFrameInternalMargin | Specifies the distance (in twips) between a text frame's border line and the text. |
TXTextControl.TextFrameMarkerLines | This property determines whether or not marker lines for text frames are visible. |
Methods
| Member | Description |
|---|---|
TXTextControl.ImageInsert | This method inserts a new image anchored to a paragraph. |
TXTextControl.ImageInsertAsChar | This method inserts a new image which is then handled like a single character in the text. |
TXTextControl.ImageInsertFixed | This method inserts a new image at a fixed geometrical position. |
TXTextControl.ObjectAttrDialog | This method invokes the built-in dialog box for setting attributes of images, text frames and OLE objects. |
TXTextControl.ObjectChangeZOrder | Changes the z-order of an image, text frame, signature field or OLE object. |
TXTextControl.ObjectDelete | This method deletes an image, text frame, signature field or OLE object. |
TXTextControl.ObjectGetFromName | Looks for the object with the specified name. |
TXTextControl.ObjectGetFromUserId | Looks for the object with the specified user identifier. |
TXTextControl.ObjectGetSelected | This method returns the identifier of the currently selected object. |
TXTextControl.ObjectInsert | This method inserts a new OLE object or other control anchored to a paragraph. |
TXTextControl.ObjectInsertAsChar | This method inserts a new OLE object or other control which is then handled like a single character in the text. |
TXTextControl.ObjectInsertFixed | This method inserts a new OLE object or other control at a fixed geometrical position. |
TXTextControl.ObjectNext | This method returns the identifier of the object that follows the specified object in a TXTextControl's internal list of objects. |
TXTextControl.SignatureFieldInsert | This method inserts a new signature field anchored to a paragraph. |
TXTextControl.SignatureFieldInsertAsChar | This method inserts a new signature field, which is then handled as a single character in the text. |
TXTextControl.SignatureFieldInsertFixed | This method inserts a new signature field at a fixed geometrical position. |
TXTextControl.TextFrameInsert | This method inserts a new text frame anchored to a paragraph. |
TXTextControl.TextFrameInsertAsChar | This method inserts a new text frame, which is then handled as a single character in the text. |
TXTextControl.TextFrameInsertFixed | This method inserts a new text frame at a fixed geometrical position. |
TXTextControl.TextFrameSelect | This method determines whether a certain TXTextControl property or method manipulates a text frame or the main text. |
Events
| Member | Description |
|---|---|
TXTextControl.ObjectClicked | Occurs when an object has been clicked on. |
TXTextControl.ObjectCreated | This event specifies that a new object has been created. |
TXTextControl.ObjectDblClicked | Occurs when an object has been double-clicked on. |
TXTextControl.ObjectDeleted | Occurs when an object has been deleted. |
TXTextControl.ObjectGetData | Occurs when a document which contains objects, is saved. |
TXTextControl.ObjectGethWnd | Occurs when a document which contains objects, is loaded. |
TXTextControl.ObjectGetZoom | Occurs when an object's zoom factor is requested. |
TXTextControl.ObjectMoved | Occurs if an image, text frame, signature field or OLE object has been moved with the built-in mouse interface. |
TXTextControl.ObjectPrint | Occurs when a document containing objects is printed. |
TXTextControl.ObjectRightClicked | Occurs when an object has been clicked on with the right mouse button. |
TXTextControl.ObjectScrollOut | Occurs when an object is scrolled out of the visible area. |
TXTextControl.ObjectSetData | Occurs when a document which contains objects, is loaded. |
TXTextControl.ObjectSetZoom | Occurs when an object's zoom factor is to be changed. |
TXTextControl.ObjectSized | Occurs if an image, text frame, signature field or OLE object has been resized with the built-in mouse interface. |
TXTextControl.TextFrameActivated | Occurs when a text frame has obtained the input focus. |
TXTextControl.TextFrameDeactivated | Occurs when a text frame has lost the input focus. |