Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

DynaPDF.GetOCG

Returns properties for layer.

Component Version macOS Windows Linux Server iOS SDK
DynaPDF 9.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "DynaPDF.GetOCG"; PDF; Handle; Selector )   More

Parameters

Parameter Description Example
PDF The PDF reference returned from DynaPDF.New. $pdf
Handle The OCG handle. $OCG
Selector Which value to return. "Name"

Result

Returns value or error.

Description

Returns properties for layer.
returns the properties of the Content Usage dictionary that is associated with an OCG or layer. If the OCG is not included in an application event, then the contents in this dictionary serves as pure information.
If the OCG is included in one or more application events, then these settings control also the visibility state of the OCG. The function DynaPDF.GetOCG returns the events and categories which control the layer visibility.
If UserNamesCount is greater zero, the dictionary contains also user names. The user names can be accessed with DynaPDF.GetOCGUsageUserName.

Properties:
HandleHandle or array index
IntentBitmask, see TOCGIntent. For Intent and visibility state
NameLayer name
HaveContUsageIf 1, the layer contains a Content Usage dictionary. See DynaPDF.GetOCGContUsage
AppEventsBitmask, see TOCAppEvent. If non-zero, the layer is included in one or more app events which control the layer state.
CategoriesBitmask, see TOCGUsageCategory. The Usage Categories which control the layer state.

See also GetOCG function in DynaPDF manual.

Examples

Find layers in PDF:

Set Variable [ $pdf ; Value: MBS("DynaPDF.New") ]
#
# import file
Set Variable [ $r ; Value: MBS("DynaPDF.OpenPDFFromContainer"; $pdf; Layers::Input PDF) ]
Set Variable [ $r ; Value: MBS("DynaPDF.ImportPDFPage"; $pdf; 1) ]
#
# look for layers
Set Variable [ $count ; Value: MBS ( "DynaPDF.GetOCGCount" ; $pdf ) ]
Set Variable [ $index ; Value: 0 ]
Loop
    Exit Loop If [ $index$count ]
    #
    Set Variable [ $Name ; Value: MBS ( "DynaPDF.GetOCG" ; $pdf ; $index; "Name" ) ]
    Set Variable [ $Intent ; Value: MBS ( "DynaPDF.GetOCG" ; $pdf ; $index; "Intent" ) ]
    Set Variable [ $Visible ; Value: MBS( "Math.BitwiseAND"; $intent; 32 ) = 32 ]
    #
    New Record/Request
    Set Field [ Layers::Name ; $name ]
    Set Field [ Layers::Visible ; $visible ]
    Commit Records/Requests [ With dialog: Off ]
    #
    Set Variable [ $index ; Value: $index + 1 ]
End Loop
#
Set Variable [ $r ; Value: MBS( "DynaPDF.Release"; $pdf ) ]

See also

Release notes

Blog Entries

This function checks for a license.

Created 18th February 2019, last changed 18th February 2019


DynaPDF.GetNeedAppearance - DynaPDF.GetOCGContUsage