• Outlook User
  • New Outlook app
  • Outlook.com
  • Outlook Mac
  • Outlook & iCloud
  • Developer
  • Microsoft 365 Admin
    • Common Problems
    • Microsoft 365
    • Outlook BCM
    • Utilities & Addins

Outlook VBA: Use a Text File to Populate a ListBox

Slipstick Systems

› Developer › Code Samples › Outlook VBA: Use a Text File to Populate a ListBox

Last reviewed on March 23, 2017     11 Comments

This code sample demonstrates how to use the contents of a text file to populate a ListBox. This method can also be used with ComboBoxes and TextBoxes.

The scenario: A client adds keywords to message subjects so it's easier to find the messages later but if he mistypes a keyword he can't find the message. My solution is a macro with a list of keywords to choose from. He selects one or more keywords then clicks OK to add the keyword(s) to the subject.

select one or more keywords from the list

  1. The macro works with either open or selected messages.
  2. If you are using selected messages, the keyword is saved to the subject when you select a different message.

Step 1: Create a test file with the list of keywords, using one keyword per line.
create a list file with a list of keywords

Step 2: Open the VBA Editor using Alt+F11. Right click on Project1 and choose Insert > UserForm to add a UserForm to the VBA project. If the Toolbox isn't visible, go to the View menu and select Toolbox. Drag the edges to resize as needed. Change the Caption in Properties.
add the userform and change the caption

Add a Listbox to the form and drag to resize it. In the Properties screen, find MultiSelect property and change it to allow multiple selections, otherwise you'll only be able to select one entry at a time.
change the multiselect property

Drag the CommandButton control to the Userform. Change the Caption to Ok in Properties.

If you want to open a selected message to type keywords (eg, to add project numbers) add a Checkbox control and change the Caption.

Step 3: Right click on the UserForm, choose View Code then paste the following macro into the code editor. This code assumes the UserForm is named UserForm1, and the control names end with a 1.

Don't forget to update the path to the text file!


Private Sub CheckBox1_Click()
  If CheckBox1 Then
     OpenEdit = "Edit"
   End If
End Sub

Private Sub ListBox1_Click()

End Sub

Private Sub UserForm_Initialize()
  Dim fn As String, ff As Integer, txt As String
    fn = "C:\Users\drcp\Documents\keywords.txt" '< --- .txt file path
    txt = Space(FileLen(fn))
    ff = FreeFile
    Open fn For Binary As #ff
    Get #ff, , txt
    Close #ff

 Dim myArray() As String
  'Use Split function to return a zero based one dimensional array.
  myArray = Split(txt, vbCrLf)
  'Use .List method to populate listbox.
  ListBox1.List = myArray
lbl_Exit:
  Exit Sub

End Sub

Private Sub CommandButton1_Click()

Dim i As Long
Dim lngCount As Long
Dim strPicks As String
  lngCount = 0
  For i = 0 To ListBox1.ListCount - 1
    If ListBox1.Selected(i) = True Then
      lngCount = lngCount + 1
      If lngCount = 1 Then
        strPicks = ListBox1.List(i)
      Else
        strPicks = strPicks & " " & ListBox1.List(i)
      End If
    End If
  Next i

    lstText = strPicks
    Unload Me

lbl_Exit:
  Exit Sub
End Sub

Step 4: Right click on Project1 and choose Insert > Module. Paste the following code in the Module. If desired, you can insert another module and name it Functions then move the function to the Functions module. (Functions can be used by more than one macro.)

Public lstText As String
Public OpenEdit As String
Public MType As String
 
Public Sub SetSubject()
Dim oMail As Outlook.MailItem
 OpenEdit = ""
 
   UserForm1.Show

Set oMail = GetCurrentItem()
oMail.Subject = oMail.Subject & " " & lstText

If MType = "Inspector" Then oMail.Save

If OpenEdit = "Edit" Then
If MType = "Explorer" Then oMail.Display
End If
Set oMail = Nothing
End Sub

