Click here to Skip to main content
15,892,746 members
Articles / Programming Languages / C#
Tip/Trick

TextBox with Placeholder

Rate me:
Please Sign up or sign in to vote.
4.85/5 (38 votes)
2 May 2018CPOL2 min read 177.5K   13.9K   59   38
Extended TextBox with placeholder

Introduction

In many cases, a TextBox with an easy Placeholder property would be very helpful especially when you want the user to filter a ListView or ListBox by search terms.

So, I never found a really good one. I know there exists a very easy method with only one SendMessage method, but I don't like it because the placeholder is hard to differentiate with the actually typed text and I don't like these message things very much, too many things can go wrong.

Now I created my own control and my destination is that it is very easy to use.

Using the Code

Add the PlaceholderTextBox.cs to your project and build it. You can add it with the designer now.

The difference to the usual TextBox is it that there are three new properties:

  • PlaceholderText: It's not hard to guess what this property does. It defines the Placeholder text which will get displayed if the TextBox is empty.
  • IsPlaceholderActive: Through this property, you can always check if the textbox shows the placeholder or real text at the moment.

PlaceholderText is accessible with the designer, IsPlaceholderActive is not!

Besides, there is the new method Reset(). This will return the TextBox to the start state.

The Text property is not accessible with the designer. That's to keep the standard. The placeholder should always be seen before you type any text in the TextBox.

Points of Interest

It's a very well written code. I recommend you read it, there are many comments and maybe you have a suggestion.

I hope you like my control and when you have any suggestions or have found a bug, please let me know!

History

v1.6

  • "Select all" in Windows default context menu does not select the placeholder anymore
  • TextLength returns 0 if placeholder is active
  • Minor code improvements

v1.5

  • Fixed behavior with pressing Ctrl+A while placeholder is active
  • MaxLength working now
  • Fixed crashes if setting Text programmatically

v1.4

v1.3

  • Fixed bug: Font can be changed now - Thanks to Member 11133660
  • Improved internal logic
  • Removed IsItalics
  • Renamed PlaceholderInsideChanged to PlaceholderActiveChanged

v1.2

  • Improved internal logic
  • Removed sealed
  • Added Placeholder category to designer for better overview
  • Fixed some comments

v1.1

  • Added PlaceholderInsideChanged event
  • Fixed bug that new MouseDownEvents never occur
  • Prevents user to go through placeholder with arrow keys

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Germany Germany
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
Questionbug 2 Pin
Member 1241201717-Jun-17 9:44
Member 1241201717-Jun-17 9:44 
AnswerRe: bug 2 Pin
Andiiiii15-Feb-18 5:07
Andiiiii15-Feb-18 5:07 
Questionbug Pin
Member 1241201717-Jun-17 0:47
Member 1241201717-Jun-17 0:47 
QuestionOther Objects... like MaskedEditBox and Combobox. Pin
Eagles_Power24-Jan-17 2:45
Eagles_Power24-Jan-17 2:45 
GeneralMy vote of 5 Pin
Maxwolf Goodliffe12-Dec-14 7:08
Maxwolf Goodliffe12-Dec-14 7:08 
QuestionDownload demo project link is broken Pin
Member 1125706523-Nov-14 3:26
Member 1125706523-Nov-14 3:26 
BugCustom Font is not applied Pin
Member 111336606-Oct-14 12:55
Member 111336606-Oct-14 12:55 
GeneralRe: Custom Font is not applied Pin
Andiiiii7-Oct-14 3:25
Andiiiii7-Oct-14 3:25 
I just pushed an update. Thanks for your report.
GeneralPlease show and explain the code Pin
PIEBALDconsult4-Sep-13 18:38
mvePIEBALDconsult4-Sep-13 18:38 
Question[My vote of 1] Win Form now? Pin
David Furshpan4-Sep-13 13:30
David Furshpan4-Sep-13 13:30 
AnswerRe: [My vote of 1] Win Form now? PinPopular
Andiiiii6-Sep-13 2:23
Andiiiii6-Sep-13 2:23 
AnswerRe: [My vote of 1] Win Form now? Pin
FernandoUY6-Sep-13 8:08
professionalFernandoUY6-Sep-13 8:08 
GeneralMy vote of 5 Pin
Meng FanRui3-Sep-13 23:51
Meng FanRui3-Sep-13 23:51 
GeneralMy vote of 2 Pin
FernandoUY2-Sep-13 14:09
professionalFernandoUY2-Sep-13 14:09 
GeneralRe: My vote of 2 Pin
Andiiiii6-Sep-13 2:22
Andiiiii6-Sep-13 2:22 
GeneralRe: My vote of 2 Pin
FernandoUY6-Sep-13 8:05
professionalFernandoUY6-Sep-13 8:05 
QuestionNot an article Pin
OriginalGriff16-May-13 2:29
mveOriginalGriff16-May-13 2:29 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.