SetOptionalContentConfigState

Fluxos de conteúdo e grupos de conteúdo opcional

Descrição

Esta função define o estado de um grupo de conteúdo opcional conforme especificado pelo dicionário de configuração de conteúdo opcional indicado

Todos os dicionários de configuração de conteúdo opcional têm um estado base (ON, OFF ou Unchanged) e duas matrizes de associação denominadas /ON e /OFF

É adicionada uma referência ao grupo de conteúdo opcional à matriz /ON ou /OFF apropriada (ou removida de ambas), consoante o valor do estado base

Um determinado grupo de conteúdo opcional só pode ser definido como Unchanged se o estado base do dicionário de configuração de conteúdo opcional for Unchanged

O estado base do dicionário de configuração de conteúdo opcional predefinido (acedido definindo OptionalContentConfigID como 1) é sempre ON, pelo que os grupos de conteúdo opcional deste dicionário de configuração só podem ser definidos como ON ou OFF

Sintaxe

Delphi

Function TPDFlib.SetOptionalContentConfigState(OptionalContentConfigID, OptionalContentGroupID, NewState: Integer): Integer;

ActiveX

Function PDFlib::SetOptionalContentConfigState(OptionalContentConfigID As Long, OptionalContentGroupID As Long, NewState As Long) As Long

DLL

int DLSetOptionalContentConfigState(int InstanceID, int OptionalContentConfigID, int OptionalContentGroupID, int NewState);

Parâmetros

OptionalContentConfigID	O primeiro dicionário de configuração de conteúdo opcional predefinido tem o ID 1. São utilizados números superiores para outros dicionários de configuração de conteúdo opcional
OptionalContentGroupID	Um ID devolvido pelas funções NewOptionalContentGroup, GetOptionalContentGroupID ou GetOptionalContentConfigOrderItemID
NewState	Especifica o estado a definir para o grupo de conteúdo opcional neste dicionário de configuração: 1 = Definir como ON 2 = Definir como OFF 3 = Manter inalterado (se possível)

Valores devolvidos

0	Não foi possível definir o estado
1	O estado foi definido com êxito int OptionalContentConfigID, int OptionalContentGroupID, int NewState);