PLayerOptions

Change the attributes for a layer.

This command is new in PageMaker 6.5

Command constructor

PLayerOptions(const char * sLayerName, const char * sNewName, short bShow, short
bLock, short nColorIndex);

const char * sLayerName;
The name of the layer to change.
const char * sNewName;
The new name for the layer, "" leaves the name unchanged.
short bShow;
true to show the layer, false to hide the layer, or -2 to leave unchanged.
short bLock;
true to lock the layer, false to unlock
short nColorIndex;
Color for object handles to indicate that the object is on this layer.

Predefined Color Color Index

Black 0

Red 1

Green 2

Blue 3

Yellow 4

Magenta 5

Cyan 6

Gray 7

Light Blue 8

Orange 9

Dark Green 10

Teal 11

Tan 12

Brown 13

Violet 14

Gold 15

Dark Blue 16

Pink 17

Lavender 18

Brick Red 19

Olive Green 20

Peach 21

Burgundy 22

Grace Green 23

Ochre 24

Purple 25

Light Gray 26

26 Other... pm_customcolorindex, "customcolorindex"

Predefined Color	Color Index
Black	0
Red	1
Green	2
Blue	3
Yellow	4
Magenta	5
Cyan	6
Gray	7
Light Blue	8
Orange	9
Dark Green	10
Teal	11
Tan	12
Brown	13
Violet	14
Gold	15
Dark Blue	16
Pink	17
Lavender	18
Brick Red	19
Olive Green	20
Peach	21
Burgundy	22
Grace Green	23
Ochre	24
Purple	25
Light Gray	26

PLayerOptions(const char * sLayerName, const char * sNewName, short bShow, short
bLock, long nRed, long nGreen, long nBlue);

const char * sLayerName;
The name of the layer to change.
const char * sNewName;
The new name for the layer, "" leaves the name unchanged.
short bShow;
true to show the layer, false to hide the layer, or -2 to leave unchanged.
short bLock;
true to lock the layer, false to unlock, -2 to leave unchanged.
long nRed;
Red value for custom handle color.
long nGreen;
Green value for custom handle color.
long nBlue;
Blue value for custom handle color.

Note. on the Macintosh platform, the red, green, and blue values range from 0 - 65535. On Windows they range 0-255. For custom colors, ColorIndex has value pm_customhandlecolor, otherwise it ranges from 0 up to pm_customhandlecolor.

Example. The following example renames a layer and sets its options so that its objects are visible, locked, and have orange handles.

PLayerOptions("MyLayer", "Altered", true, true, 9);

PLayerOptions

Command constructor

See also