PictureFormat.OriginalHasAlphaChannel property (Publisher)
Returns an MsoTriState constant depending on whether the original, linked picture contains an alpha channel. Read-only.
Syntax
expression.OriginalHasAlphaChannel
expression A variable that represents a PictureFormat object.
Return value
MsoTriState
Remarks
This property only applies to linked pictures. Returns "Permission Denied" for shapes representing embedded or pasted pictures.
Use either of the following properties to determine whether a shape represents a linked picture:
An alpha channel is a special 8-bit channel used by some image processing software to contain additional data, such as masking information or transparency information.
The OriginalHasAlphaChannel property value can be one of the MsoTriState constants declared in the Microsoft Office type library and shown in the following table.
| Constant | Description |
|---|---|
| msoFalse | The original, linked picture does not contain an alpha channel. |
| msoTriStateMixed | Indicates a combination of msoTrue and msoFalse for the specified shape range. |
| msoTrue | The original, linked picture contains an alpha channel. |
Example
The following example returns whether the first shape on the first page of the active publication contains an alpha channel. If the picture is linked, and the original picture contains an alpha channel, that is also returned. This example assumes that the shape is a picture.
With ActiveDocument.Pages(1).Shapes(1).PictureFormat
If .HasAlphaChannel = msoTrue Then
Debug.Print .Filename
Debug.Print "This picture contains an alpha channel."
If .IsLinked = msoTrue Then
If .OriginalHasAlphaChannel = msoTrue Then
Debug.Print "The linked picture " & _
"also contains an alpha channel."
End If
End If
End If
End With
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.