Implement the MHEG5 Text Class 36 Text Class Defines attributes and behaviour of pieces of textual information. Base class: Visible Subclasses: EntryField, HyperText Status: Concrete class. More...

#include "mh5visible.h"

Classes
struct	MHEG5Text

Macros
#define	HJUSTIFICATION_START (0)

#define	HJUSTIFICATION_END (1)

#define	HJUSTIFICATION_CENTRE (2)

#define	HJUSTIFICATION_JUSTIFIED (3)

#define	VJUSTIFICATION_START (0)

#define	VJUSTIFICATION_END (1)

#define	VJUSTIFICATION_CENTRE (2)

#define	VJUSTIFICATION_JUSTIFIED (3)

#define	LINE_ORIENTATION_HORIZONTAL (MHEG5FALSE)

#define	LINE_ORIENTATION_VERTICAL (MHEG5TRUE)

#define	BOM_NONE 0

#define	BOM_LITTLE_ENDIAN 1

#define	BOM_BIG_ENDIAN 2

Functions
void	MHEG5textInit (MHEG5Text *text)
	<Function description>=""> More...

void	MHEG5textFree (MHEG5Text *text)
	Free off all memory associated with the specified object, including any exchanged attributes and internal data. The data holding the object itself is not freed. More...

MHEG5Text *	MHEG5textClone (MHEG5Text *source)
	Copy a text object with original values. More...

void	MHEG5textPrepare (MHEG5Text *text)
	Apply the preparation behaviour of the text class Apply the preparation behaviour of the text class. As this class has no own preparation behaviour this function just invokes the preparation behaviour from the base class. More...

void	MHEG5textActivate (MHEG5Text *text)
	Apply the activation behaviour of the text class. As this class has no own activation behaviour this function just invokes the activation behaviour from the base class. More...

void	MHEG5textDeactivate (MHEG5Text *text)
	Apply the deactivation behaviour of the text class. As this class has no own deactivation behaviour this function just invokes the deactivation behaviour from the base class. More...

void	MHEG5textDestruct (MHEG5Text *text)
	Destruct a text object. More...

MHEG5ErrorCode	MHEG5getTextData (MHEG5Root target, MHEG5GList params)
	Set the Variable referenced by `TextDataVar` to the value of the `TextData` attribute. Implementation of the GetTextData (Target, TextDataVar) action of the text class. More...

MHEG5ErrorCode	MHEG5getTextContent (MHEG5Root target, MHEG5GList params)
	The effect of this action is to transfer the data of the content attribute of the text to the variable. Implementation of the GetTextContent (Target, TextContentVar) action of the text class. `NOTE`: There is a difference, depending on the type of the TextContentVar and the type of the content which can be either included or referenced. Please refer to the MHEG5 standard. More...

MHEG5ErrorCode	MHEG5setFontAttributes (MHEG5Root target, MHEG5GList params)
	The effect of this action is to set the FontAttributes to the given attributes. Implementation of the MHEG5setFontAttributes (Target, NewFontAttributes) action of the text class. More...

MHEG5ErrorCode	MHEG5setTextColour (MHEG5Root target, MHEG5GList params)
	The effect of this action is to set the TextColour to the given colour. Implementation of the MHEG5setTextColour (Target, NewTextColour) action of the text class. More...

MHEG5ErrorCode	MHEG5setBackgroundColour (MHEG5Root target, MHEG5GList params)
	The effect of this action is to set the BackgroundColour to the given colour. Implementation of the MHEG5setBackgroundColour (Target, NewBackgroundColour) action of the text class. More...

MHEG5ErrorCode	MHEG5setFontRef (MHEG5Root target, MHEG5GList params)
	The effect of this action is to change the character font used to preset a text. Implementation of the MHEG5setFontRef (Target, NewFont) action of the text class. More...

void	MHEG5textRedraw (MHEG5Text *text)

void	MHEG5textUtf8Content (MHEG5Text text, unsigned char data, int len)
	Adapt new content for Text objects. Content is encoded using UTF8 - this is converted to 16 bit unicode. More...

void	MHEG5textUtf16Content (MHEG5Text text, unsigned char data, int len)
	Content for Text objects is encoded using UTF16. More...

