POP Component

The POP control is used retrieve electronic mail from Internet Post Office servers (POP). (NOTE: The following is a very short description. For more information, please consult the help files that come with the respective package.)

The POP control implements a standard internet post office (POP3) client as specified in RFC 1725.

The control is driven by a few key properties and the Action property. To connect to a MailServer first set the appropriate User and Password and then connect by setting Action to 'Connect'. Upon successful connection to the MailServer, the number of waiting messages is shown by the MessageCount property. A message is selected by setting the MessageNumber property to a number between 1 and MessageCount (inclusive). Then, message text and/or headers are received by setting Action to the appropriate value.

The message text is received through the Transfer event, whereas the message headers are received through the Header event. The body of the message is also saved in the file specified by the LocalFile property. StartTransfer and EndTransfer events are fired at the beginning and end of message transmission. The PITrail event provides a trace of the interaction between the client and server (excluding message transfers).

This control requires a Winsock 1.1 compliant TCP/IP stack. This means that the Winsock stack installed in the system must have a version of at least 1.1. In particular, Windows 95, 98, and NT machines with Winsock 2.0 are fully supported.

PROPERTIES

Action. An action code for the control.

Command. Can be used to send additional commands directly to the POP server.

LastReply. The last reply from the server.

LocalFile. The path to a local file for downloading the message body. If the file exists, it is overwritten. (optional)

LocalHost. The name of the local host. When connected, the IP address of the interface through which the connection was made.

MailPort. The server port for POP (default 110).

MailServer. The name or address of a mail server (internet post office server).

MaxLineLength. The maximum expected length for message lines.

MaxLines. The maximum number of message lines beside headers to retrieve.

MessageCount. The number of messages waiting in the mailbox.

MessageNumber. Current (selected) message.

MessageSize. The size in bytes of the current message.

Password. The password for the mailbox user.

SocketHandle. The handle of the main socket used by the control.

TotalSize. Cumulative size in bytes of messages in the mailbox (including headers).

User. The user id for the mailbox.

WinsockInfo. Identifying information about the loaded Winsock stack.

WinsockLoaded. Loads and unloads Winsock on demand.

WinsockMaxDatagramSize. Size in bytes of the largest UDP datagram that can be sent or received.

WinsockMaxSockets. Maximum number of sockets available to a single process.

WinsockPath. The path to the Winsock DLL used.

WinsockStatus. The status of the Winsock stack.

EVENTS

EndTransfer. Fired when the message completes transferring.

Error. Information about errors during data delivery.

Header. Fired for every message header being retrieved.

PITrail. Traces the commands sent to the mail server, and the respective replies.

StartTransfer. Fired when the message starts transferring.

Transfer. Fired while the message gets transferred from MailServer.