5.3 Document Object

Facilitates to retrieve values from the form variables and the environment variables.

5.3.1 FormVars property

Represents the collection of form variables. Form variables are input fields in a form.

Syntax

 object.FormVars
 

Type

CGIObjs.

Attributes

Read-only.

Remarks

This property will return a valid collection of form variables, if the script is invoked through HTTP post method. The value of the ACTION property of the respective form should be POST. Else, this property will throw an exception.

Example

This example retrieves the name and the value of the form fields.

 Set formvars=doc.formvars
 For each formvar in formvars
 		    Print "Name:"&formvar.name&"nbsp;nbsp"
     &"Value:"&formvar.value
 Next
 

5.3.2 EnvVars property

Represents the collection of web server provided environment variables.

Syntax

 object.EnvVars
 

Type

EnvObjs.

Attributes

Read-only.

Example

This example retrieves the name and the value of the environment fields.

 Set envvars=doc.envvars
 For each envvar in envvars
     Print "Name:"&envvar.name&"nbsp;nbsp"
     &envvar.value
 Next
 

5.3.3 AddBullet method

Adds an item to a bulleted list in an HTML document.

Syntax

 object.AddBullet(
    HREF As String)
 

Parameters

HREF
The string to be added to the bulleted list.

Return Values

Boolean. Returns TRUE if the string is successfully added to the list, else returns FALSE.

Remarks

To add a string to a numbered list, see the AddNumber method.

Example

This example shows the AddBullet method in its typical context. It adds the text item "NSN lets you access the UCS" to the bulleted list.

 doc.BeginBullet() 
 doc.AddBullet("NSN lets you access the UCS") 
 doc.EndBullet()
 

5.3.4 AddFrame method

Creates a frame in an HTML document.

Syntax

 doc.AddFrame(
    Source As String 
    [,Name As String 
    [,Scrolling As Integer 
    [,NoResize As Boolean 
    [,MarginHeight As Integer 
    [,MarginWidth As Integer 
    [,FrameBorder As Boolean]]]]]])
 

Parameters

Source
The URL to be displayed in the frame.
Name
Optional. The name of the frame.
Scrolling
Optional. The Scrolling Constants.
NoResize
Optional. If set to TRUE, the frame cannot be resized (default = FALSE).
MarginHeight
Optional. The margin height (in pixels) between the frame contents and the top and bottom of the frame.
MarginWidth
Optional. The margin width (in pixels) between the frame contents and the left and right of the frame.
FrameBorder
Optional. If set to TRUE, a three-dimensional border outlines the frame. If FALSE, the frame has no border.

Return Values

Boolean. Returns TRUE if the frame is successfully added, else returns FALSE.

Example

This example shows the AddFrame method in its typical context. It adds two frames, which display the URLs http://www.novell.com and http://www.sun.com, to the HTML document.

 doc.BeginFrame("50%, 50%") 
 doc.AddFrame("http://www.novell.com") 
 doc.AddFrame("http://www.sun.com") 
 doc.EndFrame()
 

5.3.5 AddNumber method

Adds data to a numbered list in an HTML document.

Syntax

 doc.AddNumber(
    HREF As String)
 

Parameters

HREF
The string to be added to the numbered list.

Return Values

Boolean. Returns TRUE if the string is successfully added to the numbered list, else returns FALSE.

Remarks

To add a string to a bulleted list, see the AddBullet method.

Example

This example shows the AddNumber method in its typical context. It adds four items to the numbered list in the HTML document.

 doc.BeginNumber() 
 doc.AddNumber("Open a new document.") 
 doc.AddNumber("Edit the document.") 
 doc.AddNumber("Save the document.") 
 doc.AddNumber("Close the document.") 
 doc.EndNumber()
 

5.3.6 Address method

Adds an address tag an HTML document.

Syntax

 doc.Address(
    AddressInfo As String)
 

Parameters

AddressInfo
The address details to be displayed in the document.

Return Values

Boolean. Returns TRUE if the address is successfully added to the document, else returns FALSE.

Example

This example shows the Address method in its typical context. It adds the address "Novell Headquarters, Provo, Utah" to the HTML document.

 doc.Address("Novell HeadQuarters,Provo,Utah")
 

5.3.7 AddTextArea method

Adds a line to a text box in an HTML document.

Syntax

 object.AddTextArea(
    Data As String)
 

Parameters

Data
The string to be printed in the text box.

Return Values

Boolean. Returns TRUE if the string is successfully added to the text box, else returns FALSE.

Example

This AddTextArea example adds the string "NetWare 5 is terrific!" to the text box.

 doc.BeginForm("cgi.bas") 
 doc.AddTextArea("NetWare 5 is terrific!") 
 doc.EndForm()
 

See Also

5.3.8 BeginBullet method

Starts a bulleted list in an HTML document.

Syntax

 object.BeginBullet()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if the bulleted list is successfully started, else returns FALSE.

Example

This example shows the BeginBullet method in its typical context.

 doc.BeginBullet() 
 doc.AddBullet("NSN lets you access the UCS") 
 doc.EndBullet()
 

5.3.9 BeginData method

Starts adding data to a table in an HTML document.

Syntax

 object.BeginData(
    Data As String 
    [,Height As Integer 
    [,Width As Integer 
    [,HAlign As Integer 
    [,VAlign As Integer 
    [,Color As String]]]]])
 

Parameters

