diff options
Diffstat (limited to 'WWW/Library/Implementation/HText.h')
-rw-r--r-- | WWW/Library/Implementation/HText.h | 147 |
1 files changed, 68 insertions, 79 deletions
diff --git a/WWW/Library/Implementation/HText.h b/WWW/Library/Implementation/HText.h index bd2cc541..8a87cc1c 100644 --- a/WWW/Library/Implementation/HText.h +++ b/WWW/Library/Implementation/HText.h @@ -5,9 +5,9 @@ /* - This is the C interface to the Objective-C (or whatever) Style-oriented HyperText - class. It is used when a style-oriented text object is available or craeted in order to - display hypertext. + This is the C interface to the Objective-C (or whatever) Style-oriented + HyperText class. It is used when a style-oriented text object is available + or craeted in order to display hypertext. */ #ifndef HTEXT_H @@ -18,16 +18,16 @@ #include <SGML.h> #ifndef THINK_C -#ifndef HyperText /* Objective C version defined HyperText */ -typedef struct _HText HText; /* Normal Library */ +#ifndef HyperText /* Objective C version defined HyperText */ +typedef struct _HText HText; /* Normal Library */ #endif #else -class CHyperText; /* Mac Think-C browser hook */ +class CHyperText; /* Mac Think-C browser hook */ typedef CHyperText HText; #endif -extern HText * HTMainText; /* Pointer to current main text */ -extern HTParentAnchor * HTMainAnchor; /* Pointer to current text's anchor */ +extern HText *HTMainText; /* Pointer to current main text */ +extern HTParentAnchor *HTMainAnchor; /* Pointer to current text's anchor */ /* @@ -35,40 +35,41 @@ Creation and deletion HTEXT_NEW: CREATE HYPERTEXT OBJECT - There are several methods depending on how much you want to specify. The output stream - is used with objects which need to output the hypertext to a stream. The structure is - for objects which need to refer to the structure which is kep by the creating stream. + There are several methods depending on how much you want to specify. The + output stream is used with objects which need to output the hypertext to a + stream. The structure is for objects which need to refer to the structure + which is kep by the creating stream. */ - extern HText * HText_new (HTParentAnchor * anchor); +extern HText *HText_new(HTParentAnchor *anchor); - extern HText * HText_new2 (HTParentAnchor * anchor, - HTStream * output_stream); +extern HText *HText_new2(HTParentAnchor *anchor, + HTStream *output_stream); - extern HText * HText_new3 (HTParentAnchor * anchor, - HTStream * output_stream, - HTStructured * structure); +extern HText *HText_new3(HTParentAnchor *anchor, + HTStream *output_stream, + HTStructured * structure); /* FREE HYPERTEXT OBJECT */ -extern void HText_free (HText * me); - +extern void HText_free(HText *me); /* Object Building methods - These are used by a parser to build the text in an object HText_beginAppend must be - called, then any combination of other append calls, then HText_endAppend. This allows - optimised handling using buffers and caches which are flushed at the end. + These are used by a parser to build the text in an object HText_beginAppend + must be called, then any combination of other append calls, then + HText_endAppend. This allows optimised handling using buffers and caches + which are flushed at the end. */ -extern void HText_beginAppend (HText * text); +extern void HText_beginAppend(HText *text); -extern void HText_endAppend (HText * text); +extern void HText_endAppend(HText *text); /* @@ -76,14 +77,14 @@ extern void HText_endAppend (HText * text); */ -extern void HText_setStyle (HText * text, HTStyle * style); +extern void HText_setStyle(HText *text, HTStyle *style); /* ADD ONE CHARACTER */ -extern void HText_appendCharacter (HText * text, int ch); +extern void HText_appendCharacter(HText *text, int ch); /* @@ -91,7 +92,7 @@ extern void HText_appendCharacter (HText * text, int ch); */ -extern void HText_appendText (HText * text, const char * str); +extern void HText_appendText(HText *text, const char *str); /* @@ -100,13 +101,11 @@ extern void HText_appendText (HText * text, const char * str); and similar things */ -extern void HText_appendParagraph (HText * text); - -extern void HText_appendLineBreak (HText * text); - -extern void HText_appendHorizontalRule (HText * text); +extern void HText_appendParagraph(HText *text); +extern void HText_appendLineBreak(HText *text); +extern void HText_appendHorizontalRule(HText *text); /* @@ -116,44 +115,40 @@ extern void HText_appendHorizontalRule (HText * text); /* - The anchor object is created and passed to HText_beginAnchor. The senstive text is - added to the text object, and then HText_endAnchor is called. Anchors may not be - nested. + The anchor object is created and passed to HText_beginAnchor. The senstive + text is added to the text object, and then HText_endAnchor is called. + Anchors may not be nested. */ -extern int HText_beginAnchor ( - HText * text, - BOOL underline, - HTChildAnchor * anc); -extern void HText_endAnchor (HText * text, int number); -extern BOOL HText_isAnchorBlank (HText * text, int number); +extern int HText_beginAnchor(HText *text, BOOL underline, + HTChildAnchor *anc); +extern void HText_endAnchor(HText *text, int number); +extern BOOL HText_isAnchorBlank(HText *text, int number); /* APPEND AN INLINE IMAGE - The image is handled by the creation of an anchor whose destination is the image - document to be included. The semantics is the intended inline display of the image. + The image is handled by the creation of an anchor whose destination is the + image document to be included. The semantics is the intended inline display + of the image. - An alternative implementation could be, for example, to begin an anchor, append the - alternative text or "IMAGE", then end the anchor. This would simply generate some text - linked to the image itself as a separate document. + An alternative implementation could be, for example, to begin an anchor, + append the alternative text or "IMAGE", then end the anchor. This would + simply generate some text linked to the image itself as a separate document. */ -extern void HText_appendImage ( - HText * text, - HTChildAnchor * anc, - const char * alternative_text, - int alignment, - BOOL isMap); +extern void HText_appendImage(HText *text, HTChildAnchor *anc, + const char *alternative_text, + int alignment, + BOOL isMap); /* RETURN THE ANCHOR ASSOCIATED WITH THIS NODE */ -extern HTParentAnchor * HText_nodeAnchor (HText * me); - +extern HTParentAnchor *HText_nodeAnchor(HText *me); /* @@ -161,63 +156,57 @@ Browsing functions */ - /* BRING TO FRONT AND HIGHLIGHT IT */ - -extern BOOL HText_select (HText * text); -extern BOOL HText_selectAnchor (HText * text, HTChildAnchor* anchor); +extern BOOL HText_select(HText *text); +extern BOOL HText_selectAnchor(HText *text, HTChildAnchor *anchor); /* Editing functions - These are called from the application. There are many more functions not included here - from the orginal text object. These functions NEED NOT BE IMPLEMENTED in a browser - which cannot edit. + These are called from the application. There are many more functions not + included here from the orginal text object. These functions NEED NOT BE + IMPLEMENTED in a browser which cannot edit. */ /* Style handling: */ /* Apply this style to the selection */ -extern void HText_applyStyle (HText * me, HTStyle *style); +extern void HText_applyStyle(HText *me, HTStyle *style); /* Update all text with changed style. */ -extern void HText_updateStyle (HText * me, HTStyle *style); +extern void HText_updateStyle(HText *me, HTStyle *style); /* Return style of selection */ -extern HTStyle * HText_selectionStyle ( - HText * me, - HTStyleSheet* sheet); +extern HTStyle *HText_selectionStyle(HText *me, HTStyleSheet *sheet); /* Paste in styled text */ -extern void HText_replaceSel (HText * me, - const char *aString, - HTStyle* aStyle); +extern void HText_replaceSel(HText *me, const char *aString, + HTStyle *aStyle); /* Apply this style to the selection and all similarly formatted text -** (style recovery only) -*/ -extern void HTextApplyToSimilar (HText * me, HTStyle *style); + * (style recovery only) + */ +extern void HTextApplyToSimilar(HText *me, HTStyle *style); /* Select the first unstyled run. -** (style recovery only) -*/ -extern void HTextSelectUnstyled (HText * me, HTStyleSheet *sheet); - + * (style recovery only) + */ +extern void HTextSelectUnstyled(HText *me, HTStyleSheet *sheet); /* Anchor handling: */ -extern void HText_unlinkSelection (HText * me); -extern HTAnchor * HText_referenceSelected (HText * me); -extern HTAnchor * HText_linkSelTo (HText * me, HTAnchor* anchor); +extern void HText_unlinkSelection(HText *me); +extern HTAnchor *HText_referenceSelected(HText *me); +extern HTAnchor *HText_linkSelTo(HText *me, HTAnchor * anchor); #endif /* HTEXT_H */ |