PrintablePlate Object [Publisher 2003 VBA Language Reference]

AdvancedPrintOptions PrintablePlates PrintablePlate

Represents a single ink to be printed for the publication. The PrintablePlate object is a member of the PrintablePlates collection.

Using the PrintablePlate object

Use the FindPlateByInkName method of the PrintablePlates collection to return a specific plate by referencing its ink name. Process colors are assigned different index numbers in the Plates collection than in the PrintablePlates collection. Use the FindPlateByInkName method to insure the desired Plate or PrintablePlate object is accessed.

The following example returns a spot color plate and sets several of its properties. The example assumes that separations have been specified as the active publication's print mode.

Sub SetPlatePropertiesByInkName()

Dim pplPlate As PrintablePlate
ActiveDocument.AdvancedPrintOptions.UseCustomHalftone = True

    Set pplPlate = ActiveDocument.AdvancedPrintOptions.PrintablePlates.FindPlateByInkName(pbInkNameSpot3)
    
    With pplPlate
        .Angle = 75
        .Frequency = 133
        .PrintPlate = True
    End With

End Sub

The following example returns a list of the printable plates currently in the collection for the active publication. The example assumes that separations have been specified as the active publication's print mode.

Sub ListPrintablePlates()
    Dim pplTemp As PrintablePlates
    Dim pplLoop As PrintablePlate
    

    Set pplTemp = ActiveDocument.AdvancedPrintOptions.PrintablePlates
    Debug.Print "There are " & pplTemp.Count & " printable plates in this publication."
    
    For Each pplLoop In pplTemp
        With pplLoop
            Debug.Print "Printable Plate Name: " & .Name
            Debug.Print "Index: " & .Index
            Debug.Print "Ink Name: " & .InkName
            Debug.Print "Plate Angle: " & .Angle
            Debug.Print "Plate Frequency: " & .Frequency
            Debug.Print "Print Plate?: " & .PrintPlate
        End With
    Next pplLoop
End Sub

Remarks

To specify custom frequency or angle settings for a printable plate, the UseCustomHalftone of the AdvancedPrintOptions object must be set to True.

The PrintablePlates collection is generated when a publication's print mode is set to separations. Returns "Permission Denied" when any other print mode is specified.

The PrintablePlates collection represents the plates that will actually be printed for the publication, based on:

• The plates (if any) you have defined for the publication
• The advanced print options specified

You cannot programmatically create a printable plates collection, or add a printable plate to the collection.

Use the PrintMode property of the AdvancedPrintOptions object to set the publication to print as separations.

Each PrintablePlate object corresponds to a plate listed on the Separations tab of the Advanced Print Settings dialog box.

Properties | Angle Property | Application Property | Frequency Property | Index Property | InkName Property | Name Property | Parent Property | PrintPlate Property

Parent Objects | AdvancedPrintOptions

Child Objects