DocumentBase.ApplyTheme(String) Method

Reference

Definition

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Applies a theme to a document, if the document is open.

public:
 void ApplyTheme(System::String ^ name);

public void ApplyTheme (string name);

member this.ApplyTheme : string -> unit

Public Sub ApplyTheme (name As String)

Parameters

name: String

The name of the theme plus any theme formatting options you want to apply.

Examples

The following code example uses the ApplyTheme method to apply the "Afternoon 011" theme to the current document. To use this example, run it from the ThisDocument class in a document-level project.

private void DocumentApplyTheme()
{
    this.ApplyTheme("AFTRNOON 011");
}

Private Sub DocumentApplyTheme()
    Me.ApplyTheme("AFTRNOON 011")
End Sub

Remarks

The format of the name string is "theme nnn" where theme and nnn are defined as follows:

theme – The name of the folder that contains the data for the requested theme. (The default location for theme data folders is C:\Program Files\Common Files\Microsoft Shared\Themes11.) You must use the folder name for the theme rather than the display name that appears in the Theme dialog box.

nnn – A three-digit string that indicates which theme formatting options to activate (1 to activate, 0 to deactivate). The digits correspond to the Vivid Colors, Active Graphics, and Background Image check boxes in the Theme dialog box. If this string is omitted, the default value for nnn is "011" (Active Graphics and Background Image are activated).

Applies to

Share via