Macro Language Reference > Macros > Frame > tfcont
  
tfcont
Description
Allows you to change the contents of the currently selected frame. A dialog box appears with the current settings, which you may change. The dialog box contains settings for the text stream name, object graphic name and raster graphic name. You can specify whether the text stream restarts in this frame or not. The dialog box also allows access to further dialog boxes that allow you to change origin and margin settings for object and raster graphics, and scaling for raster graphics.
 
Example 117. Invoke the raster scaling dialog box
tfcont "rs"
 
Example 118. Fit a raster to a frame horizontally and vertically
tfcont "rs","f","f"
 
Example 119. Scale a framed raster with fixed width and aspect ratio height
Either of the macros shown below scales a raster to 2 inches wide, preserving its aspect ratio vertically:
tfcont "rs",4,2in,2
tfcont "rs","a",2in,"p"
Syntax
tfcont *:L? ( options:s ( ( parameters...:s* ) | ( across:uh down:uv )? | ( top:uv bottom:uv left:uh right:uh )? | ( X scale:s size:n Y scale:s size:n )? | ( X scale:ssize:n Y scale:s size:n )? ) )
tfcont
[no paremeter]
Invoke the Frame Contents dialog box.
*
Import specified items into the document and not into a specific frame.
* 
The asterisk must precede the entire parameter list to be effective.
options
t
Text stream: use parameters defined in the tftext macro.
o
Object graphic: use parameters defined in the tfobject macro.
r
Raster graphic: use parameters defined in the tfraster macro.
oo
Change the object graphic's origin or, if parameters is not present, invoke the relevant dialog box.
om
Change the object graphic's margin or, if parameters is not present, invoke the relevant dialog box.
ro
Change the raster graphic's origin or, if parameters is not present, invoke the relevant dialog box.
rm
Change the raster graphic's margin or, if parameters is not present, invoke the relevant dialog box.
rh
Invokes the half-tones dialog box.
rs
Change the raster graphic's scaling or, if parameters is not present, invoke the relevant dialog box.
parameters...
Depending on the option chosen the parameters take the same form as either the tftext, the tfobject or the tfraster macros.
across
Object or raster graphic originates across from left-hand edge of frame.
down
x
Object or raster graphic originates from top of frame.
top
Top margin of object or raster graphic
bottom
Bottom margin of object or raster graphic
left
Left margin of object or raster graphic
right
Left margin of object or raster graphic
X scale
The options for scaling are a little unusual in that there are several ways to specify the scaling of a raster. In PTC ALD internal structure a scaling option is indicated by a code from 0..5. This code can be specified in the macro either by its number, by a code string, or implicitly:
0, n, r
No scaling
1, f
Fit to frame
2, p
Preserve aspect ratio
3, d, .
Dot size
4, a
Absolute size
5, %
Percentage size
size
Only applicable for X scale options 3, 4 and 5.
3
Number followed by optional unit of measurement
4
Number followed by optional unit of measurement
5
Percentage
Y scale
0, n, r
No scaling
1, f
Fit to frame
2, p
Preserve aspect ratio
3, d, .
Dot size
4, a
Absolute size
5, %
Percentage size
size
Only applicable for Y scale options 3, 4 and 5.
3
Number followed by optional unit of measurement
4
Number followed by optional unit of measurement
5
Percentage
Related Links