Garry's Mod Wiki

Revision Difference

DFileBrowser#552315

<panel> <parent>DPanel</parent> <realm>Client</realm>⤶ <description> A tree and list-based file browser. ⤶ It allows filtering by folder (directory) name and file extension, and can display models as <page>SpawnIcon</page>s. A tree and list-based file browser. ⤶ It allows filtering by folder (directory) name and file extension, and can display models as <page>SpawnIcon</page>s. </description> ⤶ </panel>⤶ </panel>⤶ <example> <description>Creates a DFileBrowser and displays the data/persist folder. Any file clicked is printed to the console.</description> <code> local frame = vgui.Create( "DFrame" ) frame:SetSize( 500, 250 ) frame:SetSizable( true ) frame:Center() frame:MakePopup() frame:SetTitle( "DFileBrowser Example" ) local browser = vgui.Create( "DFileBrowser", frame ) browser:Dock( FILL ) browser:SetPath( "GAME" ) -- The access path i.e. GAME, LUA, DATA etc. browser:SetBaseFolder( "data" ) -- The root folder browser:SetOpen( true ) -- Open the tree to show sub-folders browser:SetCurrentFolder( "persist" ) -- Show files from persist function browser:OnSelect( path, pnl ) -- Called when a file is clicked print( path ) end </code> <output><image src="DFileBrowser_example.png"/></output> </example> <example> <description> Creates a DFileBrowser that can spawn models from `props_` folders. <note>Uses the same <page>DFrame</page> as above</note> </description> <code> local frame = vgui.Create( "DFrame" ) frame:SetSize( 500, 250 ) frame:SetSizable( true ) frame:Center() frame:MakePopup() frame:SetTitle( "DFileBrowser Example" ) local browser = vgui.Create( "DFileBrowser", frame ) browser:Dock( FILL ) browser:SetPath( "GAME" ) -- The access path i.e. GAME, LUA, DATA etc. browser:SetBaseFolder( "models" ) -- The root folder browser:SetName( "Props_ Models" ) -- Name to display in tree browser:SetSearch( "props_" ) -- Search folders starting with "props_" browser:SetFileTypes( "*.mdl" ) -- File type filter browser:SetOpen( true ) -- Opens the tree (same as double clicking) browser:SetCurrentFolder( "props_badlands" ) -- Set the folder to use function browser:OnSelect( path, pnl ) -- Called when a file is clicked RunConsoleCommand( "gm_spawn", path ) -- Spawn the model we clicked frame:Close() end </code> <output>`See Preview`.</output> </example> <example> <description>Same as above, but enables model viewing. The following line is added to the above code.</description> <code>browser:SetModels( true ) -- Use SpawnIcons instead of a list</code> <output><image src="DFileBrowser_models.png"/></output> </example> <example> <description>Same as above, but enables model viewing. The following line is added to the above code.</description> <code>browser:SetModels( true ) -- Use SpawnIcons instead of a list</code> <output><image src="DFileBrowser_models.png"/></output> </example> <example> <description> Creates a DFileBrowser for browsing and selecting sounds. </description> <code> -- Create a new frame (window) local frame = vgui.Create("DFrame") frame:SetSize( 500, 250 ) -- Set the size of the frame frame:SetSizable( true ) -- Allow the frame to be resizable frame:Center() -- Center the frame on the screen frame:MakePopup() -- Make the frame appear in front of other windows and accept user input frame:SetTitle( "Select a sound:" ) -- Set the title of the frame -- Create a file browser inside the frame local browser = vgui.Create( "DFileBrowser", frame ) browser:Dock( FILL ) -- Make the browser fill the entire frame -- Set the path that the browser should start in. "GAME" is a special path that refers to the game's root directory. browser:SetPath("GAME") -- Set the base folder to start searching to 'sound' (contains every sound from every addon/game) browser:SetBaseFolder( "sound" ) browser:SetOpen( true ) -- Show the folder as already open when the browser is created browser:SetFileTypes(".wav .mp3 .ogg") -- Filter the file types that the browser should only display local s = nil -- Initialize a local var to hold the preview sound -- Define what should happen when a file is double-clicked in the browser browser.OnDoubleClick = function(panel, path) if(s ~= nil) then s:Stop() end -- If a sound is currently playing, stop it -- Select the sound and set it as the value of our ConVar, remove the "sound/" part from the path GetConVar("mysoundconvar"):SetString(string.Replace(path, "sound/","")) frame:Close() -- Close the frame end -- Define what should happen when a file is clicked in the browser browser.OnSelect = function(panel, path) if(s ~= nil) then s:Stop() end -- If a sound is currently playing, stop it s = CreateSound(LocalPlayer(), string.Replace(path, "sound/","")) -- Create and play a new sound from the selected file s:Play() end </code> <output><upload src="b4b46/8db900e82808bc0.png" size="126209" name="sound_browser.png" /></output> </example>