Function GetCurrentItem() As Object
    Dim objApp As Outlook.Application
            
    Set objApp = Application
    On Error Resume Next
    Select Case TypeName(objApp.ActiveWindow)
        Case "Explorer"
            Set GetCurrentItem = objApp.ActiveExplorer.Selection.Item(1)
            MType = "Explorer"
        Case "Inspector"
            Set GetCurrentItem = objApp.ActiveInspector.CurrentItem
            MType = "Inspector"
    End Select
        
    Set objApp = Nothing
End Function

Step 5: Create buttons on the ribbon or Quick Access Toolbar in both Outlook's main window and an open message for the SetSubject macro.

  1. Right-click on the ribbon, choose Customize Ribbon.
  2. Add a New Group on the right side.
  3. Select Macros on the left side and adds the SetSubject macro to the new group.

create a button for the macro

To use: Select a message then click the button. Note: If you can type in the subject field in Outlook 2013 or above, click the caret on the right to expand the the header.
edited message header

Video Tutorial

How to use macros

First: You will need macro security set to low during testing.

To check your macro security in Outlook 2010 or 2013, go to File, Options, Trust Center and open Trust Center Settings, and change the Macro Settings. In Outlook 2007 and older, it’s at Tools, Macro Security.

After you test the macro and see that it works, you can either leave macro security set to low or sign the macro.

Open the VBA Editor by pressing Alt+F11 on your keyboard.

To put the code in a module:

  1. Right click on Project1 and choose Insert > Module
  2. Copy and paste the macro into the new module.

More information as well as screenshots are at How to use the VBA Editor

Outlook VBA: Use a Text File to Populate a ListBox was last modified: March 23rd, 2017 by Diane Poremsky

Related Posts:

  • Select from a List of Subjects before Sending a Message
  • Use a macro to Reply with boilerplate text
  • Apply Filtered Views Using a Macro
  • VBA UserForm sample: Select from a list of templates

About Diane Poremsky

A Microsoft Outlook Most Valuable Professional (MVP) since 1999, Diane is the author of several books, including Outlook 2013 Absolute Beginners Book. She also created video training CDs and online training classes for Microsoft Outlook. You can find her helping people online in Outlook Forums as well as in the Microsoft Answers and TechNet forums.

Subscribe
Notify of
11 Comments
newest
oldest most voted
Inline Feedbacks
View all comments

Jacob
February 12, 2023 10:45 am

How I can get the content( from the notepad .txt file ) and paste to the message body where I select while writing email instead of to the Subject field( I use hyperlinks in the notepad ).Appreciate if you can help me .thanks a lot

0
0
Reply
Diane Poremsky
Author
Reply to  Jacob
February 14, 2023 11:34 pm

If you need to paste the hyperlink coded as a hyperlink (href tags) - the easiest might be to have the url and the text comma separated then use word hyperlink coding to insert it.

0
0
Reply
Jacob
Reply to  Diane Poremsky
February 14, 2023 11:43 pm

Thank you for your reply .This code is pasting only to the subject area but I would like to have them pasted in the message body where cursor text is placed ..ie to paste while I draft an email. I changed the code from < oMail.Subject = oMail.Subject & " " & lstText > to < oMail.HTMLBody = lstText & oMail.HTMLBody > but its pasting at the first line of the message body. I have created a new thread for this request in https://forums.slipstick.com/threads/99704-add-keywords-from-listbox-to-the-message-body-where-cursor-is-placed/ Really appreciate if you can help me.

0
0
Reply
saritha
August 10, 2019 3:57 pm

I have Combo box1 and combo box2, based on combo1 then combo2 has to be updated accrodingly. Can you please tell me how it can be achieved.

0
0
Reply
Diane Poremsky
Author
Reply to  saritha
August 11, 2019 12:02 am

You'll need to use VBA.

Private Sub cc_Change()
If cc = "value1" Then
Me.combo2 = "a; b; c"
Else
Me.combo2 = "d;e;f"
End If
End Sub

