Application.RefreshTitleBar Method

Access Developer Reference

The RefreshTitleBar method refreshes the Microsoft Access title bar after the AppTitle or AppIcon property has been set in Visual Basic.



expression A variable that represents an Application object.

Return Value


For example, you can change the caption in the Microsoft Access title bar to "Contacts Database" by setting the AppTitle property.

The AppTitle and AppIcon properties enable you to customize your application by changing the title and icon that appear in the Microsoft Access title bar. The title bar is not automatically updated after you have set these properties. In order for the change to the title bar to appear, you must use the RefreshTitleBar method.

Bb238069.vs_note(en-us,office.12).gif Note
In a Microsoft Access database, you can reset the AppTitle and AppIcon properties to their default value by deleting them from the Properties collection representing the current database. After you delete these properties, you must use the RefreshTitleBar method to restore the Microsoft Access defaults to the title bar.

It the path to the icon specified by the AppIcon property is invalid, then no changes will be refled in the title bar when you call this method.


The following example sets the AppTitle property of the current database and applies the RefreshTitleBar method to update the title bar.

Visual Basic for Applications
  Sub ChangeTitle()
    Dim obj As Object
    Const conPropNotFoundError = 3270

    On Error GoTo ErrorHandler
    ' Return Database object variable pointing to
    ' the current database.
    Set dbs = CurrentDb
    ' Change title bar.
    dbs.Properties!AppTitle = "Contacts Database"
    ' Update title bar on screen.
    Exit Sub

    If Err.Number = conPropNotFoundError Then
        Set obj = dbs.CreateProperty("AppTitle", dbText, "Contacts Database")
        dbs.Properties.Append obj
        MsgBox "Error: " & Err.Number & vbCrLf & Err.Description
    End If
    Resume Next
End Sub