This documentation is archived and is not being maintained.

PictureFormat.HasAlphaChannel Property

Office 2007
Returns an MsoTriState constant indicating whether the specified picture contains an alpha channel. Read-only.



expression   A variable that represents a PictureFormat object.

Return Value


An alpha channel is a special 8-bit channel used by some image processing software to contain additional data, such as masking or transparency information.

The HasAlphaChannel property value can be one of the MsoTriState constants declared in the Microsoft Office type library and shown in the following table.

msoFalseThe specified picture does not contain an alpha channel.
msoTriStateMixedIndicates a combination of msoTrue and msoFalse for the specified shape range.
msoTrueThe specified picture contains an alpha channel.


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 the shape is a picture.

Visual Basic for Applications
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