0
0
Reply
Frank Smith
August 1, 2017 5:22 pm

Got this working, but I am only able to tag/modify one email at a time.. possible to select multiple emails and choose an item from the list?

0
0
Reply
Diane Poremsky
Author
Reply to  Frank Smith
August 2, 2017 12:30 am

The selection macro at https://www.slipstick.com/developer/code-samples/working-items-folder-selected-items/ could be worked into it to apply to one or more selected items.

The macro at https://www.slipstick.com/outlook/email/add-a-file-number-or-keyword-to-the-subject-line-of-messages/ works on selected items - you'd type the keyword in the inputbox though, instead of selecting it, but that could be replaced with the userform from this macro.

0
0
Reply
Matthias
April 14, 2016 10:13 am

Dear Diane,

thanks a lot for your great tutorial.
I managed to make an userform with all my keywords, which is always shown on the screen "UserForm1.Show vbModeless". I can apply any keyword to the category of any selected Outlook item. That helps to keep my inbox cleaned up.
A wish came true: my own little category manager for free.

Regards from Munich/Germany

Matthias

0
0
Reply
Abel
Reply to  Matthias
June 11, 2017 6:21 pm

Hi Diane,
How do I make this macro work for any type of Outlook items: Tasks, Meeting, Notes, Etc.? Thanks in advance for your help

0
0
Reply
Diane Poremsky
Author
Reply to  Abel
June 11, 2017 9:53 pm

Try changing Dim oMail As Outlook.MailItem to Dim oMail As Object. I did a quick look at the code and think that is the only place where it specifically mentions mail item type.

0
0
Reply
Abel
Reply to  Diane Poremsky
June 21, 2017 4:01 pm

Thank you Daine! I really appreciate your help. Besides changing the variable type, as per your suggestion, I had to add another line of code after the task subject definition line:
"oMail.Save" , because the macro was not updating the actual task subject.

0
0
Reply

Visit Slipstick Forums.
What's New at Slipstick.com

Latest EMO: Vol. 30 Issue 29

Subscribe to Exchange Messaging Outlook






Support Services

Do you need help setting up Outlook, moving your email to a new computer, migrating or configuring Office 365, or just need some one-on-one assistance?

Our Sponsors

CompanionLink
ReliefJet
  • Popular
  • Latest
  • Week Month All
  • Jetpack plugin with Stats module needs to be enabled.
  • Move Deleted Items to Another Folder Automatically
  • Open Outlook Templates using PowerShell
  • Count and List Folders in Classic Outlook
  • Google Workspace and Outlook with POP Mail
  • Import EML Files into New Outlook
  • Opening PST files in New Outlook
  • New Outlook: Show To, CC, BCC in Replies
  • Insert Word Document into Email using VBA
  • Delete Empty Folders using PowerShell
  • Warn Before Deleting a Contact
Ajax spinner

Recent Bugs List

Microsoft keeps a running list of issues affecting recently released updates at Fixes or workarounds for recent issues in classic Outlook (Windows).

For new Outlook for Windows: Fixes or workarounds for recent issues in new Outlook for Windows .

Outlook for Mac Recent issues: Fixes or workarounds for recent issues in Outlook for Mac

Outlook.com Recent issues: Fixes or workarounds for recent issues on Outlook.com

Office Update History

Update history for supported Office versions is at Update history for Office

Outlook Suggestions and Feedback

Outlook Feedback covers Outlook as an email client, including Outlook Android, iOS, Mac, and Windows clients, as well as the browser extension (PWA) and Outlook on the web.

Outlook (new) Feedback. Use this for feedback and suggestions for Outlook (new).

Use Outlook.com Feedback for suggestions or feedback about Outlook.com accounts.

Other Microsoft 365 applications and services




New Outlook Articles

Move Deleted Items to Another Folder Automatically

Open Outlook Templates using PowerShell

Count and List Folders in Classic Outlook

