NewOptionalContentGroupA

Content Streams and Optional Content Groups

Description

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to NewOptionalContentGroup and string arguments are interpreted using the current SetAnsiMode code page

Creates a new optional content group. The group name will appear in the Layers tab in Acrobat 6 or later.

Syntax

Delphi

Function DLNewOptionalContentGroupA(InstanceID: Integer; GroupName: PAnsiChar): Integer;

DLL

int DLNewOptionalContentGroupA(int InstanceID, const char * GroupName);

Parameters

GroupNameThe name of the optional content group. This name is displayed in the PDF viewer user interface.

Return values

0The new optional content group could not be created
Non-zeroAn ID that can be used as the OptionalContentGroupID parameter with the other optional content group functions