Adelegates - Methods to Read/Write/Invoke Delegates9/


NAME



2delegates - Methods to Read/Write/Invoke Delegates




(

SYNOPSIS



3DestroyDelegateInfo( image_info );

tchar * GetDelegateCommand( const ImageInfo *image_info, const Image *image, const char *decode_tag,&const char *encode_tag );

lunsigned int GetDelegateInfo( const char *decode_tag, const char *encode_tag, DelegateInfo*delegate_info );

wunsigned int InvokeDelegate( const ImageInfo *image_info, Image *image, const char *decode_tag, const char *encode_tag );

)void ListDelegateInfo( /FILE *file );

\DelegateInfo * SetDelegateInfo( DelegateInfo *delegate_info );




B

FUNCTION DESCRIPTIONS






>

DestroyDelegateInfo



KMethod DestroyDelegateInfo deallocates memory associated with the delegateslist.

0The format of the DestroyDelegateInfo method is:=

DestroyDelegateInfo ( image_info );


=A description of each parameter follows:

<

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 method is:‡

unsigned int GetDelegateInfo ( const char *decode_tag, const char *encode_tag, DelegateInfo *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:


EA structure of type DelegateInfo. On return thisBstructure 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.

/The format of the GetDelegateCommand method is:Ù

char *GetDelegateCommand ( const ImageInfo *image_info, const Image *image, const char *decode_tag, const char *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 method is:Ö

unsigned int InvokeDelegate ( const ImageInfo *image_info, Image *image, const char *decode_tag, const char *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 method is:?

void ListDelegateInfo ( FILE *file );


=A description of each parameter follows.

!

file:


An pointer to a FILE.






6

SetDelegateInfo



ŠMethod SetDelegateInfo adds or replaces a delegate in the delegate list and returns the address of the first delegate. If the delegate is NNULL, just the address of the first delegate is returned.

,The format of the SetDelegateInfo method is:X

DelegateInfo *SetDelegateInfo ( DelegateInfo *delegate_info );


=A description of each parameter follows:

*

delegate_info:


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

delegate_info:


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