Google Workspace and Outlook with POP Mail

Import EML Files into New Outlook

Opening PST files in New Outlook

New Outlook: Show To, CC, BCC in Replies

Insert Word Document into Email using VBA

Delete Empty Folders using PowerShell

Warn Before Deleting a Contact

Newest Code Samples

Open Outlook Templates using PowerShell

Count and List Folders in Classic Outlook

Insert Word Document into Email using VBA

Warn Before Deleting a Contact

Use PowerShell to Delete Attachments

Remove RE:, FWD:, and Other Prefixes from Subject Line

Change the Mailing Address Using PowerShell

Categorize @Mentioned Messages

Send an Email When You Open Outlook

Delete Old Calendar Events using VBA

VBA Basics

How to use the VBA Editor

Work with open item or selected item

Working with All Items in a Folder or Selected Items

VBA and non-default Outlook Folders

Backup and save your Outlook VBA macros

Get text using Left, Right, Mid, Len, InStr

Using Arrays in Outlook macros

Use RegEx to extract message text

Paste clipboard contents

Windows Folder Picker

Custom Forms

Designing Microsoft Outlook Forms

Set a custom form as default

Developer Resources

Developer Resources

Developer Tools

VBOffice.net samples

SlovakTech.com

Outlook MVP David Lee

Repair PST

Convert an OST to PST

Repair damaged PST file

Repair large PST File

Remove password from PST

Merge Two Data Files

Sync & Share Outlook Data

  • Share Calendar & Contacts
  • Synchronize two computers
  • Sync Calendar and Contacts Using Outlook.com
  • Sync Outlook & Android Devices
  • Sync Google Calendar with Outlook
  • Access Folders in Other Users Mailboxes

Diane Poremsky [Outlook MVP]

Make a donation

Mail Tools

Sending and Retrieval Tools

Mass Mail Tools

Compose Tools

Duplicate Remover Tools

Mail Tools for Outlook

Online Services

Calendar Tools

Schedule Management

Calendar Printing Tools

Calendar Reminder Tools

Calendar Dates & Data

Time and Billing Tools

Meeting Productivity Tools

Duplicate Remover Tools

Productivity

Productivity Tools

Automatic Message Processing Tools

Special Function Automatic Processing Tools

Housekeeping and Message Management

Task Tools

Project and Business Management Tools

Choosing the Folder to Save a Sent Message In

Run Rules on messages after reading

Help & Suggestions

Submit Outlook Feature Requests

Slipstick Support Services

Buy Microsoft 365 Office Software and Services

Visit Slipstick Forums.

What's New at Slipstick.com

Home | Outlook User | Exchange Administrator | Office 365 | Outlook.com | Outlook Developer
Outlook for Mac | Common Problems | Utilities & Addins | Tutorials
Outlook & iCloud Issues | Outlook Apps
EMO Archives | About Slipstick | Slipstick Forums
Submit New or Updated Outlook and Exchange Server Utilities

Send comments using our Feedback page
Copyright © 2025 Slipstick Systems. All rights reserved.
Slipstick Systems is not affiliated with Microsoft Corporation.

:wpds_smile::wpds_grin::wpds_wink::wpds_mrgreen::wpds_neutral::wpds_twisted::wpds_arrow::wpds_shock::wpds_unamused::wpds_cool::wpds_evil::wpds_oops::wpds_razz::wpds_roll::wpds_cry::wpds_eek::wpds_lol::wpds_mad::wpds_sad::wpds_exclamation::wpds_question::wpds_idea::wpds_hmm::wpds_beg::wpds_whew::wpds_chuckle::wpds_silly::wpds_envy::wpds_shutmouth:
wpDiscuz

Sign up for Exchange Messaging Outlook

Our weekly Outlook & Exchange newsletter (bi-weekly during the summer)






Please note: If you subscribed to Exchange Messaging Outlook before August 2019, please re-subscribe.

Never see this message again.

You are going to send email to

Move Comment