OnItemList Event

Generated when a directory listing of resources is requested from the server.

Syntax

Sub object_OnItemList ( [Index As Integer], ByVal ItemType As Variant, ByVal Description As Variant, ByVal Selector As Variant, ByVal RemoteHost As Variant, ByVal RemotePort As Variant )

Remarks

The OnItemList event is generated for each item that is returned by the server when a directory item is selected. These values can, in turn, be used to request a specific document. The following arguments are passed to the event handler:

ItemType
A string argument which specifies the type of item that the selector string refers to. The possible values are the same as for the ItemType property. A type of gopherItemDirectory indicates that the selector refers to a directory which contains additional items.
Description
A string argument which provides a description of the item that the selector string refers to. This string, and not the selector, should be displayed to the user.
Selector
An argument which specifies the selector string that should be used to refer to the document on the remote server. The string is considered opaque because it's value does not generally have any meaning except to the Gopher server.
RemoteHost
A string argument which specifies the host name or IP address of the server that the client should connect to in order to retrieve the item.
RemotePort
A numeric argument which specifies the port number on the remote server which the client should connect to in order to retrieve the item.

See Also

HostName Property, ItemSelector Property, ItemType Property, RemotePort Property, Select Method


Copyright © 2008 Catalyst Development Corporation. All rights reserved.