PLetterSpace

Sets the space from the left edge of one letter to the left edge of the next letter. The extent of the action depends on which tool is active, whether any text is selected, and whether a publication is open when the command is executed.

Command constructors

This class has two constructors.

PLetterSpace(short dLetterMin, short dLetterDesired, short dLetterMax);

short dLetterMin;
Minimum space between letters, expressed as a percentage (from -200 to 200) in tenths of a percent (100.0% = 1000), although the command uses only whole percentages, and decimal values are rounded up to the nearest whole number.
short dLetterDesired;
Desired space between letters, expressed as a percentage (from -200 to 200) in tenths of a percent (100.0% = 1000), although the command uses only whole percentages, and decimal values are rounded up to the nearest whole number.
short dLetterMax;
Maximum space between letters, expressed as a percentage (from -200 to 200) in tenths of a percent (100.0% = 1000), although command uses only whole percent ages, and decimal values are rounded up to the nearest whole number.

PLetterSpace(const PGetLetterSpace& letterSpace);

Set the letter spacing values using the corresponding PGetLetterSpace query object.

dLetterDesired measurements. The amount of space from the left edge of one letter to the left edge of the next letter is called the "pen advance" dis tance. The dLetterDesired is measured by the percentage of the space band that is added to or subtracted from the pen advance.

Specifying related values. Make sure that dLetterMin is less than or equal to the percentage set for dLetterDesired, and that dLetterMax is greater than or equal to the percentage set for dLetterDesired.

The values for dLetterMin and dLetterMax create the range within which PageMaker can space letters in a line of justified text.

Decimal values rounded up. Unlike the equivalent options in the Spacing Attributes dialog box, the PLetterSpace command accepts decimal values. How ever, PageMaker rounds decimal values for these parameters up to the nearest whole number. For example, 50.1 becomes 51%.

Example. The following example specifies letter spacing that causes PageMaker to narrow the distance between characters by subtracting as much as 5% of the space band or to widen the distance by adding up to 25% of the space band.

PLetterSpace(-50, 0, 250);

PLetterSpace

Command constructors

See also