XL98: How to Use the TextColumn Property

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements. The following is an example of using the TextColumn and BoundColumn properties to display one set of values in a ListBox while returning another value:

1. Close and save any open workbooks, and then open a new workbook.
2. On Sheet1, enter the following values:

          A1: FTP   B1: File Transfer Protocol
          A2: GIF   B2: Graphics Interchange Format
          A3: HTTP  B3: Hypertext Transfer Protocol
          A4: URL   B4: Uniform Resource Locator
          A5: WWW   B5: World Wide Web
   						

3. Start the Visual Basic Editor (press OPTION+F11).
4. On the Insert menu, click UserForm.
5. Draw a ListBox control on the UserForm.
6. Open the Properties window (press F6).
7. Change the following properties of the ListBox control to the following values:

          Property         Value
          ----------------------
          BoundColumn       2
          TextColumn        1
   						

   Setting the BoundColumn property to a value of 2 indicates that you want to return a value from column 2 in your list. Setting the TextColumn property to a value of 1 means that you are presenting the user with values from the first column of the data that the ListBox is binding to.
8. Draw a Label control on the UserForm.
9. Double-click the UserForm to open the Code window for the UserForm.
10. In the module, type the following code:

           Private Sub UserForm)Initialize
    
             ' Populate the ListBox.
             ListBox1.List = Worksheets("Sheet1").Range("A1:B5").Value
    
           End Sub
    
           Private Sub ListBox1_Click()
    
             Label1.Caption = ListBox1.Value
    
           End Sub
    						

11. Run the UserForm. To do this, activate the UserForm, and then click Run Sub/UserForm on the Run menu.

When you click an item in the list box, the label will change to the current value from column 2 in the list.