void	MHEG5textContentUnadapt (MHEG5Text text, MHEG5Byte utf8Data, MHEG5Int utf8Len)
	Undo the adaption of content for Text objects. Adapted content is stored as 16 bit unicode - this is converted back to UTF8. More...

void	MHEG5textContentUnadaptUTF16 (MHEG5Text text, MHEG5Byte utf16Data, MHEG5Int utf16Len)
	Undo the adaption of content for Text objects. Adapted content is stored as 16 bit unicode - this is converted back to its original format. More...

void	MHEG5textClearTextData (MHEG5Text *text)
	Clear text data. More...

Detailed Description

Implement the MHEG5 Text Class 36 Text Class Defines attributes and behaviour of pieces of textual information. Base class: Visible Subclasses: EntryField, HyperText Status: Concrete class.

Date: 05/02/2002

Author: R.Freeman

Definition in file mh5text.h.

Macro Definition Documentation

#define BOM_BIG_ENDIAN 2

Definition at line 54 of file mh5text.h.

#define BOM_LITTLE_ENDIAN 1

Definition at line 53 of file mh5text.h.

#define BOM_NONE 0

Definition at line 52 of file mh5text.h.

#define HJUSTIFICATION_CENTRE (2)

Definition at line 41 of file mh5text.h.

#define HJUSTIFICATION_END (1)

Definition at line 40 of file mh5text.h.

#define HJUSTIFICATION_JUSTIFIED (3)

Definition at line 42 of file mh5text.h.

#define HJUSTIFICATION_START (0)

Definition at line 39 of file mh5text.h.

#define LINE_ORIENTATION_HORIZONTAL (MHEG5FALSE)

Definition at line 49 of file mh5text.h.

#define LINE_ORIENTATION_VERTICAL (MHEG5TRUE)

Definition at line 50 of file mh5text.h.

#define VJUSTIFICATION_CENTRE (2)

Definition at line 46 of file mh5text.h.

#define VJUSTIFICATION_END (1)

Definition at line 45 of file mh5text.h.

#define VJUSTIFICATION_JUSTIFIED (3)

Definition at line 47 of file mh5text.h.

#define VJUSTIFICATION_START (0)

Definition at line 44 of file mh5text.h.

Function Documentation

MHEG5ErrorCode MHEG5getTextContent	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

The effect of this action is to transfer the data of the content attribute of the text to the variable. Implementation of the GetTextContent (Target, TextContentVar) action of the text class. NOTE: There is a difference, depending on the type of the TextContentVar and the type of the content which can be either included or referenced. Please refer to the MHEG5 standard.

Parameters

MHEG5Root	*target
MHEG5GList	*params

Returns: MHEG5ErrorCode MHEG5ErrorCode

Definition at line 421 of file mh5text.c.

MHEG5ErrorCode MHEG5getTextData	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

Set the Variable referenced by TextDataVar to the value of the TextData attribute. Implementation of the GetTextData (Target, TextDataVar) action of the text class.

Parameters

MHEG5Root	*target
MHEG5GList	*params

Returns: MHEG5ErrorCode MHEG5ErrorCode

Definition at line 470 of file mh5text.c.

MHEG5ErrorCode MHEG5setBackgroundColour	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

The effect of this action is to set the BackgroundColour to the given colour. Implementation of the MHEG5setBackgroundColour (Target, NewBackgroundColour) action of the text class.

Parameters

MHEG5Root	*target
MHEG5GList	*params

Returns: MHEG5ErrorCode MHEG5ErrorCode

Definition at line 620 of file mh5text.c.

MHEG5ErrorCode MHEG5setFontAttributes	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

The effect of this action is to set the FontAttributes to the given attributes. Implementation of the MHEG5setFontAttributes (Target, NewFontAttributes) action of the text class.

Parameters

MHEG5Root	*target
MHEG5GList	*params

Returns: MHEG5ErrorCode MHEG5ErrorCode

Definition at line 548 of file mh5text.c.

MHEG5ErrorCode MHEG5setFontRef	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

The effect of this action is to change the character font used to preset a text. Implementation of the MHEG5setFontRef (Target, NewFont) action of the text class.

Parameters

MHEG5String	sourceGID
MHEG5Int	sourceID
MHEG5GList	*params

Returns: MHEG5ErrorCode MHEG5ErrorCode

Definition at line 655 of file mh5text.c.

