VbaProject class

VbaProject class

Provides access to VBA project information. A VBA project inside the document is defined as a collection of VBA modules. To learn more, visit the Working with VBA Macros documentation article.

Constructors

NameDescription
VbaProject()Creates a blank VbaProject.

Properties

NameDescription
code_pageGets or sets the VBA project’s code page.
is_protectedShows whether the VbaProject is password protected.
is_signedShows whether the VbaProject is signed or not.
modulesReturns collection of VBA project modules.
nameGets or sets VBA project name.
referencesGets a collection of VBA project references.

Methods

NameDescription
clone()Performs a copy of the VbaProject.

Examples

Shows how to access a document’s VBA project information.

doc = aw.Document(MY_DIR + 'VBA project.docm')
# A VBA project contains a collection of VBA modules.
vba_project = doc.vba_project
if vba_project.is_signed:
    print(f'Project name: {vba_project.name} signed; Project code page: {vba_project.code_page}; Modules count: {vba_project.modules.count}\n')
else:
    print(f'Project name: {vba_project.name} not signed; Project code page: {vba_project.code_page}; Modules count: {vba_project.modules.count}\n')
vba_modules = doc.vba_project.modules
self.assertEqual(vba_modules.count, 3)
for module in vba_modules:
    print(f'Module name: {module.name};\nModule code:\n{module.source_code}\n')
# Set new source code for VBA module. You can access VBA modules in the collection either by index or by name.
vba_modules[0].source_code = 'Your VBA code...'
vba_modules.get_by_name('Module1').source_code = 'Your VBA code...'
# Remove a module from the collection.
vba_modules.remove(vba_modules[2])

See Also