SftDirectory 3.5 - ActiveX File/Folder Control

SftDirectory.TopMostFolderSpecial Property

Defines the topmost folder displayed using predefined values.

Syntax

Get

Put

object

A SftDirectory object.

FolderSpecial

Defines the topmost folder displayed using a folder's system-independent CSIDL. CSIDL values provide a system-independent method to identify special folders. SftDirectorySpecialFolderConstants describes all available CSIDL values:

Comments

The TopMostFolderSpecial property defines the topmost folder displayed using predefined values.

The control's contents are loaded and displayed using the folder's system-independent CSIDL.

Examples

VB.NET

    ' If the selection in the left tree changes, update right side detaillist
    UpdateLeftButtons()
    AxSftDirectoryRight.Clear()
    AxSftDirectoryRight.CancelMode()
    AxSftDirectoryRight.Refresh()
    If Not AxSftDirectoryLeft.CurrentFolder Is Nothing Then
        AxSftDirectoryRight.TopMostFolderIDL = AxSftDirectoryLeft.CurrentFolder.ItemIDList
    Else
        AxSftDirectoryRight.TopMostFolderSpecial = SftDirectorySpecialFolderConstants.specialSftDirectoryEmpty
    End If
End Sub

Private Sub AxSftDirectoryRight_Opening(ByVal sender As Object, ByVal e As AxSftDirectoryLib30._ISftDirectoryEvents_OpeningEvent) Handles AxSftDirectoryRight.Opening
    Dim F As SftDirectoryFolder
    Dim IDL As String
    ' we're about to open a file/folder.  If we can add the folder on the

View Entire Sample Code

VB6

    ' If the selection in the left tree changes, update right side detaillist
    UpdateLeftButtons
    SftDirectoryRight.Clear
    SftDirectoryRight.CancelMode
    SftDirectoryRight.Refresh
    If Not SftDirectoryLeft.CurrentFolder Is Nothing Then
        SftDirectoryRight.TopMostFolderIDL = SftDirectoryLeft.CurrentFolder.ItemIDList
    Else
        SftDirectoryRight.TopMostFolderSpecial = specialSftDirectoryEmpty
    End If
End Sub

Private Sub SftDirectoryRight_Opening(Folder As SftDirectoryLib30.ISftDirectoryFolder, Allow As Boolean)
    Dim F As SftDirectoryFolder
    Dim IDL As String
    ' we're about to open a file/folder.  If we can add the folder on the

View Entire Sample Code

C#

    // If the selection in the left tree changes, update right side detaillist
    UpdateLeftButtons();
    axSftDirectoryRight.Clear();
    axSftDirectoryRight.CancelMode();
    axSftDirectoryRight.Refresh();
    if (axSftDirectoryLeft.CurrentFolder != null)
        axSftDirectoryRight.TopMostFolderIDL = axSftDirectoryLeft.CurrentFolder.ItemIDList;
    else
        axSftDirectoryRight.TopMostFolderSpecial = SftDirectorySpecialFolderConstants.specialSftDirectoryEmpty;
}

private void axSftDirectoryRight_Opening(object sender, AxSftDirectoryLib30._ISftDirectoryEvents_OpeningEvent e) {
    SftDirectoryFolder f;
    String IDL;
    // we're about to open a file/folder.  If we can add the folder on the
    // left side, that means we don't need to open it in a separate window

View Entire Sample Code

C++

    UpdateLeftButtons();
    vDirRight->Clear();
    vDirRight->CancelMode();
    vDirRight->Refresh();
    if (vDirLeft->CurrentFolder != NULL)
        vDirRight->TopMostFolderIDL = vDirLeft->CurrentFolder->ItemIDList;
    else
        vDirRight->TopMostFolderSpecial = specialSftDirectoryEmpty;
}

void CSimpleExplorerDlg::OnOpening_SftDirectoryRight(LPDISPATCH FAR* Folder, BOOL FAR* Allow)
{
    ISftDirectoryFolderPtr f = *Folder;
    _bstr_t bstrIDL;
    ISftDirectoryPtr vDirLeft = m_DirLeft.GetControlUnknown();

View Entire Sample Code

See Also SftDirectory Object | Object Hierarchy