XL98: Returning Values from a Multi-Column ListBox

ID: Q182694

The information in this article applies to:

SUMMARY

You can display more than one column of data in a ListBox control on a UserForm. However, when you select an item from the list, only the value from the column that you are binding to is returned. This article provides an example of how to return multiple values from a ListBox that displays three columns of data.

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/

  1. Save and close any open workbooks, and then open a new workbook.

  2. On Sheet1, enter the following values:

       A1: 1996  B1: February  C1: 23
       A2: 1997  B2: March     C2: 18
       A3: 1998  B4: September C3: 7
       A4: 1999  B4: November  C4: 3

  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       1
       ColumnCount       3

  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:C4")
        End Sub

        Private Sub ListBox1_Change()
          Dim SourceData As Range
          Dim Val1 As String, Val2 As String, Val3 As String

          ' Get Range that the ListBox is bound to.
          Set SourceRange = Worksheets("Sheet1").Range("A1:C4")

          Val1 = ListBox1.Value
          ' Get the value of the second column.
          Val2 = SourceRange.Offset(ListBox1.ListIndex, 1).Resize(1, _
             1).Value
          ' Get the value of the third column.
          Val3 = SourceRange.Offset(ListBox1.ListIndex, 2).Resize(1, _
             1).Value

          ' Concatenate the three values together and display them in
          ' Label1.
          Label1.Caption = Val1 & " " & Val2 & " " & Val3
        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 entry in the list box, the label will change to reflect all three of the columns in that entry.

REFERENCES

For more information about using the ListBox control, click the Office Assistant in the Visual Basic Editor, type "listbox control," (without the quotation marks), click Search, and then click to view "ListBox Control."

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