|
|
![]() |
|
||
|
|
|||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||
| Visual Basic File API Routines FindFirstFile: Enumerate Folders to a TreeView |
||
| Posted: | Friday July 25, 1997 | |
| Updated: | Monday December 26, 2011 | |
| Applies to: | VB4-32, VB5, VB6 | |
| Developed with: | VB6, Windows NT4 | |
| OS restrictions: | None | |
| Author: | VBnet - Randy Birch | |
|
Related: |
Enumerating Folders
using FindFirstFile and FindNextFile API, Advanced FindFirstFile: Fast Directory File Count FindFirstFile: Performance Comparison - FSO vs. API FindFirstFile: Comparison of FindFirstFile and SearchTreeForFile FindFirstFile: Save a Recursive Search of All Drives to Disk FindFirstFile: Save a Recursive Search of Specified Drives to Disk GetFileVersionInfo: File Search and File Property Info CopyFileEx: Create a File Backup App CopyFileEx: Create a File Backup App with a Progress Callback |
|
| Prerequisites |
| None. |
|
|
Original
recursion routine by Trond Solberg, soltro@Mandatum.no.This code is intended to demonstrate how to recursively search for all folders on a target drive using the Win95/Win98/NT4 FindFirstFile and FindNextFile APIs, and display the results into a treeview control. FindFirstFile, on successful finding of a file matching the filespec passed, returns a handle for subsequent calls by FindNextFile, and the data of the retrieved file in the WIN32_FIND_DATA structure. The structure member dwFileAttributes, when AND'd with the VB constant vbDirectory can be used to determine if the returned item is a file or folder. The routine stores the folder names in an array, and once a pass is completed at each level, creates the treeview data. Start a new project, and to the form add a command button (Command1), a Treeview control (Treeview1) and an auto-sizing label (Label1) as indicated in the illustration. |
| BAS Module Code |
|
|
| Place the following code into the general declarations area of a bas module: |
|
|
Option Explicit '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ' Copyright ©1996-2011 VBnet/Randy Birch, All Rights Reserved. ' Some pages may also contain other copyrights by the author. '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' ' Distribution: You can freely use this code in your own ' applications, but you may not reproduce ' or publish this code on any web site, ' online service, or distribute as source ' on any media without express permission. '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' Public Const MAX_PATH As Long = 260
'GetDriveType return values
Public Const DRIVE_REMOVABLE As Long = 2
Public Const DRIVE_FIXED As Long = 3
Public Const DRIVE_REMOTE As Long = 4
Public Const DRIVE_CDROM As Long = 5
Public Const DRIVE_RAMDISK As Long = 6
Public Type FILETIME
dwLowDateTime As Long
dwHighDateTime As Long
End Type
Public Type WIN32_FIND_DATA
dwFileAttributes As Long
ftCreationTime As FILETIME
ftLastAccessTime As FILETIME
ftLastWriteTime As FILETIME
nFileSizeHigh As Long
nFileSizeLow As Long
dwReserved0 As Long
dwReserved1 As Long
cFileName As String * MAX_PATH
cAlternate As String * 14
End Type
Public Declare Function GetLogicalDriveStrings Lib "kernel32" _
Alias "GetLogicalDriveStringsA" _
(ByVal nBufferLength As Long, _
ByVal lpBuffer As String) As Long
Public Declare Function FindFirstFile Lib "kernel32" _
Alias "FindFirstFileA" _
(ByVal lpFileName As String, _
lpFindFileData As WIN32_FIND_DATA) As Long
Public Declare Function FindNextFile Lib "kernel32" _
Alias "FindNextFileA" _
(ByVal hFindFile As Long, _
lpFindFileData As WIN32_FIND_DATA) As Long
Public Declare Function FindClose Lib "kernel32" _
(ByVal hFindFile As Long) As Long
'flags for the user options
Public displayExpanded As Boolean
Public displaySorted As Boolean
Public NoOfDrives As Integer
Public Function TrimNull(startstr As String) As String
Dim pos As Long
pos = InStr(startstr, Chr$(0))
If pos Then
TrimNull = Left$(startstr, pos - 1)
Exit Function
End If
'if this far, there was no Chr$(0), so return the string
TrimNull = startstr
End Function
Public Sub GetAllDrivesFolders(tvwTree As Control, nodParentNode As Node)
'this routine uses a pre-dimmed array to speed up
'processing. Initially, the array is DIM'med to
'200 elements; in the While loop it is increased
'another 200 elements when "found Mod 200 = 0"
'(or the number found divided by 200 equals 0).
'At the end of the loop, it is resized down to the
'total found. This is significantly faster than
'using a Redim Preserve statement for each element found.
Dim nodX As Node
Dim WFD As WIN32_FIND_DATA
Dim hFile As Long
Dim sFile As String
Dim sPath As String
Dim i As Long
Dim r As Long
Dim found As Long
'assign the fullpath property to the path to search,
'assuring that the path is qualified.
If Right$(nodParentNode.FullPath, 1) <> "\" Then
sPath = nodParentNode.FullPath & "\"
Else
sPath = nodParentNode.FullPath
End If
'find the first file matching the parameter \*.*
hFile = FindFirstFile(sPath & "*.*" & Chr$(0), WFD)
'reset the counter flag
found = 0
ReDim fArray(200)
If hFile <> -1 Then
sFile = TrimNull(WFD.cFileName)
WFD.dwFileAttributes = vbDirectory
While FindNextFile(hFile, WFD)
sFile = TrimNull(WFD.cFileName)
'ignore the 2 standard root entries
If (sFile <> ".") And (sFile <> "..") Then
If (WFD.dwFileAttributes And vbDirectory) Then
'if found is at 200, then add some more array elements
found = found + 1
If found Mod 200 = 0 Then ReDim Preserve fArray(found + 200)
fArray(found) = sFile
End If
End If
Wend
End If
Call FindClose(hFile)
'trim down the array to equal the elements found
ReDim Preserve fArray(found)
'add the folders to the treeview
For i = 1 To found
Set nodX = tvwTree.Nodes.Add(nodParentNode.Key, _
tvwChild, _
sPath & fArray(i) & "Dir", _
fArray(i))
'and get some more
GetAllDrivesFolders tvwTree, nodX
Next i
nodParentNode.Sorted = displaySorted
nodParentNode.Expanded = displayExpanded
End Sub |
| Form Code |
|
|
| To the form, add the following code: |
|
|
Option Explicit
Private Sub Form_Load()
'centre the form
Me.Move (Screen.Width - Me.Width) / 2, (Screen.Height - Me.Height) / 2
'set initial options
displaySorted = True
displayExpanded = False
'load the system drives
GetSystemDrives
'store the initial number of treeview elements for
'later subtraction when presenting the total number
'of files loaded (Treeview1_click routine)
NoOfDrives = Treeview1.Nodes.Count
Label1.Caption = "Click on any drive letter to load its folders."
End Sub
Private Sub Command1_Click()
Unload Me
End Sub
Private Sub GetSystemDrives()
Dim nodX As Node
Dim r As Long
Dim allDrives As String
Dim currDrive As String
Dim drvIcon As Integer
'get the list of all available drives
allDrives = rgbGetAvailableDrives()
Do Until allDrives = Chr$(0)
'strip off one drive item from the allDrives$
currDrive = StripNulls(allDrives)
'we can't have the trailing slash, so ..
currDrive = Left$(currDrive, 2)
'add the drive to the treeview
Set nodX = Treeview1.Nodes.Add(, tvwChild, _
currDrive & "Dir", _
currDrive)
nodX.Expanded = True
Loop
'force sorting of the drive letters
nodX.Sorted = True
End Sub
Private Function rgbGetAvailableDrives() As String
'returns a single string of available drive
'letters, each separated by a chr$(0)
Dim tmp As String
tmp = Space$(64)
Call GetLogicalDriveStrings(Len(tmp), tmp)
rgbGetAvailableDrives = Trim$(tmp)
End Function
Private Function StripNulls(startstr As String) As String
'Take a string separated by chr$(0)
'and split off 1 item, shortening the
'string so next item is ready for removal.
Dim pos As Long
pos = InStr(startstr$, Chr$(0))
If pos Then
StripNulls = Mid$(startstr, 1, pos - 1)
startstr = Mid$(startstr, pos + 1, Len(startstr))
End If
End Function
Private Sub Treeview1_Click()
Dim nodX As Node
'show a wait message for long searches
Label1.Caption = "Searching drive " & Treeview1.SelectedItem & " for folders ... please wait"
DoEvents
'identify the selected node
Set nodX = Treeview1.SelectedItem
'verify that it is valid>
If (UCase$(Right$(nodX.Key, 3)) = "DIR") And (nodX.Children = 0) Then
GetAllDrivesFolders Treeview1, nodX
End If
'subtract NoOfDrives because initial drives loaded
'should not be counted as a folder
Label1.Caption = "Total folders displayed : " & Treeview1.Nodes.Count - NoOfDrives
End Sub |
| Comments |
| When the form loads, the treeview is filled with the
available drives via the GetSystemDrives routine. Clicking a drive letter invokes the Treeview1_Click() routine, which calls the
GetAllDrivesFolders Sub.
The first execution of GetAllDrivesFolders returns the first-level of folders (try commenting out the line "GetAllDrivesFolders tvwTree, nodX" to demonstrate), and for each folder added to the treeview, the routine again calls GetAllDrivesFolders passing the node item to search from. Once no more folders are found (that is, there are no more folders within a given level), control returns to the calling line, which loads the next folder and restarts the process until all the first-level folders have been searched for sub-folders |
|
|
|
|
|
|||||
|
|||||
|
|
|||||
|
Copyright ©1996-2011 VBnet and Randy Birch. All Rights Reserved. |
![]() |