<panel> <parent>TextEntry</parent> <realm>Client and Menu</realm> <description> A form which may be used to display text the player is meant to select and copy or alternately allow them to enter some text of their own. <note>At least one of your `DTextEntry`'s parents must either be an <page>EditablePanel</page> or derived from it (like a <page>DFrame</page>, for example), else it won't be able to focus and thus be unselectable. You must also call <page>Panel:MakePopup</page> on said panel or the `DTextEntry` will not work.</note> </description> </panel> <example> <description>Creates a text entry form that allows you to print messages into the local player's chat window. </description> <code> concommand.Add( "test_textentry", function(ply) local frame = vgui.Create( "DFrame" ) frame:SetSize( 400, 200 ) frame:Center() frame:MakePopup() local TextEntry = vgui.Create( "DTextEntry", frame ) -- create the form as a child of frame TextEntry:Dock( TOP ) TextEntry.OnEnter = function( self ) chat.AddText( self:GetValue() ) -- print the textentry text as a chat message end local TextEntryPH = vgui.Create( "DTextEntry", frame ) TextEntryPH:Dock( TOP ) TextEntryPH:DockMargin( 0, 5, 0, 0 ) TextEntryPH:SetPlaceholderText( "I am a placeholder" ) TextEntryPH.OnEnter = function( self ) chat.AddText( self:GetValue() ) end end ) </code> <output> <upload src="70c/8d88bebe8e67219.png" size="11372" name="image.png" /> </output> </example> <example> <description>Creates a text entry with a browse button.</description> <code> -- Create a new frame (window) local frame = vgui.Create( "DFrame" ) frame:SetSize( 300, 300 ) -- Set the size of the frame frame:Center() -- Center the frame on the screen frame:MakePopup() -- Make the frame appear in front of other windows and accept user input -- Create a text entry field within the frame local tEntry = vgui.Create("DTextEntry", frame) tEntry:Dock(TOP) -- Dock the text entry at the top of the frame -- Create a new button within the text entry field local browseBtn = vgui.Create("DButton", tEntry) browseBtn:SetText("...") -- Set the text of the button browseBtn:SetWidth(20) -- Set the width of the button browseBtn:Dock(RIGHT) -- Dock the button to the right side of the text entry field -- Function to be called when the browse button is clicked -- Can be a reference or anonymous (like in this case) browseBtn.DoClick = function() -- Code to open a browser for certain file types should go here end </code> <output> <upload src="b4b46/8db9014737538e5.png" size="32408" name="tentry_w_browse.png" /> (For instructions on how to make the file browser, see <page>DFileBrowser</page>) </output> </example> # Undocumented Methods * <page>DTextEntry:AddHistory</page> * <page>DTextEntry:GetDisabled</page> * <page>DTextEntry:GetDrawBackground</page> * <page>DTextEntry:GetDrawBorder</page> * <page>DTextEntry:GetFont</page> * <page>DTextEntry:GetHighlightColor</page> * <page>DTextEntry:GetHistoryEnabled</page> * <page>DTextEntry:GetTabbingDisabled</page> * <page>DTextEntry:SetDrawBackground</page> * <page>DTextEntry:SetDrawBorder</page> * <page>DTextEntry:SetHighlightColor</page> * <page>DTextEntry:SetHistoryEnabled</page>⤶ * <page>DTextEntry:UpdateConvarValue</page>⤶ * <page>DTextEntry:UpdateFromHistory</page> * <page>DTextEntry:UpdateFromMenu</page>