Data
The data to be added.
Height
Optional. The height of the entire table.
Width
Optional. The width of the entire table.
HAlign
Optional. The horizontal alignment constants. See Alignment Constants.
VAlign
Optional. The vertical alignment constants. See Alignment Constants.
Color
Optional. The color of the table. See Color Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginData example starts adding data to the table in the HTML document.

 doc.BeginTable(TRUE) 
 doc.Caption("Table") 
 doc.BeginRow() 
 doc.TableHeading("Head1") 
 doc.TableHeading("Head2") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line11") 
 doc.DataTable("Line12") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.BeginData() 
 doc.Print("Line21") 
 doc.EndData() 
 doc.BeginData() 
 doc.Print("Line22") 
 doc.EndData() 
 doc.EndRow() 
 doc.EndTable()
 

5.3.10 BeginFont method

Specifies the text color, size, and preferred font in an HTML document.

Syntax

 object.BeginFont(
    [Color As String 
    [,Size As String 
    [,Face As String]]])
 

Parameters

Color
Optional. The color value is given as a hex RGB triplet or as a color name. See Color Constants.
Size
Optional. The font size. Ranges from 1-7 (default value = 3).
Face
Optional. A comma-separated list of preferred fonts.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginFont example specifies the font appearance as 7 point red (#FF0000).

 doc.BeginFont("#FF0000", "7") 
 doc.Print("Doc Component") 
 doc.EndFont()
 

5.3.11 BeginForm method

Creates the form in an HTML document.

Syntax

 object.BeginForm(
    URL As String, 
    Target As String)
 

Parameters

URL
The URL of the program to be invoked when the form is submitted.
Target
The window in which the hypertext link destination will appear.

Return Values

Void.

Example

This BeginForm example creates the form process.bas.

 doc.BeginForm("process.bas") 
 doc.BeginSelect("Selection", 5, TRUE) 
 doc.OptionSelect("First option", "First", TRUE) 
 doc.OptionSelect("Second option", "Second", False) 
 doc.OptionSelect("Third option", "Third", False) 
 doc.OptionSelect("Fourth option", "Fourth", False) 
 doc.OptionSelect("Fifth option", "Fifth", False) 
 doc.OptionSelect("Sixth option", "Sixth", False) 
 doc.EndSelect() 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.12 BeginFrame method

Creates a frame in an HTML document.

Syntax

 object.BeginFrame(
    Rows As String 
    [,Cols As String 
    [,FrameBorder As Boolean 
    [,BorderColor As String 
    [,Border As Integer]]]])
 

Parameters

Rows
A comma-separated list of values for the height of each frame in the set of frames.
Cols
Optional. A comma-separated list of values for the width of each frame in the set of frames.
FrameBorder
Optional. If TRUE, a three-dimensional outline borders the frame, else returns no border appears.
BorderColor
Optional. The color of the frame border. This can be given as a hex RGB triplet value or a constant name. See Color Constants.
Border
Optional. The width, in pixels, of the frame border.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginFrame example creates a frame in the HTML document.

 doc.BeginFrame("50%, 50%" 
 doc.AddFrame("http://www.novell.com") 
 doc.AddFrame("http://www.sun.com") 
 doc.EndFrame()
 

5.3.13 BeginFunction method

Defines the beginning of the function in an HTML document.

Syntax

 object.BeginFunction(
    Function As String 
    [,Parameters As String])
 

Parameters

Function
The name of the function.
Parameters
Optional. The parameters of the function.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginFunction example defines the beginning of the "FunctionName" function.

 doc.BeginFunction("FunctionName", "param1, param2") 
 doc.EndFunction()
 

5.3.14 BeginHeading method

Begins a heading definition in an HTML document.

Syntax

 object.BeginHeading()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginHeading example begins the Document component heading definition in the HTML document.

 doc.BeginHeading() 
 doc.Title("Document component") 
 doc.Meta("Author", "Ken Ceo") 
 doc.EndHeading()
 

5.3.15 BeginLink method

Begins an anchor definition in an HTML document.

Syntax

 object.BeginLink(
    HREF As String 
    [,Name As String 
    [,Target As String]])
 

Parameters

HREF
The destination URL.
Name
Optional. The name of the target that is to be displayed in the HTML document.
Target
Optional. The frame or window name in which the target will appear.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginLink example begins the anchor definition in the HTML document.

 doc.BeginLink("http://www.novell.com") 
 doc.Print("Novell home page") 
 doc.EndLink()
 

See Also

5.3.16 BeginMap method

Defines a client-side image map.

Syntax

 object.BeginMap(
    MapName As String)
 

Parameters

MapName
The name of the image map.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginMap example defines a client-side image map named ClientMap for the HTML document.

 doc.BeginMap("ClientMap") 
 doc.MapArea("0, 0, 50 ,50", "http://www.novell.com", 1) 
 doc.MapArea("50, 50, 50 ,100", "http://www.microsoft.com", 1) 
 doc.MapArea("50, 100, 100 ,100", "http://www.sun.com", 1) 
 doc.EndMap()
 

5.3.17 BeginNoScript method

Begins a No Script definition in an HTML document.

Syntax

 object.BeginNoScript()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This example shows the BeginNoScript method in its typical context. It begins a No Script definition in the HTML document.

 doc.BeginNoScript()
 

5.3.18 BeginNumber method

Starts defining a numbered list in an HTML document.

Syntax

 object.BeginNumber()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginNumber example defines a numbered list in the HTML document.

 doc.BeginNumber() 
 doc.AddNumber("Item1 in Numbered list") 
 doc.AddNumber("Item2 in Numbered list") 
 doc.AddNumber("Item3 in Numbered list") 
 doc.EndNumber()
 

5.3.19 BeginRow method

Begins a table row in an HTML document.

Syntax

 object.BeginRow(
    [HAlign As Integer 
    [,Valign As Integer]])
 

Parameters

HAlign
Optional. Horizontally aligns text to the left, right, or center of the cell. See Alignment Constants.
VAlign
Optional. Vertically aligns text. See Alignment Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginRow example defines a typical context of creating a row in a table and adding data to it.

 doc.Begintable(TRUE)
 doc.Caption("Table")
 doc.BeginRow(3,3)
 doc.Tableheading("Row1")
 doc.Tableheading("Row2")
 doc.EndRow()
 doc.BeginRow(3,3)
 doc.DataTable("col1 of row1")
 doc.DataTable("col2 of row1")
 doc.Endrow()
 doc.BeginRow(3,3)
 doc.DataTable("col1 of row2")
 doc.Datatable("col2 of row2")
 doc.EndRow()
 doc.Endtable()
 
 

5.3.20 BeginScript method

Defines the beginning of a script in an HTML document.

Syntax

 object.BeginScript(
    [Language As String 
    [,Source As String]])
 

Parameters

Language
Optional. The script language.
Source
Optional. The name of the source file that contains the script.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginScript example defines the beginning of a script written with Novell script for NetWare, in the HTML document.

 doc.BeginScript("Novell Script for NetWare","Process.bas")
 

5.3.21 BeginSelect method

Begins the definition of a combo box in an HTML document.

Syntax

 object.BeginSelect(
    Variable As String 
    [,Size As Integer 
    [,Multiple As Boolean 
    [,Align As Integer]]])
 

Parameters

Variable
The CGI variable that contains the selected item.
Size
Optional. The number of items that will be displayed in a combo box at one time.
Multiple
Optional. If set to TRUE, allows multiple items to be selected in a combo box. If set to FALSE, it does not allow multiple items to be selected.
Align
Optional. Specifies the alignment. See Alignment Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginSelect example begins a combo box definition in the HTML document. It specifies a CGI variable of "Selection," allows a total of five items to be displayed in a combo box at a time, and allows multiple items to be selected in a combo box.

 doc.BeginForm("process.bas") 
 doc.BeginSelect("Selection", 5, TRUE) 
 doc.OptionSelect("First option", "First", TRUE) 
 doc.OptionSelect("Second option", "Second", False) 
 doc.OptionSelect("Third option", "Third", False) 
 doc.OptionSelect("Fourth option", "Fourth", False) 
 doc.OptionSelect("Fifth option", "Fifth", False) 
 doc.OptionSelect("Sixth option", "Sixth", False) 
 doc.EndSelect() 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.22 BeginTable method

Defines the beginning of a table in an HTML document.

Syntax

 object.BeginTable(
    Border As AnyType 
    [,Height As String 
    [,Width As String 
    [,HAlign As Integer 
    [,CellSpacing As Integer 
    [,CellPadding As Integer]]]]])
 

Parameters

Border
Indicates the presence (TRUE) or absence (FALSE) of a border as a Boolean value. If present, the pixel size is defined as an Integer.
Height
Optional. The height of the entire table, either as an absolute pixel value or as a percentage of the available height.
Width
Optional. The width of the entire table, either as an absolute pixel value or as a percentage of the available width.
HAlign
Optional. Horizontally aligns text to the left, right or center of the cell. Values are Horizontal alignment constants. See Alignment Constants.
CellSpacing
Optional. The space, in pixels, between individual cells in the table (width of the interior border).
CellPadding
Optional. The space, in pixels, between the cell contents and the cell border in a table.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This BeginTable example defines the beginning of a table in the HTML document.

 doc.BeginTable(TRUE) 
 doc.Caption("Table") 
 doc.BeginRow() 
 doc.TableHeading("Head1") 
 doc.TableHeading("Head2") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line11") 
 doc.DataTable("Line12") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line21") 
 doc.DataTable("Line22") 
 doc.EndRow() 
 doc.EndTable()
 

5.3.23 BeginTag method

Adds a user-defined HTML tag to an HTML document.

Syntax

 object.BeginTag(
    TagName As String 
    [,OptionalParameters As String])
 

Parameters

TagName
The user-defined tag. See Tag Name Constants.
OptionalParameters
Optional. Other tag parameters. See Tag Name Constants.

Return Values

Boolean. Returns TRUE if the tag is added to the HTML document, else returns FALSE.

Example

This BeginTable example adds the HTML tag B to the HTML document. The B tag will print the word "Hello".

 doc.BeginTag("B") 
 doc.Print("Hello") 
 doc.EndTag()
 

5.3.24 BeginTextArea method

Adds a text area to an HTML document.

Syntax

 object.BeginTextArea(
    Variable As String, 
    Rows As Integer, 
    Columns As Integer 
    [,Align As Integer])
 

Parameters

Variable
When the form is submitted, the value entered will be written to this variable.
Rows
The number of edit box rows.
Columns
The number of edit box columns.
Align
Optional. Specifies the alignment (default value = Left). See Alignment Constants.

Return Values

Boolean. Returns TRUE if the text area is added to the HTML document, else returns FALSE.

Example

This BeginTextArea example adds the specified text area to the HTML document.

 doc.BeginForm("process.bas") 
 doc.BeginTextArea("tVar", 5, 30) 
 doc.Print("This is the default Text") 
 doc.EndTextArea() 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.25 Body method

Begins the body definition of an HTML document.

Syntax

 object.Body(
    [BGColor As String, 
    [TextColor As String, 
    [LinkColor As String, 
    [BGGraphic As String]]]])
 

Parameters

BGColor
Optional. The background color. See Color Constants.
TextColor
Optional. The color of the text. See Color Constants.
LinkColor
Optional. The color of the links. See Color Constants.
BGGraphic
Optional. The background graphics.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This Body example defines the body of the HTML document. The background color is red (#FF0000), the text color is green (#00FF00), and the link color is blue (#0000FF).

 doc.Body("#FF0000", "#00FF00", "#0000FF") 
 doc.Print("This document has been generated by NSN")
 

See Also

5.3.26 Break method

Adds a line break to an HTML document.

Syntax

 object.Break()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if the line break is added to the HTML document, else returns FALSE.

Example

This Break example adds a line break to the HTML document.

 doc.Print("This is the first line") 
 doc.Break()
 doc.Print("This is the second line")
 

See Also

5.3.27 BulletList method

Creates a bulleted list for each specified parameter.

Syntax

 object.BulletList(
    Item1 As String 
    [,ItemN As String])
 

Parameters

Item1
The String to be added to the bulleted list.
ItemN
Optional. Additional Strings to be added to the bulleted list.

Return Values

Void.

Example

This BulletList example creates a bulleted list that contains two items.

 doc.BulletList("Item 1 of the bulleted list",
 "Item 2 of the bulleted list")
 

5.3.28 ButtonLink method

Defines a button link in an HTML document.

Syntax

 object.ButtonLink(
    HREF As String, 
    Text As String)
 

Parameters

HREF
When the button link is pressed, the HTML document corresponding to the URL specified in the hypertext reference (HREF) will be displayed.
Text
The value displayed on the button.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This ButtonLink example defines a button link called "Novell Inc" that links to the Novell home page at http://www.novell.com.

 doc.ButtonLink("http://www.novell.com", "Novell Inc")
 

5.3.29 Caption method

Adds a table caption to an HTML document.

Syntax

 object.Caption(
    Caption As String, 
    Align As Integer)
 

Parameters

Caption
The caption (title) of the table.
Align
Places the caption above (DOC_ALIGN_TOP) or below (DOC_ALIGN_BOTTOM) the table. See Alignment Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This Caption example adds the title "Table" to the table in the HTML document.

 doc.BeginTable(TRUE) 
 doc.Caption("Table") 
 doc.BeginRow() 
 doc.TableHeading("Head1") 
 doc.TableHeading("Head2") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line11") 
 doc.DataTable("Line12") 
 doc.EndRow() 
 doc.Beginrow() 
 doc.DataTable("Line21") 
 doc.DataTable("Line22") 
 doc.EndRow() 
 doc.EndTable()
 

5.3.30 CheckBox method

Creates a check box in an HTML document.

Syntax

 object.CheckBox(
    Variable As String, 
    Value As String, 
    Text As String, 
    Check As Boolean 
    [,Align As Integer])
 

Parameters

Variable
The name of the CGI variable containing Value corresponding to the check box containing the check mark when the form is submitted. See Color Constants.
Value
The value associated with the CGI variable.
Text
The String displayed to the right of the check box field.
Check
If TRUE, the specified check box will be checked by default.
Align
Optional. Specifies the check box alignment. See Alignment Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This CheckBox example creates four check boxes in the HTML document. The first check box is labeled green and is selected by default initially. The next three check boxes are labeled red, blue, and yellow respectively and are unchecked by default.

 doc.BeginForm("process.bas") 
 doc.CheckBox("Color", "Green", "Green", TRUE)
 doc.Break 
 doc.CheckBox("Color", "Red", "Red", FALSE)
 doc.Break 
 doc.CheckBox("Color", "Blue", "Blue", FALSE)
 doc.Break 
 doc.CheckBox("Color", "Yellow", "Yellow", FALSE)
 doc.Break 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.31 DataTable method

Adds data to a table.

Syntax

 object.DataTable(
    Data As String 
    [, Height As String 
    [, Width As String 
    [, Halign As Integer 
    [, Valign As Integer 
    [, BGColor As String]]]]])
 

Parameters

Data
The data to be added to the table.
Height
Optional. The height of the entire table, either as an absolute pixel value or as a percentage of the available height.
Width
Optional. The width of the entire table, either as an absolute pixel value or as a percentage of the available width.
HAlign
Optional. Horizontally aligns text to the left, right, or center of the cell. See Alignment Constants.
VAlign
Optional. Vertically aligns cell text with the top, center, or bottom of the cell. See Alignment Constants.
BGColor
Optional. The background color of the data cell. See Color Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This DataTable example adds Line11, Line12, Line21, and Line22 to the table in the HTML document.

 doc.BeginTable(TRUE) 
 doc.Caption("Table") 
 doc.BeginRow() 
 doc.TableHeading("Head1") 
 doc.TableHeading("Head2") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line11") 
 doc.DataTable("Line12") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line21") 
 doc.DataTable("Line22") 
 doc.EndRow() 
 doc.EndTable()
 

5.3.32 EndBullet method

Ends the definition of a bulleted list within an HTML document.

Syntax

 object.EndBullet()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if the bulleted list is ended successfully, else returns FALSE.

Example

This EndBullet example ends the definition of the bulleted list in the HTML document.

 doc.BeginBullet() 
 doc.AddBullet("Item1 in Bulleted list") 
 doc.AddBullet("Item2 in Bulleted list") 
 doc.AddBullet("Item3 in Bulleted list") 
 doc.EndBullet()
 

5.3.33 EndData method

Ends the data definition within a table in an HTML document.

Syntax

 object.EndData()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndData example ends the data definition in the HTML document.

 doc.BeginTable(TRUE) 
 doc.Caption("Table") 
 doc.BeginRow() 
 doc.TableHeading("Head1") 
 doc.TableHeading("Head2") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line11") 
 doc.DataTable("Line12") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.BeginData() 
 doc.Print("Line21") 
 doc.EndData() 
 doc.BeginData() 
 doc.Print("Line22") 
 doc.EndData() 
 doc.EndRow() 
 doc.EndTable()
 

5.3.34 EndFont method

Ends the font definition within a table in an HTML document.

Syntax

 object.EndFont()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndFont example ends the font definition in the HTML document.

 doc.BeginFont("#FF0000", "7") 
 doc.Print("Doc Component") 
 doc.EndFont()
 

5.3.35 EndForm method

Ends the definition of an HTML form.

Syntax

 object.EndForm()
 

Parameters

None.

Return Values

Void.

Example

This EndForm example ends the definition of an HTML form.

 doc.BeginForm("process.bas") 
 doc.CheckBox("Var", "Green", "Green", TRUE) 
 doc.Break()
 doc.CheckBox("Var", "Red", "Red", FALSE)
 doc.Break()
 doc.CheckBox("Var", "Blue", "Blue", TRUE) 
 doc.Break()
 doc.CheckBox("Var", "Yellow", "Yellow", FALSE)
 doc.Break()
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

See Also

5.3.36 EndFrame method

Ends a frame definition in an HTML document.

Syntax

 object.EndFrame()
 

Parameters

None.

Return Values

Void.

Example

This EndFrame example ends two frames in the HTML document.

 doc.BeginFrame("50%, 50%", "", TRUE, "#008000", 10) 
 doc.AddFrame("http://www.novell.com") 
 doc.BeginFrame("", "50%, 50%", TRUE, "#008000", 10) 
 doc.AddFrame("http://www.sun.com") 
 doc.AddFrame("http://www.microsoft.com") 
 doc.EndFrame() 
 doc.EndFrame()
 

5.3.37 EndFunction method

Ends a function definition in an HTML document.

Syntax

 object.EndFunction()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndFunction example ends the function definition in the HTML document.

 doc.BeginFunction("Function1", "param1, param2") 
 doc.Print("document.Write(\"Out put from function 1\")") 
 doc.EndFunction()
 

5.3.38 EndHeading method

Ends the heading definition in an HTML document.

Syntax

 object.EndHeading()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndHeading example ends the heading definition in the HTML document.

 doc.BeginHeading() 
 doc.Title("Document component") 
 doc.Meta("Author", "Ken Ceo") 
 doc.EndHeading()
 

5.3.39 EndLink method

Ends an anchor definition in an HTML document.

Syntax

 object.EndLink()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndLink example ends the anchor definition in the HTML document.

 doc.BeginLink("http://www.novell.com") 
 doc.Print("Novell home page") 
 doc.EndLink()
 

See Also

5.3.40 EndMap method

Ends a client-side image map definition in an HTML document.

Syntax

 object.EndMap()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndMap example ends the client-side definition image map in the HTML document.

 doc.BeginMap("ClientMap") 
 doc.MapArea("0, 0, 50 ,50", "http://www.novell.com", 1) 
 doc.MapArea("50, 50, 50 ,100", "http://www.microsoft.com", 1) 
 doc.MapArea("50, 100, 100 ,100", "http://www.sun.com", 1) 
 doc.EndMap()
 

See Also

5.3.41 EndNoScript method

Ends the definition of a no script in an HTML document.

Syntax

 object.EndNoScript()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndNoScript example ends the no script definition in the HTML document.

 doc.EndNoScript()
 

5.3.42 EndNumber method

Ends a numbered list definition in an HTML document.

Syntax

 object.EndNumber()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndNumber example ends the numbered list definition in the HTML document.

 doc.BeginNumber() 
 doc.AddNumber("Item1 in Numbered list") 
 doc.AddNumber("Item2 in Numbered list") 
 doc.AddNumber("Item3 in Numbered list") 
 doc.EndNumber()
 

5.3.43 EndRow method

Ends a table row definition in an HTML document.

Syntax

 object.EndRow()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndRow example ends the table row definitions in the HTML document.

 doc.BeginTable(TRUE) 
 doc.Caption("Table") 
 doc.BeginRow() 
 doc.TableHeading("Head1") 
 doc.TableHeading("Head2") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line11") 
 doc.DataTable("Line12") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.BeginData() 
 doc.Print("Line21") 
 doc.EndData() 
 doc.BeginData() 
 doc.Print("Line22") 
 doc.EndData() 
 doc.EndRow() 
 doc.EndTable()
 

See Also

5.3.44 EndScript method

Ends the script definition in an HTML document.

Syntax

 object.EndScript()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndScript example ends the script definition in the HTML document.

 doc.EndScript()
 

5.3.45 EndSelect method

Ends a combo box definition in an HTML document.

Syntax

 object.EndSelect()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndSelect example ends the combo box definition in the HTML document.

 doc.BeginForm("process.bas") 
 doc.BeginSelect("Selection", 5, TRUE) 
 doc.OptionSelect("First option", "First", TRUE) 
 doc.OptionSelect("Second option", "Second", False) 
 doc.OptionSelect("Third option", "Third", False) 
 doc.OptionSelect("Fourth option", "Fourth", False) 
 doc.OptionSelect("Fifth option", "Fifth", False) 
 doc.OptionSelect("Sixth option", "Sixth", False) 
 doc.EndSelect() 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.46 EndTable method

Ends a table definition in an HTML document.

Syntax

 object.EndTable()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndTable example ends the table definition in the HTML document.

 doc.BeginTable(TRUE) 
 doc.Caption("Table") 
 doc.BeginRow() 
 doc.TableHeading("Head1") 
 doc.TableHeading("Head2") 
 doc.EndRow() 
 oc.BeginRow() 
 doc.DataTable("Line11") 
 doc.DataTable("Line12") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line21") 
 doc.DataTable("Line22") 
 doc.EndRow() 
 doc.EndTable()
 

5.3.47 EndTag method

Writes an end of tag marker to the HTML document.

Syntax

 object.EndTag()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndTag example writes an end of tag marker to the HTML document.

 doc.BeginTag("B") 
 doc.Print("Hello") 
 doc.EndTag()
 

See Also

5.3.48 EndTextArea method

Defines the end of a text box in an HTML document.

Syntax

 object.EndTextArea()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This EndTextArea example defines the end of a text edit box in the HTML document.

 doc.BeginForm("process.bas") 
 doc.BeginTextArea("tVar", 5, 30) 
 doc.Print("This is the default Text") 
 doc.EndTextArea() 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.49 Format method

Enables or disables the HTML formatting in a document.

Syntax

 object.Format(
    HTMLFormatting As Boolean)
 

Parameters

HTMLFormatting
If TRUE, the HTML document is formatted. Otherwise, all text is written in a single line.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This Format example enables HTML formatting in the HTML document.

 doc.Format(TRUE)
 

5.3.50 GetEnvVar method

Reads the value of an HTML environment variable.

Syntax

 object.GetEnvVar(
    Variable As String)
 

Parameters

Variable
The name of the variable.

Return Values

String.

Example

This GetEnvVar example reads the value of QUERY_STRING in the HTML document.

 doc.Print(doc.GetEnvVar("QUERY_STRING")
 

5.3.51 GetVar method

Reads one or all of the CGI variables.

Syntax

 object.GetVar(
    Variable As String, 
    DefaultValue As String)
 

Parameters

Variable
Contains the name of the variable to be read.
DefaultValue
If the variable does not exist, DefaultValue is assigned.

Return Values

String.

Example

This GetVar example reads the CGI variables Color and Red.

 doc.Print(doc.GetVar("Color", "Red"))
 

5.3.52 GraphicLink method

Defines a graphic link in an HTML document.

Syntax

 object.GraphicLink(
    HREF As String 
    FileName As String)
 

Parameters

HREF
The hypertext link to be invoked.
FileName
The filename of the displayed image.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This GraphicLink example defines a link to the graphic novell.jpg in the HTML document.

 doc.GraphicLink("http://www.novell.com", "novell.jpg")
 

5.3.53 Heading method

Adds a title to an HTML document.

Syntax

 object.Heading(
    Heading As String)
 

Parameters

Heading
The title to be added.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This Heading example adds the title Document component to the HTML document.

 doc.Heading("Document component") 
 doc.Print("This text will appear in the browser")
 

See Also

5.3.54 HiddenEntry method

Defines a hidden input field within an HTML form.

Syntax

 object.HiddenEntry(
    Variable As String,
    cValue As String)
 

Parameters

Variable
The name of the CGI variable that will contain the value cValue.
cValue
The default value of the variable.

Return Values

Void.

Example

This HiddenEntry example defines the hidden input field HiddenVariable within the HTML form.

 doc.HiddenEntry("HiddenVariable", "Value")
 

5.3.55 Image method

Adds an image to an HTML document.

Syntax

 object.Image(
    FileName As String, 
    Alt As String 
    [,Height As Integer 
    [,Width As Integer 
    [,Align As Integer 
    [,Border As Integer 
    [,Map As String]]]]])
 

Parameters

FileName
The file in which the image is located.
Alt
The alternative text that replaces the graphic in non-graphical environments.
Height
Optional. The height of the image in pixels.
Width
Optional. The width of the image in pixels.
Align
Optional. The alignment of the image. See Alignment Constants.
Border
Optional. The width, in pixels, of the image border.
Map
Optional. An overloaded parameter. If ISMAP is passed as the parameter, it defines the image as a server-side image map. Otherwise, the image is a client-side image map. Specify the URL of the file containing the map definition, followed by a # and the name of the map (FileLocationURL#MapName).

Return Values

Void.

Example

This Image example adds the image novell.jpg to the HTML document.

 doc.Image("novell.jpg", "Novell")
 

5.3.56 ImagePath method

Returns the path of the image files in an HTML document.

Syntax

 object.ImagePath()
 

Parameters

None.

Return Values

String.

Example

This ImagePath example returns the path of the image files in the HTML document.

 doc.Print(doc.ImagePath())
 

5.3.57 Line method

Adds a horizontal line to an HTML document.

Syntax

 object.Line(
    Size As Integer,
    Width As Integer)
 

Parameters

Line
The thickness of the horizontal line in pixels.
Width
The width of the horizontal line as a percentage of the document width.

Return Values

Boolean. Returns TRUE if successful, else returns, else returns FALSE.

Example

This Line example adds a horizontal line to the HTML document that is one pixel thick and runs half the width of the document.

 doc.Line(1,50)
 

5.3.58 MapArea method

Defines an area in a client-side image map.

Syntax

 object.MapArea(
    Coords As String, 
    HREF As String 
    [,Shape As Integer 
    [,Target As String]])
 

Parameters

Coords
Specifies the coordinates of the area specified in the Shape parameter.
HREF
The URL of the document loaded when the user clicks in the area.
Shape
Optional. The shape of the map. See Shape Constants.
Target
Optional. The frame or window in which the linked URL appears.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This MapArea example defines three areas in the client-side image map. Each MapArea operation defines one-third of a rectangle.

 doc.beginmap("ClientMap") 
 doc.maparea("0, 0, 50, 50", "http://www.novell.com", 1) 
 doc.maparea("0, 50, 50, 100", "http://www.microsoft.com", 1) 
 doc.maparea("0, 100, 50, 150", "http://www.sun.com", 1) 
 doc.endmap()
 

5.3.59 Meta method

Defines the HTTP meta name/value pair for the document. These are used to extend the HTTP header information returned by the HTTP server.

Syntax

 object.Meta(
    Name As String, 
    Content As String 
    [,HTTP-EQUIV As String])
 

Parameters

Name
Specifies the name.
Value
Specifies the value/content.
Name
HTTP-EQUIV

Optional. Can be used in place of the NAME attribute and has a special significance when the documents are loaded by the HTTP server.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This Meta example defines the HTTP meta name/value pair for the HTML document.

 doc.BeginHeading() 
 doc.Title("Document component testing") 
 doc.Meta("Author","Ken Ceo") 
 doc.Meta("Keywords","NSN, Doc, Testing") 
 doc.EndHeading()
 

5.3.60 NumberList method

Creates a numbered list in an HTML document.

Syntax

 object.NumberList(
    Item1 As String 
    [,ItemN As String])
 

Parameters

Item1
The string to be added to the numbered list.
ItemN
Optional. Additional strings to be added to the numbered list.

Return Values

Void.

Remarks

This method takes a maximum of 15 items (including Item1) corresponding to the ItemN parameter.

Example

This NumberList example creates a three-item numbered list in the HTML document.

 doc.NumberList("Milk","Eggs","Bread")
 

5.3.61 OptionSelect method

Adds an option to a combo box in an HTML document.

Syntax

 object.OptionSelect(
    Option As String 
    [,Value As String 
    [,Selected As Boolean]])
 

Parameters

Option
The option text.
Value
Optional. The value that will be written to the CGI variable if Option is selected.
Selected
Optional. If TRUE, sets the specified option as the default value in the combo box.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This OptionSelect example adds six options to the combo box in the HTML document.

 doc.BeginForm("process.bas") 
 doc.BeginSelect("Selection", 5, TRUE) 
 doc.OptionSelect("First option", "First", TRUE) 
 doc.OptionSelect("Second option", "Second", False) 
 doc.OptionSelect("Third option", "Third", False) 
 doc.OptionSelect("Fourth option", "Fourth", False) 
 doc.OptionSelect("Fifth option", "Fifth", False) 
 doc.OptionSelect("Sixth option", "Sixth", False) 
 doc.EndSelect() 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.62 Paragraph method

Begins a new paragraph in an HTML document.

Syntax

 object.Paragraph(
    [AlignType As Integer 
    [,HTMLAttrs As String]])
 

Parameters

AlignType
Optional. The type of alignment. See Alignment Constants.
HTMLAttrs
Optional. The HTML extension attributes.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This Paragraph example begins a new paragraph in the HTML document.

 doc.Print("This is the first paragraph.") 
 doc.Paragraph(3,"ID=Para#1")  
 doc.Print("This is the second paragraph.")
 

See Also

5.3.63 Parse method

Parses a query string within a user-defined object.

Syntax

 object.Parse(
    QueryString As String)
 

Parameters

QueryString
The string to be parsed.

Return Values

Object.

Example

This Parse example parses a query string within a user-defined object.

 doc.Parse()
 

5.3.64 PasswordEntry method

Creates a password entry object in an HTML document.

Syntax

 object.PasswordEntry(
    Variable As String 
    [,Value As String 
    [,Label As String 
    [,MaxLength As String 
    [,Size As String 
    [,Align As Integer]]]]])
 

Parameters

Variable
Value is written into this parameter when the form is submitted.
Value
Optional. The default value displayed in the field.
Label
Optional. The label displayed to the left of the input box.
MaxLength
Optional. The maximum length of the input variable.
Size
Optional. The horizontal size of the input area.
Align
Optional. Specifies the alignment. See Alignment Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This PasswordEntry example creates a password entry object in the HTML document.

 doc.BeginForm("process.bas") 
 doc.PasswordEntry("password","xyz","Enter the password", "20") 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.65 Print method

Prints the information to an HTML document.

Syntax

 object.Print(
    [Item1 As String] 
    [,ItemN As String])
 

Parameters

Item1
Optional. The string to be printed.
ItemN
Optional. Additional strings to be printed.

Return Values

Void.

Remarks

This method takes a maximum of 15 items (including Item1) corresponding to the ItemN parameter.

Example

This Print example prints the specified information to the HTML document.

 doc.Print("Once again, Novell leads the way!")
 

5.3.66 RadioButton method

Defines a radio button in an HTML document.

Syntax

 object.RadioButton(
    Variable As String,
    Value As String,
    Message As String 
    Checked As Boolean,
    [,Align As Integer])
 

Parameters

Variable
Value is written into this parameter when the form is submitted.
Value
The default value displayed in the field.
Message
The text displayed adjacent to the button.
Checked
If set to TRUE, the button will be selected, else returns FALSE.
Align
Optional. Specifies the alignment. See Alignment Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This RadioButton example defines five radio buttons in the HTML document.

 doc.BeginForm("process.bas") 
 doc.Print("Select the color") 
 doc.Break() 
 doc.RadioButton("Var", "Green", "Green", TRUE)
 doc.Break() 
 doc.RadioButton("Var", "Red", "Red", FALSE) 
 doc.Break()
 doc.RadioButton("Var", "Blue", "Blue", FALSE) 
 doc.Break()
 doc.RadioButton("Var", "Yellow", "Yellow", FALSE) 
 doc.Break()
 doc.RadioButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.67 Raw method

Stops the creation of the HTTP header in an HTML document.

Syntax

 object.Raw()
 

Parameters

None.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This Raw example stops the creation of an HTTP header in the HTML document.

 doc.Raw()
 

5.3.68 ResetButton method

Adds a reset form to the defaults button in an HTML document.

Syntax

 object.ResetButton(
    Value As String 
    [,Align As Integer]))
 

Parameters

Value
The String to write as the button text.
Align
Optional. Specifies the alignment. See Alignment Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This ResetButton example adds a reset form to the default button in the HTML document.

 doc.BeginForm("process.bas")
 doc.Print("Select the color")
 doc.Break() 
 doc.RadioButton("Var", "Green", "Green", TRUE)
 doc.Break 
 doc.RadioButton("Var", "Red", "Red", FALSE) 
 doc.Break 
 doc.RadioButton("Var", "Blue", "Blue", FALSE)
 doc.Break 
 doc.RadioButton("Var", "Yellow", "Yellow", FALSE)
 doc.Break 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.69 SubmitButton method

Adds a submit form to the defaults button to an HTML document.

Syntax

 object.SubmitButton(
    Value As String 
    [,Align As Integer])
 

Parameters

Value
The String to write as the button text.
Align
Optional. Specifies the alignment. See Alignment Constants

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This SubmitButton example adds a submit form button to the HTML document.

 doc.BeginForm("process.bas") 
 doc.Print("Select the color") 
 doc.Break() 
 doc.RadioButton("Var", "Green", "Green", TRUE)
 doc.Break()
 doc.RadioButton("Var", "Red", "Red", FALSE)
 doc.Break()
 doc.RadioButton("Var", "Blue", "Blue", FALSE)
 doc.Break()
 doc.RadioButton("Var", "Yellow", "Yellow", FALSE)  
 doc.Break()
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.70 TableHeading method

Adds a heading to a table in an HTML document.

Syntax

 object.TableHeading(
    Heading As String 
    [,Height As String 
    [,Width As String 
    [,HAlign As Integer 
    [,VAlign As Integer]]]])
 

Parameters

Heading
The heading to be put on the table.
Height
Optional. The height of the entire table, either as an absolute pixel value or as a percentage of the available height.
Width
Optional. The width of the entire table, either as an absolute pixel value or as a percentage of the available width.
HAlign
Optional. The horizontal alignment of the heading. See Alignment Constants.
VAlign
Optional. The vertical alignment of the heading. See Alignment Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This TableHeading example adds two headings to a table in the HTML document.

 doc.BeginTable(TRUE) 
 doc.Caption("Table") 
 doc.BeginRow() 
 doc.TableHeading("Head1") 
 doc.TableHeading("Head2") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.DataTable("Line11") 
 doc.DataTable("Line12") 
 doc.EndRow() 
 doc.BeginRow() 
 doc.BeginData() 
 doc.Print("Line21") 
 doc.EndData() 
 doc.BeginData() 
 doc.Print("Line22") 
 doc.EndData() 
 doc.EndRow() 
 doc.EndTable()
 

5.3.71 TextArea method

Defines a text edit box in an HTML document.

Syntax

 object.TextArea(
    Variable As String, 
    Rows As Integer, 
    Columns As Integer, 
    Text As String)
 

Parameters

Variable
Value is written into this parameter when the form is submitted.
Rows
The number of rows in the edit box.
Columns
The number of columns in the edit box.
Text
The text you enter here will be displayed in the text area upon creation.

Return Values

Void.

Example

This TextArea example defines a text edit box of five rows and thirty columns in the HTML document.

 doc.BeginForm("process.bas") 
 doc.TextArea("tVar", 5, 30, "This is the default text") 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.72 TextEntry method

Defines a text input area in an HTML document.

Syntax

 object.TextEntry(
    Variable As String 
    [,Value As String 
    [,Label As String 
    [,MaxLength As String 
    [,Size As String 
    [,Align As Integer]]]]])
 

Parameters

Variable
Value is written into this parameter when the form is submitted.
Value
Optional. The default value displayed in the field.
Label
Optional. The label displayed to the left of the input box.
MaxLength
Optional. The maximum length of the input variable.
Size
Optional. The horizontal size of the input area.
Align
Optional. Specifies the alignment. See Alignment Constants.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This TextEntry example defines a text input area in the HTML document.

 doc.BeginForm("process.bas") 
 doc.TextEntry("tvar","Initial Value","Testing the Text Entry","10",70" 0) 
 doc.ResetButton("Reset the form") 
 doc.SubmitButton("Submit the form") 
 doc.EndForm()
 

5.3.73 TextLink method

Defines a text link in an HTML document.

Syntax

 object.TextLink(
    HREF As String, 
    Text As String)
 

Parameters

HREF
The hypertext reference to be invoked.
Text
The value displayed on the page.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This TextLink example defines a text link to the Novell Web site.

 doc.TextLink("http://www.novell.com", "Novell")
 

5.3.74 Title method

Adds a title to an HTML document.

Syntax

 object.Title(
    Title As String)
 

Parameters

Title
The title of the document.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This Title example adds the title Document component to the HTML document.

 doc.BeginHeading() 
 doc.Title("Document component") 
 doc.Meta("Author", "Ken Ceo") 
 doc.EndHeading()
 

5.3.75 TranslateScreen method

Translates the NLM screen contents to display in a browser.

Syntax

 object.TranslateScreen(
    Buffer As String 
    [,HighlightOn As String, 
    HighlightOff As String]]
 

Parameters

Buffer
The screen contents to display in a browser.
HighlightOn
Optional. The string to precede the highlighted text.
HighlightOff
Optional. The string to follow the highlighted text.

Return Values

Boolean. Returns TRUE if successful, else returns FALSE.

Example

This TranslateScreen example translates the NLM screen contents to display in a browser.

 set server= createobject("ucx:server") 
 set screens= server.Screens 
 screens.Reset()
 set scr=screens.Next()
 buf= scr.Read
 doc.TranslateScreen(buf)
 

5.3.76 URLPrefix method

Returns the URL prefix used by an NSN script.

Syntax

 object.URLPrefix()
 

Parameters

None.

Return Values

String.

Example

This URLPrefix example returns the /NSN which is the URL prefix for NSN script.

 doc.Print(doc.URLPrefix())
 
See Also

5.3.77 ZZEval method

At the end of the HTML page, this method displays the message: “This page was created by NSN. For more information on additional NLM components, contact Novell."

Syntax

 object.ZZEval()
 

Parameters

None.

Return Values

Void.

Example

This ZZEVal example causes the message “This page was created by NSN. For more information on additional NLM components, contact Novell” to be generated at the end of HTML page.

 doc.ZZEval()