VisDesktopListBox

Namespace: PPJ.Runtime.Vis

Assembly: PPJ.Web.Vis.50 (5.0.0.0)

Displays a desktop-style outline of the application server's drives and directories.

C#

public class VisDesktopListBox : VisOutlineListBox

VB.NET

Public Class VisDesktopListBox
    Inherits VisOutlineListBox

SAL creation builds Desktop, My Computer, and Network Neighborhood nodes and enumerates server logical drives. Directory children are loaded on expansion.

Example:

var browser = new VisDesktopListBox();
            // After the user selects a directory:
            SalString path = browser.GetSelectedDir();

Constructors

VisDesktopListBox()

Loads the shared drive/folder pictures and attaches the outline message handler.

Methods

FromHandle(hWnd)

Resolves a SAL handle to an existing VisDesktopListBox.

Parameter	Type	Description
hWnd	SalWindowHandle	The control handle to resolve.

Returns: VisDesktopListBox. The associated control, or when no control is resolved.

Throws:

• InvalidCastException The handle identifies an incompatible control type.

GetItemDir(hItem)

Builds a filesystem path from an outline node handle.

Parameter	Type	Description
hItem	SalNumber	The persistent Visual Toolchest node handle, not a visible item index.

Returns: SalString. The path, or SalString.Null for an unknown handle or a Desktop, My Computer, or Network Neighborhood node.

GetSelectedDir()

Builds a filesystem path from the selected node.

Returns: SalString. The selected path, or SalString.Null if nothing is selected.

Synthetic desktop nodes do not identify filesystem directories and may yield an empty path.

Implements

Name	Description
ISalControl
ISalListControl
ISalWindow