XL98: How to Use the TextColumn Property

ID: Q182695

The information in this article applies to:

SUMMARY

You can use the TextColumn property of the ListBox or ComboBox control to display one set of values to your user in a list, but to return another value based on the selection that the user makes.

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support professionals 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 needs. If you have limited programming experience, you may want to contact the Microsoft fee-based consulting line at (800) 936-5200. For more information about the support options available from Microsoft, please see the following page on the World Wide Web:

   http://www.microsoft.com/support/supportnet/refguide/

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.

REFERENCES

For more information about using the TextColumn property, click the Office Assistant in the Visual Basic Editor, type "textcolumn," click Search, and then click to view "TextColumn Property."

NOTE: If the Assistant is hidden, click the Office Assistant button on the Standard toolbar. If Microsoft Help is not installed on your computer, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q179216
   TITLE     : OFF98: How to Use the Microsoft Office Installer Program

Additional query words: XL98
Keywords          : kbprg kbdta kbdtacode xlvbahowto xlvbainf 
Version           : MACINTOSH:98
Platform          : MACINTOSH
Hardware          : MAC
Issue type        : kbhowto

Last Reviewed: May 18, 1999