Adelegates - Methods to Read/Write/Invoke Delegates;/


NAME



2delegates - Methods to Read/Write/Invoke Delegates




(

SYNOPSIS



0DestroyDelegateInfo(image_info)

Scommand=GetDelegateCommand(image_info,image,decode_tag,encode_tag)

Lstatus=GetDelegateInfo(decode_tag,encode_tag,delegate_info)

GInvokeDelegate(image_info,image,decode_tag,encode_tag)

'ListDelegateInfo(file)

=delegate_info=SetDelegateInfo(delegate_info)




B

FUNCTION DESCRIPTIONS






>

DestroyDelegateInfo



KMethod DestroyDelegateInfo deallocates memory associated with the delegateslist.

1The format of the DestroyDelegateInfo routine is:

,

        DestroyDelegateInfo(image_info)


(A description of each parameter follows:

9
image_info:


-Specifies a pointer to a Delegates structure.






6

GetDelegateInfo



JMethod GetDelegateInfo returns any delegates associated with the specified>tag. True is returned if a delegate is found, otherwise False.

-The format of the GetDelegateInfo routine is:

G

       status=GetDelegateInfo(decode_tag,encode_tag,delegate_info)


(A description of each parameter follows:

status:


EMethod GetDelegateInfo returns True if a delegate is found, otherwiseFalse.$

decode_tag:


ISpecifies the decode delegate we are searching for as a character string.$

encode_tag:


ISpecifies the encode delegate we are searching for as a character string.'

delegate_info:


GA structure of type DelegateInfo. On return this structure contains the+delegate information for the specified tag.






<

GetDelegateCommand



JMethod GetDelegateCommand replaces any embedded formatting characters withBthe appropriate image attribute and returns the resulting command.

0The format of the GetDelegateCommand routine is:

O

        command=GetDelegateCommand(image_info,image,decode_tag,encode_tag)


(A description of each parameter follows:

!
command:


GMethod GetDelegateCommand returns the command associated with specified delegate tag.$

image_info:


-The address of a structure of type ImageInfo.

image:


)The address of a structure of type Image.$

decode_tag:


ISpecifies the decode delegate we are searching for as a character string.$

encode_tag:


ISpecifies the encode delegate we are searching for as a character string.






4

InvokeDelegate



JMethod InvokeDelegate replaces any embedded formatting characters with theHappropriate image attribute and executes the resulting command. False is=returned if the commands execute with success otherwise True.

,The format of the InvokeDelegate routine is:

C

        InvokeDelegate(image_info,image,decode_tag,encode_tag)


(A description of each parameter follows:

$
image_info:


-The address of a structure of type ImageInfo.

image:


)The address of a structure of type Image.






8

ListDelegateInfo



:Method ListDelegateInfo lists the image formats to a file.

.The format of the ListDelegateInfo routine is:

#

        ListDelegateInfo(file)


(A description of each parameter follows.


file:


An pointer to a FILE.






6

SetDelegateInfo



KMethod SetDelegateInfo adds or replaces a delegate in the delegate list andHreturns the address of the first delegate. If the delegate is NULL, just.the address of the first delegate is returned.

-The format of the SetDelegateInfo routine is:

8

       delegate_info=SetDelegateInfo(delegate_info)


(A description of each parameter follows:

'
delegate_info:


GMethod SetDelegateInfo returns the address of the first delegate in thedelegates list.'

delegate_info:


IA structure of type DelegateInfo. This information is added to the end ofthe delegates linked-list.