216 HTP
The HTP (hypertext procedures) and HTF (hypertext functions) packages generate HTML tags. For example, the HTP.ANCHOR procedure generates the HTML anchor tag, <A>.
This chapter contains the following topics:
See Also:
For more information about implementation of this package:
216.1 HTP Operational Notes
Certain operational notes apply to the HTP package.
For every HTP procedure that generates one or more HTML tags, there is a corresponding HTF function with identical parameters with the following exception:
-
The PRINTS Procedure and the PS Procedure do not have HTF function equivalents. Use the ESCAPE_SC Function or the ESCAPE_URL Function if you need a string conversion function. Note that while there is a ESCAPE_SC Procedure that performs the same operation as the PRINTS Procedure and the PS Procedure, there is no procedural equivalent for the ESCAPE_URL Function.
-
The FORMAT_CELL Function does not have an HTP equivalent. The function formats column values inside an HTML table using TABLEDATA Function which does have an HTP equivalent in the TABLEDATA Procedure. The advantage of this using the FORMAT_CELL Function is that it allows for better control over the HTML tables.
The function versions do not directly generate output in your Web page. Instead, they pass their output as return values to the statements that invoked them. Use these functions when you need to nest calls. To print the output of HTF functions, call the functions from within the HTP.PRINT procedure. It then prints its parameters to the generated Web page.
216.2 HTP Rules and Limits
If you use values of the LONG datatype in procedures such as HTP.PRINT, HTP.PRN, HTP.PRINTS, HTP.PA or OWA_UTIL.CELLSPRINT, only the first 32 K of the LONG data is used. The LONG data is bound to a VARCHAR2 datatype in the procedure.
216.3 HTP Examples
These commands generate a simple HTML document.
CREATE OR REPLACE PROCEDURE hello AS
BEGIN
HTP.HTMLOPEN; -- generates <HTML>
HTP.HEADOPEN; -- generates <HEAD>
HTP.TITLE('Hello'); -- generates <TITLE>Hello</TITLE>
HTP.HEADCLOSE; -- generates </HEAD>
HTP.BODYOPEN; -- generates <BODY>
HTP.HEADER(1, 'Hello'); -- generates <H1>Hello</H1>
HTP.BODYCLOSE; -- generates </BODY>
HTP.HTMLCLOSE; -- generates </HTML>
END;216.4 HTP Summary of Tags
HTP tags can be grouped by type, to make understanding them easier.
HTML, HEAD, and BODY Tags
HTMLOPEN Procedure, HTMLCLOSE Procedure - generate <HTML> and </HTML>
HEADOPEN Procedure, HEADCLOSE Procedure - generate <HEAD> and </HEAD>
BODYOPEN Procedure, BODYCLOSE Procedure - generate <BODY> and </BODY>
Comment Tag
COMMENT Procedure - generates <!-- and -->
Tags in the <HEAD> Area
BASE Procedure - generates <BASE>
LINKREL Procedure - generates <LINK> with the REL attribute
LINKREV Procedure - generates <LINK> with the REV attribute
TITLE Procedure - generates <TITLE>
META Procedure - generates <META>
SCRIPT Procedure - generates <SCRIPT>
STYLE Procedure - generates <STYLE>
ISINDEX Procedure - generates <ISINDEX>
Applet Tags
APPLETOPEN Procedure, APPLETCLOSE Procedure - generate <APPLET> and </APPLET>
PARAM Procedure - generates <PARAM>
List Tags
OLISTOPEN Procedure, OLISTCLOSE Procedure - generate <OL> and </OL>
ULISTOPEN Procedure, ULISTCLOSE Procedure - generate <UL> and </UL>
DLISTOPEN Procedure, DLISTCLOSE Procedure- generate <DL> and </DL>
DLISTTERM Procedure - generates <DT>
DLISTDEF Procedure - generates <DD>
DIRLISTOPEN Procedure, DIRLISTCLOSE Procedure - generate <DIR> and </DIR>
LISTHEADER Procedure - generates <LH>
LISTINGOPEN Procedure, LISTINGCLOSE Procedure - generate <LISTING> and </LISTING>
MENULISTOPEN Procedure - generate <MENU> and </MENU>
LISTITEM Procedure - generates <LI>
Form Tags
FORMOPEN Procedure, FORMCLOSE Procedure - generate <FORM> and </FORM>
FORMCHECKBOX Procedure - generates <INPUT TYPE="CHECKBOX">
FORMHIDDEN Procedure - generates <INPUT TYPE="HIDDEN">
FORMIMAGE Procedure - generates <INPUT TYPE="IMAGE">
FORMPASSWORD Procedure - generates <INPUT TYPE="PASSWORD">
FORMRADIO Procedure - generates <INPUT TYPE="RADIO">
FORMSELECTOPEN Procedure, FORMSELECTCLOSE Procedure - generate <SELECT> and </SELECT>
FORMSELECTOPTION Procedure - generates <OPTION>
FORMTEXT Procedure - generates <INPUT TYPE="TEXT">
FORMTEXTAREA Procedure - generate <TEXTAREA>
FORMTEXTAREAOPEN Procedure, FORMTEXTAREACLOSE Procedure - generate <TEXTAREA> and </TEXTAREA>
FORMRESET Procedure - generates <INPUT TYPE="RESET">
FORMSUBMIT Procedure - generates <INPUT TYPE="SUBMIT">
Table Tags
TABLEOPEN Procedure, TABLECLOSE Procedure - generate <TABLE> and </TABLE>
TABLECAPTION Procedure - generates <CAPTION>
TABLEROWOPEN Procedure, TABLEROWCLOSE Procedure - generate <TR> and </TR>
TABLEHEADER Procedure - generates <TH>
TABLEDATA Procedure - generates <TD>
IMG, HR, and A Tags
HR Procedure, LINE Procedure - generate <HR>
IMG Procedure, IMG2 Procedure - generate <IMG>
ANCHOR Procedure, ANCHOR2 Procedure - generate <A>
MAPOPEN Procedure, MAPCLOSE Procedure - generate <MAP> and </MAP>
Paragraph Formatting Tags
HEADER Procedure - generates heading tags (<H1> to <H6>)
PARA Procedure, PARAGRAPH Procedure - generate <P>
PRN Procedures, PRINT Procedures - generate any text that is passed in
PRINTS Procedure, PS Procedure - generate any text that is passed in; special characters in HTML are escaped
PREOPEN Procedure, PRECLOSE Procedure - generate <PRE> and </PRE>
BLOCKQUOTEOPEN Procedure, BLOCKQUOTECLOSE Procedure - generate <BLOCKQUOTE> and </BLOCKQUOTE>
DIV Procedure - generates <DIV>
NL Procedure, BR Procedure - generate <BR>
NOBR Procedure - generates <NOBR>
WBR Procedure - generates <WBR>
PLAINTEXT Procedure - generates <PLAINTEXT>
ADDRESS Procedure - generates <ADDRESS>
MAILTO Procedure - generates <A> with the MAILTO attribute
AREA Procedure - generates <AREA>
BGSOUND Procedure - generates <BGSOUND>
Character Formatting Tags
BASEFONT Procedure - generates <BASEFONT>
BIG Procedure - generates <BIG>
BOLD Procedure - generates <B>
CENTER Procedure - generates <CENTER> and </CENTER>
CENTEROPEN Procedure, CENTERCLOSE Procedure - generate <CENTER> and </CENTER>
CITE Procedure - generates <CITE>
CODE Procedure - generates <CODE>
DFN Procedure - generates <DFN>
EM Procedure, EMPHASIS Procedure - generate <EM>
FONTOPEN Procedure, FONTCLOSE Procedure - generate <FONT> and </FONT>
ITALIC Procedure - generates <I>
KBD Procedure, KEYBOARD Procedure - generate <KBD> and </KBD>
S Procedure - generates <S>
SAMPLE Procedure - generates <SAMP>
SMALL Procedure - generates <SMALL>
STRIKE Procedure - generates <STRIKE>
STRONG Procedure - generates <STRONG>
SUB Procedure - generates <SUB>
SUP Procedure - generates <SUP>
TELETYPE Procedure - generates <TT>
UNDERLINE Procedure - generates <U>
VARIABLE Procedure - generates <VAR>
Frame Tags
FRAME Procedure - generates <FRAME>
FRAMESETOPEN Procedure, FRAMESETCLOSE Procedure - generate <FRAMESET> and </FRAMESET>
NOFRAMESOPEN Procedure, NOFRAMESCLOSE Procedure - generate <NOFRAMES> and </NOFRAMES>
216.5 Summary of HTP Subprograms
This table lists the HTP subprograms and briefly describes them.
Table 216-1 HTP Package Subprograms
| Subprogram | Description |
|---|---|
|
Generates |
|
|
Generates |
|
|
Generates the |
|
|
Closes the applet invocation with the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
|
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Replaces characters that have special meaning in HTML with their escape sequences |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
|
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates opening heading tags |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
|
|
|
Creates a single entry field with a prompting text, such as "enter value," then sends that value to the URL of the page or program |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the <KBD> and </KBD> tags, which direct the browser to render the text in monospace font |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Adds attributes to the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the specified parameter as a string terminated with the |
|
|
Generates a string and replaces the following characters with the corresponding escape sequence |
|
|
Generates the specified parameter as a string |
|
|
Generates a string and replaces the following characters with the corresponding escape sequence. |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the <TABLE> tag which marks the beginning of an HTML table |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
|
|
Generates the |
216.5.1 ADDRESS Procedure
This procedure generates the <ADDRESS> and </ADDRESS> tags which specify the address, author and signature of a document.
Syntax
HTP.ADDRESS ( cvalue IN VARCHAR2 cnowrap IN VARCHAR2 DEFAULT NULL cclear IN VARCHAR2 DEFAULT NULL cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-2 ADDRESS Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The string that goes between the |
|
|
If the value for this parameter is not |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag |
Examples
This procedure generates
<ADDRESS CLEAR="cclear" NOWRAP cattributes>cvalue</ADDRESS>
216.5.2 ANCHOR Procedure
Like the ANCHOR2 procedure, this procedure generates the <A> and </A> HTML tags which specify the source or destination of a hypertext link.
The difference between these subprograms is that the ANCHOR2 Procedure provides a target and therefore can be used for a frame.
Syntax
HTP.ANCHOR ( curl IN VARCHAR2, ctext IN VARCHAR2, cname IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-3 ANCHOR Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The string that goes between the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<A HREF="curl" NAME="cname" cattributes>ctext</A>
Usage Notes
This tag accepts several attributes, but either HREF or NAME is required. HREF specifies to where to link. NAME allows this tag to be a target of a hypertext link.
216.5.3 ANCHOR2 Procedure
Like the ANCHOR procedure, this procedure generates the <A> and </A> HTML tags which specify the source or destination of a hypertext link.
The difference between this procedure and the ANCHOR procedure is that this procedure provides a target and therefore can be used for a frame.
Syntax
HTP.ANCHOR2 ( curl IN VARCHAR2, ctext IN VARCHAR2, cname IN VARCHAR2 DEFAULT NULL, ctarget in varchar2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-4 ANCHOR2 Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The string that goes between the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag |
Examples
This procedure generates
<A HREF="curl" NAME="cname" TARGET = "ctarget" cattributes>ctext</A>
216.5.4 APPLETCLOSE Procedure
This procedure closes the applet invocation with the </APPLET> tag.
You must first invoke the a Java applet using APPLETOPEN Procedure.
Syntax
HTP.APPLETCLOSE;
216.5.5 APPLETOPEN Procedure
This procedure generates the <APPLET> tag which begins the invocation of a Java applet.
You close the applet invocation with APPLETCLOSE Procedure which generates the </APPLET> tag.
Syntax
HTP.APPLETOPEN ( ccode IN VARCHAR2, cheight IN NUMBER, cwidth IN NUMBER, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-5 APPLETOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The the value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<APPLET CODE=ccode HEIGHT=cheight WIDTH=cwidth cattributes>
so that, for example,
HTP.appletopen('testclass.class', 100, 200, 'CODEBASE="/ows-applets"')
generates
<APPLET CODE="testclass.class" height=100 width=200 CODEBASE="/ows-applets">
Usage Notes
-
Specify parameters to the Java applet using the PARAM Procedure.
-
Use the
cattributesparameter to specify theCODEBASEattribute since the PL/SQL cartridge does not know where to find the class files. TheCODEBASEattribute specifies the virtual path containing the class files.
216.5.6 AREA Procedure
This procedure generates the <AREA> tag, which defines a client-side image map. The <AREA> tag defines areas within the image and destinations for the areas.
Syntax
HTP.AREA ( ccoords IN VARCHAR2 cshape IN VARCHAR2 DEFAULT NULL, chref IN VARCHAR2 DEFAULT NULL, cnohref IN VARCHAR2 DEFAULT NULL, ctarget IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-6 AREA Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The the value for the |
|
|
The value for the |
|
|
The value for the |
|
|
If the value for this parameter is not |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<AREA COORDS="ccoords" SHAPE="cshape" HREF="chref" NOHREF TARGET="ctarget" cattributes>
216.5.7 BASE Procedure
This procedure generates the <BASE> tag which records the URL of the document.
Syntax
HTP.BASE ( ctarget IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-7 BASE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<BASE HREF="<current URL>" TARGET="ctarget" cattributes>
216.5.8 BASEFONT Procedure
This procedure generates the <BASEFONT> tag which specifies the base font size for a Web page.
Syntax
HTP.BASEFONT ( nsize IN INTEGER);
Parameters
Table 216-8 BASEFONT Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
Examples
This procedure generates
<BASEFONT SIZE="nsize">216.5.9 BGSOUND Procedure
This procedure generates the <BGSOUND> tag which includes audio for a Web page.
Syntax
HTP.BGSOUND ( csrc IN VARCHAR2, cloop IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-9 BGSOUND Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<BGSOUND SRC="csrc" LOOP="cloop" cattributes>
216.5.10 BIG Procedure
This procedure generates the <BIG> and </BIG> tags which direct the browser to render the text in a bigger font.
Syntax
HTP.BIG ( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-10 BIG Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The the text that goes between the tags. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<BIG cattributes>ctext</BIG>
216.5.11 BLOCKQUOTECLOSE Procedure
This procedure generates the </BLOCKQUOTE> tag which mark the end of a section of quoted text.
You mark the beginning of a section of text by means of the BLOCKQUOTEOPEN Procedure.
Syntax
HTP.BLOCKQUOTECLOSE;
Examples
This procedure generates
</BLOCKQUOTE>
216.5.12 BLOCKQUOTEOPEN Procedure
This procedure generates the <BLOCKQUOTE> tag, which marks the beginning of a section of quoted text.
You mark the end of a section of text by means of the BLOCKQUOTECLOSE Procedure.
Syntax
HTP.BLOCKQUOTEOPEN ( cnowrap IN VARCHAR2 DEFAULT NULL, cclear IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-11 BLOCKQUOTEOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
If the value for this parameter is not |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<BLOCKQUOTE CLEAR="cclear" NOWRAP cattributes>
216.5.13 BODYCLOSE Procedure
This procedure generates the </BODY> tag which marks the end of a body section of an HTML document.
You mark the beginning of a body section by means of the BODYOPEN Procedure.
Syntax
HTP.BODYCLOSE;
Examples
This procedure generates
</BODY>
216.5.14 BODYOPEN Procedure
This procedure generates the <BODY> tag which marks the beginning of the body section of an HTML document.
You mark the end of a body section by means of the BODYCLOSE Procedure.
Syntax
HTP.BODYOPEN ( cbackground IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-12 BODYOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<BODY background="cbackground" cattributes>
so that
HTP.BODYOPEN('/img/background.gif');
generates:
<BODY background="/img/background.gif">
216.5.15 BOLD Procedure
This procedure generates the <B> and </B> tags which direct the browser to display the text in boldface.
Syntax
HTP.BOLD ( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-13 BOLD Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text that goes between the tags. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<B cattributes>ctext</B>
216.5.16 BR Procedure
This procedure generates the <BR> tag which begins a new line of text.
It performs the same operation as the NL Procedure.
Syntax
HTP.BR( cclear IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-14 BR Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<BR CLEAR="cclear" cattributes>
216.5.17 CENTER Procedure
This procedure generates the <CENTER> and </CENTER> tags which center a section of text within a Web page.
Syntax
HTP.CENTER ( ctext IN VARCHAR2);
Parameters
Table 216-15 CENTER Parameters
| Parameter | Description |
|---|---|
|
|
The text that goes between the tags. |
Examples
This procedure generates
<CENTER>ctext</CENTER>216.5.18 CENTERCLOSE Procedure
This procedure generates the </CENTER> tag which marks the end of a section of text to center.
You mark the beginning of a section of text to center with the CENTEROPEN Procedure.
Syntax
HTP.CENTERCLOSE;
Examples
This procedure generates
</CENTER>
216.5.19 CENTEROPEN Procedure
This procedure generates the <CENTER> tag which mark the beginning of a section of text to center.
You mark the beginning of a of a section of text to center by means of the CENTERCLOSE Procedure.
Syntax
HTP.CENTEROPEN;
Examples
This procedure generates
<CENTER>
216.5.20 CITE Procedure
This procedure generates the <CITE> and </CITE> tags which direct the browser to render the text as a citation.
Syntax
HTP.CITE ( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-16 CITE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to render as citation. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<CITE cattributes>ctext</CITE>
216.5.21 CODE Procedure
This procedure generates the <CODE> and </CODE> tags which direct the browser to render the text in monospace font or however "code" is defined stylistically.
Syntax
HTP.CODE ( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-17 CODE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to render as code. |
|
|
The other attributes to be included as-is in the tag |
Examples
This procedure generates
<CODE cattributes>ctext</CODE>
216.5.22 COMMENT Procedure
This procedure generates the comment tags.
Syntax
HTP.COMMENT ( ctext IN VARCHAR2);
Parameters
Table 216-18 COMMENT Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The comment. |
Examples
This procedure generates
<!-- ctext -->216.5.23 DFN Procedure
This procedure generates the <DFN> and </DFN> tags which direct the browser to mark the text in italics or however "definition" is described stylistically.
Syntax
HTP.DFN ( ctext IN VARCHAR2);
Parameters
Table 216-19 DFN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to render in italics. |
Examples
This procedure generates
<DFN>ctext</DFN>216.5.24 DIRLISTCLOSE Procedure
This procedure generates the </DIR> tag which ends a directory list section. You start a directory list section with the DIRLISTOPEN Procedure.
Syntax
HTP.DIRLISTCLOSE;
Usage Notes
A directory list presents a list of items that contains up to 20 characters. Items in this list are typically arranged in columns, 24 characters wide. Insert the <LI> tag directly or invoke the LISTITEM Procedure so that the <LI> tag appears directly after the </DIR> tag to define the items as a list.
Examples
This procedure generates
</DIR>
Related Topics
216.5.25 DIRLISTOPEN Procedure
This procedure generates the <DIR> which starts a directory list section. You end a directory list section with the DIRLISTCLOSE Procedure.
Syntax
HTP.DIRLISTOPEN;
Usage Notes
A directory list presents a list of items that contains up to 20 characters. Items in this list are typically arranged in columns, 24 characters wide. Insert the <LI> tag directly or invoke the LISTITEM Procedure so that the <LI> tag appears directly after the </DIR> tag to define the items as a list.
Examples
This procedure generates
<DIR>
Related Topics
216.5.26 DIV Procedure
This procedure generates the <DIV> tag which creates document divisions.
Syntax
HTP.DIV ( calign IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-20 DIV Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<DIV ALIGN="calign" cattributes>
216.5.27 DLISTCLOSE Procedure
This procedure generates the </DL> tag which ends a definition list. You start a definition list by means of the DLISTOPEN Procedure.
Syntax
HTP.DLISTCLOSE;
Usage Notes
A definition list looks like a glossary: it contains terms and definitions. Terms are inserted using the DLISTTERM Procedure and definitions are inserted using the DLISTDEF Procedure.
Examples
This procedure generates
</DL>
Related Topics
216.5.28 DLISTDEF Procedure
This procedure generates the <DD> tag, which inserts definitions of terms. Use this tag for a definition list <DL>. Terms are tagged <DT> and definitions are tagged <DD>.
Syntax
HTP.DLISTDEF ( ctext IN VARCHAR2 DEFAULT NULL, cclear IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-21 DLISTDEF Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The definition of the term. |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<DD CLEAR="cclear" cattributes>ctext
216.5.29 DLISTOPEN Procedure
This procedure generates the <DL> tag which starts a definition list. You end a definition list by means of the DLISTCLOSE Procedure.
Syntax
HTP.DLISTOPEN ( cclear IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-22 DLISTOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Usage Notes
A definition list looks like a glossary: it contains terms and definitions. Terms are inserted using the DLISTTERM Procedure and definitions are inserted using the DLISTDEF Procedure.
Examples
This procedure generates
<DL CLEAR="cclear" cattributes>
Related Topics
216.5.30 DLISTTERM Procedure
This procedure generates the <DT> tag which defines a term in a definition list <DL>.
Syntax
HTP.DLISTTERM ( ctext IN VARCHAR2 DEFAULT NULL, cclear IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-23 DLISTTERM Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The term. |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<DT CLEAR="cclear" cattributes>ctext
216.5.31 EM Procedure
This procedure generates the <EM> and </EM> tags, which define text to be emphasized.
It performs the same task as the EMPHASIS Procedure.
Syntax
HTP.EM( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-24 EM Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to emphasize. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<EM cattributes>ctext</EM>
216.5.32 EMPHASIS Procedure
This procedure generates the <EM> and </EM> tags, which define text to be emphasized.
It performs the same task as the EM Procedure.
Syntax
HTP.EMPHASIS( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-25 EMPHASIS Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to emphasize. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<EM cattributes>ctext</EM>
216.5.33 ESCAPE_SC Procedure
This procedure replaces characters that have special meaning in HTML with their escape sequences.
The following characters are converted:
-
&to& -
"to": -
<to< -
>to>
This procedure performs the same operation as PRINTS Procedures and PS Procedure.
Syntax
HTP.ESCAPE_SC( ctext IN VARCHAR2);
Parameters
Table 216-26 ESCAPE_SC Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text string to convert. |
216.5.34 FONTCLOSE Procedure
This procedure generates the</FONT> tag which marks the end of a section of text with the specified font characteristics.
You mark the beginning of the section text by means of the FONTOPEN Procedure.
Syntax
HTP.FONTCLOSE;
Examples
This procedure generates
</FONT>
216.5.35 FONTOPEN Procedure
This procedure generates the <FONT> which marks the beginning of section of text with the specified font characteristics.
You mark the end of the section text by means of the FONTCLOSE Procedure.
Syntax
HTP.FONTOPEN( ccolor IN VARCHAR2 DEFAULT NULL, cface IN VARCHAR2 DEFAULT NULL, csize IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-27 FONTOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<FONT COLOR="ccolor" FACE="cface" SIZE="csize" cattributes>
216.5.36 FORMCHECKBOX Procedure
This procedure generates the <INPUT> tag with TYPE="checkbox" which inserts a checkbox element in a form.
A checkbox element is a button that the user toggles on or off.
Syntax
HTP.FORMCHECKBOX( cname IN VARCHAR2, cvalue IN VARCHAR2 DEFAULT 'ON', cchecked IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-28 FORMCHECKBOX Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
If the value for this parameter is not |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<INPUT TYPE="checkbox" NAME="cname" VALUE="cvalue" CHECKED cattributes>
216.5.37 FORMCLOSE Procedure
This procedure generates the </FORM> tag which marks the end of a form section in an HTML document.
You mark the beginning of the form section by means of the FORMOPEN Procedure.
Syntax
HTP.FORMCLOSE;
Examples
This procedure generates
</FORM>
216.5.38 FORMOPEN Procedure
This procedure generates the <FORM> tag which marks the beginning of a form section in an HTML document.
You mark the end of the form section by means of the FORMCLOSE Procedure.
Syntax
HTP.FORMOPEN( curl IN VARCHAR2, cmethod IN VARCHAR2 DEFAULT 'POST', ctarget IN VARCHAR2 DEFAULT NULL, cenctype IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-29 FORMOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The URL of the WRB or CGI script where the contents of the form is sent. This parameter is required. |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<FORM ACTION="curl" METHOD="cmethod" TARGET="ctarget" ENCTYPE="cenctype" cattributes>
216.5.39 FORMFILE Procedure
This procedure generates the <INPUT> tag with TYPE="file" which inserts a file form element. This is used for file uploading for a given page.
Syntax
HTP.FORMFILE( cname IN VARCHAR2, caccept IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-30 FORMFILE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
A comma-delimited list of MIME types for upload. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<INPUT TYPE="file" NAME="cname" ACCEPT="caccept" cattributes>
216.5.40 FORMHIDDEN Procedure
This procedure generates the <INPUT> tag with TYPE="hidden", which inserts a hidden form element.
This element is not seen by the user. It submits additional values to the script.
Syntax
HTP.FORMHIDDEN( cname IN VARCHAR2, cvalue IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-31 FORMHIDDEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<INPUT TYPE="hidden" NAME="cname" VALUE="cvalue" cattributes>
216.5.41 FORMIMAGE Procedure
This procedure generates the <INPUT> tag with TYPE="image" which creates an image field that the user clicks to submit the form immediately.
The coordinates of the selected point are measured in pixels, and returned (along with other contents of the form) in two name/value pairs. The x coordinate is submitted under the name of the field with .x appended, and the y coordinate with .y appended. Any VALUE attribute is ignored.
Syntax
HTP.FORMIMAGE( cname IN VARCHAR2, csrc IN VARCHAR2, calign IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-32 FORMIMAGE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<INPUT TYPE="image" NAME="cname" SRC="csrc" ALIGN="calign" cattributes>
216.5.42 FORMPASSWORD Procedure
This procedure generates the <INPUT> tag with TYPE="password" which creates a single-line text entry field. When the user enters text in the field, each character is represented by one asterisk. This is used for entering passwords.
Syntax
HTP.FORMPASSWORD( cname IN VARCHAR2, csize IN VARCHAR2, cmaxlength IN VARCHAR2 DEFAULT NULL, cvalue IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-33 FORMPASSWORD Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<INPUT TYPE="password" NAME="cname" SIZE="csize" MAXLENGTH="cmaxlength" VALUE="cvalue" cattributes>
216.5.43 FORMRADIO Procedure
This procedure generates the <INPUT> tag with TYPE="radio", which creates a radio button on the HTML form. Within a set of radio buttons, the user selects only one. Each radio button in the same set has the same name, but different values. The selected radio button generates a name/value pair.
Syntax
HTP.FORMRADIO( cname IN VARCHAR2, cvalue IN VARCHAR2, cchecked IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-34 FORMRADIO Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
If the value for this parameter is not |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<INPUT TYPE="radio" NAME="cname" VALUE="cvalue" CHECKED cattributes>
216.5.44 FORMRESET Procedure
This procedure generates the <INPUT> tag with TYPE="reset" which creates a button that, when selected, resets the form fields to their initial values.
Syntax
HTP.FORMRESET( cvalue IN VARCHAR2 DEFAULT 'Reset', cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-35 FORMRESET Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<INPUT TYPE="reset" VALUE="cvalue" cattributes>
216.5.45 FORMSELECTCLOSE Procedure
This procedure generates the </SELECT> tag which marks the end of a Select form element.
A Select form element is a listbox where the user selects one or more values. You mark the beginning of Select form element by means of the FORMSELECTOPEN Procedure.The values are inserted using FORMSELECTOPTION Procedure.
Syntax
HTP.FORMSELECTCLOSE;
216.5.46 FORMSELECTOPEN Procedure
This procedure generates the <SELECT> tags which creates a Select form element.
A Select form element is a listbox where the user selects one or more values. You mark the end of Select form element by means of the FORMSELECTCLOSE Procedure.The values are inserted using FORMSELECTOPTION Procedure.
Syntax
FORMSELECTOPEN( cname IN VARCHAR2, cprompt IN VARCHAR2 DEFAULT NULL, nsize IN INTEGER DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-36 FORMSELECTOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The string preceding the list box. |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
cprompt <SELECT NAME="cname" SIZE="nsize" cattributes> </SELECT>
so that
HTP.FORMSELECTOPEN('greatest_player';
'Pick the greatest player:');
HTP.FORMSELECTOPTION('Messier');
HTP.FORMSELECTOPTION('Howe');
HTP.FORMSELECTOPTION('Gretzky');.
HTP.FORMSELECTCLOSE;
generates
Pick the greatest player: <SELECT NAME="greatest_player"> <OPTION>Messier <OPTION>Howe <OPTION>Gretzky </SELECT>
216.5.47 FORMSELECTOPTION Procedure
This procedure generates the <OPTION> tag which represents one choice in a Select element.
Syntax
HTP.FORMSELECTOPTION( cvalue IN VARCHAR2, cselected IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-37 FORMSELECTOPTION Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text for the option. |
|
|
If the value for this parameter is not |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<OPTION SELECTED cattributes>cvalue
as shown under Examples of the FORMSELECTOPEN Procedure.
216.5.48 FORMSUBMIT Procedure
This procedure generates the <INPUT> tag with TYPE="submit" which creates a button that, when clicked, submits the form. If the button has a NAME attribute, the button contributes a name/value pair to the submitted data.
Syntax
HTP.FORMSUBMIT( cname IN VARCHAR2 DEFAULT NULL, cvalue IN VARCHAR2 DEFAULT 'Submit', cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-38 FORMSUBMIT Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<INPUT TYPE="submit" NAME="cname" VALUE="cvalue" cattributes>
216.5.49 FORMTEXT Procedure
This procedure generates the <INPUT> tag with TYPE="text", which creates a field for a single line of text.
Syntax
HTP.FORMTEXT( cname IN VARCHAR2, csize IN VARCHAR2 DEFAULT NULL, cmaxlength IN VARCHAR2 DEFAULT NULL, cvalue IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-39 FORMTEXT Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<INPUT TYPE="text" NAME="cname" SIZE="csize" MAXLENGTH="cmaxlength" VALUE="cvalue" cattributes>
216.5.50 FORMTEXTAREA Procedure
This procedure generates the <TEXTAREA> tag, which creates a text field that has no predefined text in the text area. This field enables entering several lines of text.
The same operation is performed by the FORMTEXTAREA2 Procedure which in addition has the cwrap parameter that lets you specify a wrap style.
Syntax
HTP.FORMTEXTAREA( cname IN VARCHAR2, nrows IN INTEGER, ncolumns IN INTEGER, calign , IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-40 FORMTEXTAREA Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<TEXTAREA NAME="cname" ROWS="nrows" COLS="ncolumns" ALIGN="calign" cattributes></TEXTAREA>
216.5.51 FORMTEXTAREA2 Procedure
This procedure generates the <TEXTAREA> tag, which creates a text field that has no predefined text in the text area. This field enables entering several lines of text.
The same operation is performed by the FORMTEXTAREA Procedure except that in that case you cannot specify a wrap style.
Syntax
HTP.FORMTEXTAREA2( cname IN VARCHAR2, nrows IN INTEGER, ncolumns IN INTEGER, calign IN VARCHAR2 DEFAULT NULL, cwrap IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-41 FORMTEXTAREA2 Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<TEXTAREA NAME="cname" ROWS="nrows" COLS="ncolumns" ALIGN="calign" WRAP="cwrap" cattributes></TEXTAREA>
216.5.52 FORMTEXTAREACLOSE Procedure
This procedure generates the </TEXTAREA> tag which ends a text area form element.
You open a text area element by means of either FORMTEXTAREAOPEN Procedure or FORMTEXTAREAOPEN2 Procedure.
Syntax
HTP.FORMTEXTAREACLOSE;
Examples
This procedure generates
</TEXTAREA>
216.5.53 FORMTEXTAREAOPEN Procedure
This procedure generates the <TEXTAREA> which marks the beginning of a text area form element.
The same operation is performed by the FORMTEXTAREAOPEN2 Procedure which in addition has the cwrap parameter that lets you specify a wrap style. You mark the end of a text area form element by means of the FORMTEXTAREACLOSE Procedure.
Syntax
HTP.FORMTEXTAREAOPEN( cname IN VARCHAR2, nrows IN INTEGER, ncolumns IN INTEGER, calign IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-42 FORMTEXTAREAOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<TEXTAREA NAME="cname" ROWS="nrows" COLS="ncolumns" ALIGN="calign" cattributes>
216.5.54 FORMTEXTAREAOPEN2 Procedure
This procedure generates the <TEXTAREA> which marks the beginning of a text area form element.
The same operation is performed by the FORMTEXTAREAOPEN Procedure except that in that case you cannot specify a wrap style. You mark the end of a text area form element by means of the FORMTEXTAREACLOSE Procedure.
Syntax
HTP.FORMTEXTAREAOPEN2( cname IN VARCHAR2, nrows IN INTEGER, ncolumns IN INTEGER, calign IN VARCHAR2 DEFAULT NULL, cwrap IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-43 FORMTEXTAREAOPEN2 Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<TEXTAREA NAME="cname" ROWS="nrows" COLS="ncolumns" ALIGN="calign" WRAP = "cwrap" cattributes>
216.5.55 FRAME Procedure
This procedure generates the <FRAME> tag which begins the characteristics of a frame created by a <FRAMESET> tag.
Syntax
HTP.FRAME( csrc IN VARCHAR2, cname IN VARCHAR2 DEFAULT NULL, cmarginwidth IN VARCHAR2 DEFAULT NULL, cmarginheight IN VARCHAR2 DEFAULT NULL, cscrolling IN VARCHAR2 DEFAULT NULL, cnoresize IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-44 FRAME Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The URL to display in the frame. |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
If the value for this parameter is not |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<FRAME SRC="csrc" NAME="cname" MARGINWIDTH="cmarginwidth" MARGINHEIGHT="cmarginheight" SCROLLING="cscrolling" NORESIZE cattributes>
216.5.56 FRAMESETCLOSE Procedure
This procedure generates the </FRAMESET> tag which ends a frameset section.
You mark the beginning of a frameset section by means of the FRAMESETOPEN Procedure.
Syntax
HTP.FRAMESETCLOSE;
Examples
This procedure generates
</FRAMESET>
216.5.57 FRAMESETOPEN Procedure
This procedure generates the <FRAMESET> tag which define a frameset section.
You mark the end of a frameset section by means of the FRAMESETCLOSE Procedure.
Syntax
HTP.FRAMESETOPEN( crows IN VARCHAR2 DEFAULT NULL, ccols IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-45 FRAMESETOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<FRAMESET ROWS="crows" COLS="ccols" cattributes>
216.5.58 HEADCLOSE Procedure
This procedure generates the </HEAD> tag which marks the end of an HTML document head section.
You mark the beginning of an HTML document head section by means of the HEADOPEN Procedure.
Syntax
HTP.HEADCLOSE;
Examples
This procedure generates
</HEAD>
216.5.59 HEADER Procedure
This procedure generates opening heading tags (<H1> to <H6>) and their corresponding closing tags (</H1> to </H6>).
Syntax
HTP.HEADER( nsize IN INTEGER, cheader IN VARCHAR2, calign IN VARCHAR2 DEFAULT NULL, cnowrap IN VARCHAR2 DEFAULT NULL, cclear IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-46 HEADER Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The the heading level. This is an integer between 1 and 6. |
|
|
The text to display in the heading. |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
HTP.header (1,'Overview');
produces:
<H1>Overview</H1>
216.5.60 HEADOPEN Procedure
This procedure generates the <HEAD> tag which marks the beginning of the HTML document head section.
You mark the end of an HTML document head section by means of the HEADCLOSE Procedure.
Syntax
HTP.HEADOPEN;
Examples
This procedure generates
<HEAD>
216.5.61 HR Procedure
This procedure generates the <HR> tag, which generates a line in the HTML document.
This subprogram performs the same operation as the LINE Procedure.
Syntax
HTP.HR( cclear IN VARCHAR2 DEFAULT NULL, csrc IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-47 HR Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<HR CLEAR="cclear" SRC="csrc" cattributes>
216.5.62 HTMLCLOSE Procedure
This procedure generates the </HTML> tag which marks the end of an HTML document.
You use the HTMLOPEN Procedure to mark the beginning of an HTML document.
Syntax
HTP.HTMLCLOSE;
Examples
This procedure generates
</HTML>
216.5.63 HTMLOPEN Procedure
This procedure generates the <HTML> tag which marks the beginning of an HTML document.
You use the HTMLCLOSE Procedure to mark the end of the an HTML document.
Syntax
HTP.HTMLOPEN;
Examples
This procedure generates
<HTML>
216.5.64 IMG Procedure
This procedure generates the <IMG> tag which directs the browser to load an image onto the HTML page.
The IMG2 Procedure performs the same operation but additionally uses the cusemap parameter.
Syntax
HTP.IMG( curl IN VARCHAR2 DEFAULT NULL, calign IN VARCHAR2 DEFAULT NULL, calt IN VARCHAR2 DEFAULT NULL, cismap IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-48 IMG Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the SRC attribute. |
|
|
The value for the |
|
|
The value for the |
|
|
If the value for this parameter is not |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<IMG SRC="curl" ALIGN="calign" ALT="calt" ISMAP cattributes>
216.5.65 IMG2 Procedure
This procedure generates the <IMG> tag, which directs the browser to load an image onto the HTML page.
The IMG Procedure performs the same operation but does not use the cusemap parameter.
Syntax
HTP.IMG2( curl IN VARCHAR2 DEFAULT NULL, calign IN VARCHAR2 DEFAULT NULL, calt IN VARCHAR2 DEFAULT NULL, cismap IN VARCHAR2 DEFAULT NULL, cusemap IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-49 IMG2 Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the SRC attribute. |
|
|
The value for the |
|
|
The value for the |
|
|
If the value for this parameter is not |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<IMG SRC="curl" ALIGN="calign" ALT="calt" ISMAP USEMAP="cusemap" cattributes>
216.5.66 ISINDEX Procedure
This procedure creates a single entry field with a prompting text, such as "enter value," then sends that value to the URL of the page or program.
Syntax
HTP.ISINDEX( cprompt IN VARCHAR2 DEFAULT NULL, curl IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-50 ISINDEX Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
Examples
This procedure generates
<ISINDEX PROMPT="cprompt" HREF="curl">
216.5.67 ITALIC Procedure
This procedure generates the <I> and </I> tags which direct the browser to render the text in italics.
Syntax
HTP.ITALIC( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-51 ITALIC Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to be rendered in italics. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<I cattributes>ctext</I>
216.5.68 KBD Procedure
This procedure generates the <KBD> and </KBD> tags which direct the browser to render the text in monospace font.
This subprogram performs the same operation as the KEYBOARD Procedure.
Syntax
HTP.KBD( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-52 KBD Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to be rendered in monospace. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<KBD cattributes>ctext</KBD>
216.5.69 KEYBOARD Procedure
This procedure generates the <KBD> and </KBD> tags, which direct the browser to render the text in monospace font.
This subprogram performs the same operation as the KBD Procedure.
Syntax
HTP.KEYBOARD( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-53 KEYBOARD Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to be rendered in monospace. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<KBD cattributes>ctext</KBD>
216.5.70 LINE Procedure
This procedure generates the <HR> tag, which generates a line in the HTML document.
This subprogram performs the same operation as the HR Procedure.
Syntax
HTP.LINE( cclear IN VARCHAR2 DEFAULT NULL, csrc IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-54 LINE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<HR CLEAR="cclear" SRC="csrc" cattributes>
216.5.71 LINKREL Procedure
This procedure generates the <LINK> tag with the REL attribute which delineates the relationship described by the hypertext link from the anchor to the target. This is only used when the HREF attribute is present.
This is the opposite of LINKREV Procedure. This tag indicates a relationship between documents but does not create a link. To create a link, use the ANCHOR Procedure.
Syntax
HTP.LINKREL( crel IN VARCHAR2, curl IN VARCHAR2, ctitle IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-55 LINKREL Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
Examples
This procedure generates
<LINK REL="crel" HREF="curl" TITLE="ctitle">
216.5.72 LINKREV Procedure
This procedure generates the <LINK> tag with the REV attribute which delineates the relationship described by the hypertext link from the target to the anchor.
This is the opposite of the LINKREL Procedure. This tag indicates a relationship between documents, but does not create a link. To create a link, use the ANCHOR Procedure.
Syntax
HTP.LINKREV( crev IN VARCHAR2, curl IN VARCHAR2, ctitle IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-56 LINKREV Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
Examples
This procedure generates
<LINK REV="crev" HREF="curl" TITLE="ctitle">
216.5.73 LISTHEADER Procedure
This procedure generates the <LH> and </LH> tags which print an HTML tag at the beginning of the list.
Syntax
HTP.LISTHEADER( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-57 LISTHEADER Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to place between |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<LH cattributes>ctext</LH>
216.5.74 LISTINGCLOSE Procedure
This procedure generates the </LISTING> tags which marks the end of a section of fixed-width text in the body of an HTML page.
To mark the beginning of a section of fixed-width text in the body of an HTML page, use the LISTINGOPEN Procedure.
Syntax
HTP.LISTINGCLOSE;
Examples
This procedure generates
</LISTING>
216.5.75 LISTINGOPEN Procedure
This procedure generates the <LISTING> tag which marks the beginning of a section of fixed-width text in the body of an HTML page.
To mark the end of a section of fixed-width text in the body of an HTML page, use the LISTINGCLOSE Procedure.
Syntax
HTP.LISTINGOPEN;
Examples
This procedure generates
<LISTING>
216.5.76 LISTITEM Procedure
This procedure generates the <LI> tag, which indicates a list item.
Syntax
HTP.LISTITEM( ctext IN VARCHAR2 DEFAULT NULL, cclear IN VARCHAR2 DEFAULT NULL, cdingbat IN VARCHAR2 DEFAULT NULL, csrc IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-58 LISTITEM Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text for the list item. |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<LI CLEAR="cclear" DINGBAT="cdingbat" SRC="csrc" cattributes>ctext
216.5.77 MAILTO Procedure
This procedure generates the <A> tag with the HREF set to 'mailto' prepended to the mail address argument.
Syntax
HTP.MAILTO( caddress IN VARCHAR2, ctext IN VARCHAR2, cname IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-59 MAILTO Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The email address of the recipient. |
|
|
The clickable portion of the link. |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<A HREF="mailto:caddress" NAME="cname" cattributes>ctext</A>
so that
HTP.mailto('pres@white_house.gov','Send Email to the President');
generates:
<A HREF="mailto:pres@white_house.gov">Send Email to the President</A>
216.5.78 MAPCLOSE Procedure
This procedure generates the </MAP> tag which marks the end of a set of regions in a client-side image map.
To mark the beginning of a set of regions in a client-side image map, use the MAPOPEN Procedure.
Syntax
HTP.MAPCLOSE;
Examples
This procedure generates
</MAP>
216.5.79 MAPOPEN Procedure
This procedure generates the <MAP> tag which mark the beginning of a set of regions in a client-side image map.
To mark the end of a set of regions in a client-side image map, use the MAPCLOSE Procedure.
Syntax
HTP.MAPOPEN( cname IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-60 MAPOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<MAP NAME="cname" cattributes>
216.5.80 MENULISTCLOSE Procedure
This procedure generates the </MENU> tag which ends a list that presents one line for each item.
To begin a list of this kind, use the MENULISTOPEN Procedure. The items in the list appear more compact than an unordered list. The LISTITEM Procedure defines the list items in a menu list.
Syntax
HTP.MENULISTCLOSE;
Examples
This procedure generates
</MENU>
216.5.81 MENULISTOPEN Procedure
This procedure generates the <MENU> tag which begins a list that presents one line for each item.
To end a list of this kind, use the MENULISTCLOSE Procedure.The items in the list appear more compact than an unordered list. The LISTITEM Procedure defines the list items in a menu list.
Syntax
HTP.MENULISTOPEN;
Examples
This procedure generates
<MENU>
216.5.82 META Procedure
This procedure generates the <META> tag, which embeds meta-information about the document and also specifies values for HTTP headers. For example, you can specify the expiration date, keywords, and author name.
Syntax
HTP.META( chttp_equiv IN VARCHAR2, cname IN VARCHAR2, ccontent IN VARCHAR2);
Parameters
Table 216-61 META Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
Examples
This procedure generates
<META HTTP-EQUIV="chttp_equiv" NAME ="cname" CONTENT="ccontent">
so that
HTP.meta ('Refresh', NULL, 120);
generates
<META HTTP-EQUIV="Refresh" CONTENT=120>
On some Web browsers, this causes the current URL to be reloaded automatically every 120 seconds.
216.5.83 NL Procedure
This procedure generates the <BR> tag which begins a new line of text.
It performs the same operation as the BR Procedure.
Syntax
HTP.NL( cclear IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-62 NL Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<BR CLEAR="cclear" cattributes>
216.5.84 NOBR Procedure
This procedure generates the <NOBR> and </NOBR> tags which turn off line-breaking in a section of text.
Syntax
HTP.NOBR( ctext IN VARCHAR2);
Parameters
Table 216-63 NOBR Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text that is to be rendered on one line. |
Examples
This procedure generates
<NOBR>ctext</NOBR>216.5.85 NOFRAMESCLOSE Procedure
This procedure generates the </NOFRAMES> tag which marks the end of a no-frames section.
To mark the beginning of a no-frames section, use the FRAMESETOPEN Procedure. See also FRAME Procedure, FRAMESETOPEN Procedure and FRAMESETCLOSE Procedure.
Syntax
HTP.NOFRAMESCLOSE;
Examples
This procedure generates
</NOFRAMES>
216.5.86 NOFRAMESOPEN Procedure
This procedure generates the <NOFRAMES> tag which mark the beginning of a no-frames section.
To mark the end of a no-frames section, use the FRAMESETCLOSE Procedure. See also FRAME Procedure, FRAMESETOPEN Procedure and FRAMESETCLOSE Procedure.
Syntax
HTP.NOFRAMESOPEN;
Examples
This procedure generates
<NOFRAMES>
216.5.87 OLISTCLOSE Procedure
This procedure generates the </OL> tag which defines the end of an ordered list. An ordered list presents a list of numbered items.
To mark the beginning of a list of this kind, use the OLISTOPEN Procedure. Numbered items are added using LISTITEM Procedure.
Syntax
HTP.OLISTCLOSE;
Examples
This procedure generates
</OL>
216.5.88 OLISTOPEN Procedure
This procedure generates the <OL> tag which marks the beginning of an ordered list. An ordered list presents a list of numbered items.
To mark the end of a list of this kind, use the OLISTCLOSE Procedure. Numbered items are added using LISTITEM Procedure.
Syntax
HTP.OLISTOPEN( cclear IN VARCHAR2 DEFAULT NULL, cwrap IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-64 OLISTOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<OL CLEAR="cclear" WRAP="cwrap" cattributes>
216.5.89 PARA Procedure
This procedure generates the <P> tag which indicates that the text that comes after the tag is to be formatted as a paragraph.
You can add attributes to the tag by means of the PARAGRAPH Procedure.
Syntax
HTP.PARA;
Examples
This procedure generates
<P>
216.5.90 PARAGRAPH Procedure
You can use this procedure to add attributes to the <P> tag created by the PARA Procedure.
Syntax
HTP.PARAGRAPH( calign IN VARCHAR2 DEFAULT NULL, cnowrap IN VARCHAR2 DEFAULT NULL, cclear IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-65 PARAGRAPH Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
If the value for this parameter is not |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<P ALIGN="calign" NOWRAP CLEAR="cclear" cattributes>
Related Topics
216.5.91 PARAM Procedure
This procedure generates the <PARAM> tag which specifies parameter values for Java applets.
The values can reference HTML variables. To invoke a Java applet from a Web page, use APPLETOPEN Procedure to begin the invocation. Use one PARAM Procedure for each desired name-value pair, and use APPLETCLOSE Procedure to end the applet invocation.
Syntax
HTP.PARAM( cname IN VARCHAR2 cvalue IN VARCHAR2);
Parameters
Table 216-66 PARAM Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
Examples
This procedure generates
<PARAM NAME=cname VALUE="cvalue">
216.5.92 PLAINTEXT Procedure
This procedure generates the <PLAINTEXT> and </PLAINTEXT> tags which direct the browser to render the text they surround in fixed-width type.
Syntax
HTP.PLAINTEXT( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-67 PLAINTEXT Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to be rendered in fixed-width font. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<PLAINTEXT cattributes>ctext</PLAINTEXT>
216.5.93 PRECLOSE Procedure
This procedure generates the </PRE> tag which marks the end of a section of preformatted text in the body of the HTML page.
To mark the beginning of a section of preformatted text in the body of the HTML page, use the PREOPEN Procedure.
Syntax
HTP.PRECLOSE;
Examples
This procedure generates
</PRE>
216.5.94 PREOPEN Procedure
This procedure generates the <PRE> tag which marks the beginning of a section of preformatted text in the body of the HTML page.
To mark the end of a section of preformatted text in the body of the HTML page, use the PRECLOSE Procedure.
Syntax
HTP.PREOPEN( cclear IN VARCHAR2 DEFAULT NULL, cwidth IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-68 PREOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<PRE CLEAR="cclear" WIDTH="cwidth" cattributes>
216.5.95 PRINT Procedures
These procedures generate the specified parameter as a string terminated with the \n newline character.
The PRN Procedures performs the same operation but does not terminate with a newline character.
Syntax
HTP.PRINT ( cbuf IN VARCHAR2); HTP.PRINT ( dbuf IN DATE); HTP.PRINT ( nbuf IN NUMBER);
Parameters
Table 216-69 PRINT Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The string to generate terminated by a newline. |
|
|
The string to generate terminated by a newline. |
|
|
The string to generate terminated by a newline. |
Usage Notes
-
The
\ncharacter is not the same as<BR>. The\ncharacter formats the HTML source but it does not affect how the browser renders the HTML source. Use<BR>to control how the browser renders the HTML source. -
These procedures do not have function equivalents.
216.5.96 PRINTS Procedure
This procedure generates a string and replaces certain characters with a corresponding escape sequence.
The following characters are replaced with the corresponding escape sequence.
-
<to< -
>to> -
"to" -
&to&
If not replaced, the special characters are interpreted as HTML control characters and produce garbled output. This procedure an the PS Procedure perform the same operation as the PRN Procedures but with character substitution.
Syntax
HTP.PRINTS ( ctext IN VARCHAR2);
Parameters
Table 216-70 PRINTS Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The string where to perform character substitution. |
Usage Notes
This procedure does not have an HTF function equivalent (see Operational Notes for the HTF implementation).
216.5.97 PRN Procedures
These procedures generate the specified parameter as a string.
Unlike the PRINT Procedures the string is not terminated with the \n newline character.
Syntax
HTP.PRN ( cbuf IN VARCHAR2); HTP.PRN ( dbuf IN DATE); HTP.PRN ( nbuf IN NUMBER);
Parameters
Table 216-71 PRN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The string to generate (not terminated by a newline). |
|
|
The string to generate (not terminated by a newline). |
|
|
The string to generate (not terminated by a newline). |
Usage Notes
These procedures do not have function equivalents.
216.5.98 PS Procedure
This procedure generates a string and replaces certain characters with the corresponding escape sequence.
This procedure replaces the following characters with the corresponding escape sequence.
-
<to< -
>to> -
"to" -
&to&
If not replaced, the special characters are interpreted as HTML control characters and produce garbled output. This procedure and the PRINTS Procedure perform the same operation as the PRN Procedures but with character substitution.
Syntax
HTP.PS ( ctext IN VARCHAR2);
Parameters
Table 216-72 PS Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The string where to perform character substitution. |
Usage Notes
This procedure does not have an HTF function equivalent (see Operational Notes for the HTF implementation).
216.5.99 S Procedure
This procedure generates the <S> and </S> tags which direct the browser to render the text they surround in strikethrough type.
This performs the same operation as STRIKE Procedure.
Syntax
HTP.S ( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-73 S Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to be rendered in strikethrough type. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<S cattributes>ctext</S>
216.5.100 SAMPLE Procedure
This procedure generates the <SAMP> and </SAMP> tags which direct the browser to render the text they surround in monospace font or however "sample" is defined stylistically.
Syntax
HTP.SAMPLE ( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-74 SAMPLE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to be rendered in monospace font. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<SAMP cattributes>ctext</SAMP>
216.5.101 SCRIPT Procedure
This procedure generates the <SCRIPT> and </SCRIPT> tags which contain a script written in languages such as JavaScript and VBscript.
Syntax
HTP.SCRIPT ( cscript IN VARCHAR2, clanguage IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-75 SCRIPT Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text of the script. This is the text that makes up the script itself, not the name of a file containing the script. |
|
|
The language in which the script is written. If this parameter is omitted, the user's browser determines the scripting language. |
Examples
This procedure generates
<SCRIPT LANGUAGE=clanguage>cscript</SCRIPT>
so that
HTP.script ('Erupting_Volcano', 'Javascript');
generates
<SCRIPT LANGUAGE=Javascript>"script text here"</SCRIPT>
This causes the browser to run the script enclosed in the tags.
216.5.102 SMALL Procedure
This procedure generates the <SMALL> and </SMALL> tags, which direct the browser to render the text they surround using a small font.
Syntax
HTP.SMALL ( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-76 SMALL Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to be rendered in small font. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<SMALL cattributes>ctext</SMALL>
216.5.103 STRIKE Procedure
This procedure generates the <STRIKE> and </STRIKE> tags which direct the browser to render the text they surround in strikethrough type.
This performs the same operation as S Procedure.
Syntax
HTP.STRIKE ( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-77 STRIKE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to be rendered in strikethrough type. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<STRIKE cattributes>ctext</STRIKE>
216.5.104 STRONG Procedure
This procedure generates the <STRONG> and </STRONG> tags which direct the browser to render the text they surround in bold, or however "strong" is defined.
Syntax
HTP.STRONG( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-78 STRONG Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to be emphasized. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<STRONG cattributes>ctext</STRONG>
216.5.105 STYLE Procedure
This procedure generates the <STYLE> and </STYLE> tags which include a style sheet in a Web page.
You can get more information about style sheets at http://www.w3.org. This feature is not compatible with browsers that support only HTML versions 2.0 or earlier. Such browsers will ignore this tag.
Syntax
HTP.STYLE( cstyle IN VARCHAR2);
Parameters
Table 216-79 STYLE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The the style information to include. |
Examples
This procedure generates
<STYLE>cstyle</STYLE>216.5.106 SUB Procedure
This procedure generates the <SUB> and </SUB> tags which direct the browser to render the text they surround as subscript.
Syntax
HTP.SUB( ctext IN VARCHAR2, calign in VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-80 SUB Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to render in subscript. |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<SUB ALIGN="calign" cattributes>ctext</SUB>
216.5.107 SUP Procedure
This procedure generates the <SUP> and </SUP> tags which direct the browser to render the text they surround as superscript.
Syntax
HTP.SUP( ctext IN VARCHAR2, calign in VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-81 SUP Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to render in superscript. |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<SUP ALIGN="calign" cattributes>ctext</SUP>
216.5.108 TABLECAPTION Procedure
This procedure generates the <CAPTION> and </CAPTION> tags which place a caption in an HTML table.
Syntax
HTP.TABLECAPTION( ccaption IN VARCHAR2, calign in VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-82 TABLECAPTION Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text for the caption. |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<CAPTION ALIGN="calign" cattributes>ccaption</CAPTION>
216.5.109 TABLECLOSE Procedure
This procedure generates the </TABLE> tag which marks the end of an HTML table.
To define the beginning of an HTML table, use the TABLEOPEN Procedure.
Syntax
HTP.TABLECLOSE;
Examples
This procedure generates
</TABLE>
216.5.110 TABLEDATA Procedure
This procedure generates the <TD> and </TD> tags which insert data into a cell of an HTML table.
Syntax
HTP.TABLEDATA( cvalue IN VARCHAR2 DEFAULT NULL, calign IN VARCHAR2 DEFAULT NULL, cdp IN VARCHAR2 DEFAULT NULL, cnowrap IN VARCHAR2 DEFAULT NULL, crowspan IN VARCHAR2 DEFAULT NULL, ccolspan IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-83 TABLEDATA Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The data for the cell in the table. |
|
|
The value for the |
|
|
The value for the |
|
|
If the value of this parameter is not |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<TD ALIGN="calign" DP="cdp" ROWSPAN="crowspan" COLSPAN="ccolspan" NOWRAP cattributes>cvalue</TD>
216.5.111 TABLEHEADER Procedure
This procedure generates the <TH> and </TH> tags which insert a header cell in an HTML table.
The <TH> tag is similar to the <TD> tag except that the text in this case the rows are usually rendered in bold type.
Syntax
HTP.TABLEHEADER( cvalue IN VARCHAR2 DEFAULT NULL, calign IN VARCHAR2 DEFAULT NULL, cdp IN VARCHAR2 DEFAULT NULL, cnowrap IN VARCHAR2 DEFAULT NULL, crowspan IN VARCHAR2 DEFAULT NULL, ccolspan IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-84 TABLEHEADER Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The data for the cell in the table. |
|
|
The value for the |
|
|
The value for the |
|
|
If the value of this parameter is not |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<TH ALIGN="calign" DP="cdp" ROWSPAN="crowspan" COLSPAN="ccolspan" NOWRAP cattributes>cvalue</TH>
216.5.112 TABLEOPEN Procedure
This procedure generates the <TABLE> tag which marks the beginning of an HTML table.
To define the end of an HTML table, use the TABLECLOSE Procedure.
Syntax
HTP.TABLEOPEN( cborder IN VARCHAR2 DEFAULT NULL calign IN VARCHAR2 DEFAULT NULL, cnowrap IN VARCHAR2 DEFAULT NULL, cclear IN VARCHAR2 DEFAULT NULL cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-85 TABLEOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
If the value of this parameter is not |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<TABLE "cborder" NOWRAP ALIGN="calign" CLEAR="cclear" cattributes>
216.5.113 TABLEROWCLOSE Procedure
This procedure generates the </TR> tag which marks the end of a new row in an HTML table.
To mark the beginning of a new row, use the TABLEROWOPEN Procedure.
Syntax
HTP.TABLEROWCLOSE;
Examples
This procedure generates
</TABLE>
216.5.114 TABLEROWOPEN Procedure
This procedure generates the <TR> tag which marks the beginning of a new row in an HTML table.
To mark the end of a new row, use the TABLEROWCLOSE Procedure.
Syntax
HTP.TABLEROWOPEN( calign IN VARCHAR2 DEFAULT NULL, cvalign IN VARCHAR2 DEFAULT NULL, cdp IN VARCHAR2 DEFAULT NULL, cnowrap IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-86 TABLEROWOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
If the value of this parameter is not |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<<TR ALIGN="calign" VALIGN="cvalign" DP="cdp" NOWRAP cattributes>
216.5.115 TELETYPE Procedure
This procedure generates the <TT> and </TT> tags which direct the browser to render the text they surround in a fixed width typewriter font, for example, the courier font.
Syntax
HTP.TELETYPE( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-87 TELETYPE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to render in a fixed width typewriter font. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<TT cattributes>ctext</TT>
216.5.116 TITLE Procedure
This procedure generates the <TITLE> and </TITLE> tags which specify the text to display in the titlebar of the browser window.
Syntax
HTP.TITLE( ctitle IN VARCHAR2);
Parameters
Table 216-88 TITLE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to display in the titlebar of the browser window. |
Examples
This procedure generates
<TITLE>ctitle</TITLE>216.5.117 ULISTCLOSE Procedure
This procedure generates the </UL> tag which marks the end of an unordered list. An unordered list presents items with bullets.
To mark the beginning of an unordered list, use the ULISTOPEN Procedure. Add list items with LISTITEM Procedure.
Syntax
HTP.ULISTCLOSE;
Examples
This procedure generates
</TABLE>
216.5.118 ULISTOPEN Procedure
This procedure generates the <UL> tag which marks the beginning of an unordered list. An unordered list presents items with bullets.
To mark the end of an unordered list, use the ULISTCLOSE Procedure. Add list items with LISTITEM Procedure.
Syntax
HTP.ULISTOPEN( cclear IN VARCHAR2 DEFAULT NULL, cwrap IN VARCHAR2 DEFAULT NULL, cdingbat IN VARCHAR2 DEFAULT NULL, csrc IN VARCHAR2 DEFAULT NULL, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-89 ULISTOPEN Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The value for the |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<UL CLEAR="cclear" WRAP="cwrap" DINGBAT="cdingbat" SRC="csrc" cattributes>
216.5.119 UNDERLINE Procedure
This procedure generates the <U> and </U> tags, which direct the browser to render the text they surround with an underline.
Syntax
HTP.UNDERLINE( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-90 UNDERLINE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to render with an underline. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<U cattributes>ctext</U>
216.5.120 VARIABLE Procedure
This procedure generates the <VAR> and </VAR> tags which direct the browser to render the text they surround in italics or however "variable" is defined stylistically.
Syntax
HTP.VARIABLE( ctext IN VARCHAR2, cattributes IN VARCHAR2 DEFAULT NULL);
Parameters
Table 216-91 VARIABLE Procedure Parameters
| Parameter | Description |
|---|---|
|
|
The text to render in italics. |
|
|
The other attributes to be included as-is in the tag. |
Examples
This procedure generates
<VAR cattributes>ctext</VAR>