MHEG5ErrorCode MHEG5setTextColour	(	MHEG5Root *	target,
		MHEG5GList *	params
	)

The effect of this action is to set the TextColour to the given colour. Implementation of the MHEG5setTextColour (Target, NewTextColour) action of the text class.

Parameters

MHEG5Root	*target
MHEG5GList	*params

Returns: MHEG5ErrorCode MHEG5ErrorCode

Definition at line 585 of file mh5text.c.

void MHEG5textActivate ( MHEG5Text * text )

Apply the activation behaviour of the text class. As this class has no own activation behaviour this function just invokes the activation behaviour from the base class.

Parameters

MHEG5Text *text

Returns: void

Definition at line 330 of file mh5text.c.

void MHEG5textClearTextData ( MHEG5Text * text )

Clear text data.

Parameters

text	Text object that content is for.

Returns: void.

Definition at line 1377 of file mh5text.c.

MHEG5Text* MHEG5textClone ( MHEG5Text * source )

Copy a text object with original values.

Returns: *

Definition at line 232 of file mh5text.c.

void MHEG5textContentUnadapt	(	MHEG5Text *	text,
		MHEG5Byte **	utf8Data,
		MHEG5Int *	utf8Len
	)

Undo the adaption of content for Text objects. Adapted content is stored as 16 bit unicode - this is converted back to UTF8.

Parameters

text	Text object that content is for.
utf8Data	Unadapted content (UTF8 encoded).
utf8Len	Length of the unadapted content in bytes.

Returns: void.

Definition at line 1143 of file mh5text.c.

void MHEG5textContentUnadaptUTF16	(	MHEG5Text *	text,
		MHEG5Byte **	utf16Data,
		MHEG5Int *	utf16Len
	)

Undo the adaption of content for Text objects. Adapted content is stored as 16 bit unicode - this is converted back to its original format.

Parameters

text	Text object that content is for.
utf16Data	Unadapted content (UTF16 encoded).
utf16Len	Length of the unadapted content in bytes.

Returns: void.

Definition at line 1261 of file mh5text.c.

void MHEG5textDeactivate ( MHEG5Text * text )

Apply the deactivation behaviour of the text class. As this class has no own deactivation behaviour this function just invokes the deactivation behaviour from the base class.

Parameters

MHEG5Text *text

Returns: void

Definition at line 348 of file mh5text.c.

void MHEG5textDestruct ( MHEG5Text * text )

Destruct a text object.

Parameters

MHEG5Text *text

Returns: void

Definition at line 365 of file mh5text.c.

void MHEG5textFree ( MHEG5Text * text )

Free off all memory associated with the specified object, including any exchanged attributes and internal data. The data holding the object itself is not freed.

Parameters

text	Pointer to object to free.

Returns: Void

Definition at line 204 of file mh5text.c.

void MHEG5textInit ( MHEG5Text * text )

Returns: <Return value>=""> Initialise a text object with default values.

Parameters

text	Pointer to object to initialise.

Returns: Void

Parameters

text	Pointer to object to initialise.

Returns: Void

Definition at line 190 of file mh5text.c.

void MHEG5textPrepare ( MHEG5Text * text )

Apply the preparation behaviour of the text class Apply the preparation behaviour of the text class. As this class has no own preparation behaviour this function just invokes the preparation behaviour from the base class.

Parameters

MHEG5Text *text

Returns: void

Definition at line 293 of file mh5text.c.

void MHEG5textRedraw ( MHEG5Text * text )

Definition at line 386 of file mh5text.c.

void MHEG5textUtf16Content	(	MHEG5Text *	text,
		unsigned char *	data,
		int	len
	)

Content for Text objects is encoded using UTF16.

Parameters

text	Text object that content is for.
data	New content (UTF16 encoded).
len	Length of the new content in bytes.

Returns: void.

Definition at line 961 of file mh5text.c.

void MHEG5textUtf8Content	(	MHEG5Text *	text,
		unsigned char *	data,
		int	len
	)

Adapt new content for Text objects. Content is encoded using UTF8 - this is converted to 16 bit unicode.

Parameters

text	Text object that content is for.
data	New content (UTF8 encoded).
len	Length of the new content in bytes.

Returns: void.

Definition at line 765 of file mh5text.c.

Classes

Macros

Functions

Detailed Description

Macro Definition Documentation

Function Documentation