Tray Icon

Wconnect has been designed so you don't need to understand its icons. The dial-status dialog makes sure you know what's going on; follow what it says and you can't go wrong. In summary:

and mean its okay for you to use the net; you cannot use the net for any other icon.

The means no-one is using everything is disconnected and the connection shouldn't be up.

Everything else is something inbetween--there are tooltips for each icon describing what it means and packing in as many useful extras as there is room for. The following is a detailed breakdown of how the icon works:

Connect keeps the connection open as long as anyone is using the net. (So the net can be open even if you're not using it.) Wconnect's icon shows both whether you personally want to use the net, and what the link as a whole is doing. These two things are independant.

1. what you want is indicated by colour; like a traffic-light green for go (you want the net) and red for stop (you don't want the net). It can also be grey when its not possible to use the net.

2. What actually's happening is represented by shape: a triangle pointing down means the connection is down (or going down) while an upwards arrow means the connection is up (or going up).

The big down triangle is displayed when there is no connection: its "fully" down.

A little triangle, pointing up from the bottom of the tray is displayed to indicate the first attempt at dialing out.

An up-arrow with a box under it indicate the link is making its second dial attempt.

An up-arrow with two boxes under it indicates the srver is making at least its third attempt to dial-out. The server comes preconfigured to make no-more than three dial attempts--but it is possible to override this. The tooltip and dial-status dialog both show the exact dial attempt.

The big up arrow is displayed when the link is fully up. But the green up-triangle is used only when you're the only person using the net.

The up-arrow with "wings" (they're meant to be two triangles in the background) is displayed when the connection is up and you're sharing it with other users. This isn't displayed for red or grey connections.

A small triangle, at the top of the tray, pointing down, is used when the link is closing.

Green icons indicate that you want to use the net. N.B. its only possible to use the net for the or icons. Other shapes indicate that the server is trying to establish a connection for you.

Double-clicking on a green icon always disconnects you (making your icon red). Similarly wconnect's menu offers the option to disconnect from whichever provider is in use.

Red icons are shown when you don't want to use the net. (It may be possible to access the net despite a red icon--but don't count on it; the server certainly won't keep the connection open on your behalf.)

Whenever a red item is shown, wconnect's menu offers you the option to connect. When the connection is fully down () its possible to connect to any provider and the connect option opens onto a submenu of providers (unless your system only has one). Double clicking on connects to the default provider; which is probably the last provider used.

Double-clicking on other red icons will connect to the provider which is in use.

Like red icons, Grey icons signify you're not using the net, but unlike a red icon you cannot connect even if you want to; you're connection is blocked. While blocked Double-clicking does nothing and wconnect's menu is greyed out.

Grey icons happen because the server is misconfigured (either no providers or no links setup) or because the Connection Control List prohibits you from connecting.

Connections prohibitted while the link is down (i.e. ) are because you've exceeded your quota, or you can't access any of the providers at this time of day. For other grey icons it may simply be because another user is accessing a provider you can't use.

Any of these icons can be changed from the config file.

name is the icon to be changed:

	LoggedOff
	Looking
	MultiYesUp
	Yes1stRetry
	Yes2ndRetry
	Yes3rdRetry
	YesUp
	YesGoingDown
	YesDown
	No1stRetry
	No2ndRetry
	No3rdRetry
	NoUp
	NoGoingDown
	NoDown
	Blocked1stRetry
	Blocked2ndRetry
	Blocked3rdRetry
	BlockedUp
	BlockedGoingDown
	BlockedDown

file is a .ICO file or DLL containing the icon and index is the number of the icon within that file.

    YesUp.Icon          'myicons.dll,0'
    MultiYesUp.Icon     'myicons.dll,1'
    

Sometimes Explorer dies and restarts leaving wconnect running but with no visible icon. The only way I've found to spot this is to periodically check if explorer has restarted, so whenever wconnect changes the icon or receives a keepalive probe probe from the server (which normally happens once a minute) wconnect will reattach to the iconbar if explorer has restarted.

If you can't wait that long (or you're not logged-in or the server is not sending keepalives) then wconnect will also check whenever you hit its hotkey (by default control+shift+A). Wconnect can be instructed to poll for explorer from the config file, with the ExplorerPoll seconds directive.