Edit

Share via


_Application Interface

Definition

This is a primary interface in a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this primary interface only when the method you want to use shares the same name as an event of the COM object; in this case, cast to this interface to call the method, and cast to the latest events interface to connect to the event. Otherwise, use the .NET interface that is derived from the COM coclass to access methods, properties, and events of the COM object. For information about the COM object, see Application.

public interface class _Application
[System.Runtime.InteropServices.Guid("00020970-0000-0000-C000-000000000046")]
public interface _Application
type _Application = interface
Public Interface _Application
Derived
Attributes

Properties

ActiveDocument

Returns a Document object that represents the active document.

ActiveEncryptionSession

Returns a Integer that represents the encryption session associated with the active document. Read-only.

ActivePrinter

Returns or sets the name of the active printer.

ActiveProtectedViewWindow

Gets a ProtectedViewWindow object that represents the active protected view window.

ActiveWindow

Returns a Window object that represents the active window.

AddIns

Returns a AddIns collection that represents all available add-ins, regardless of whether they're currently loaded.

AnswerWizard

Returns a AnswerWizard object that contains the files used by the online Help search engine.

Application

Returns a Application object that represents the Microsoft Word application.

ArbitraryXMLSupportAvailable

Returns a Boolean that represents whether Microsoft Word accepts custom XML schemas. Returns True if Word accepts custom XML schemas, or False if schemas are not accepted.

Assistance

Returns an Microsoft.Office.Core.IAssistance object that represents the Microsoft Office Help Viewer. Read-only.

Assistant

Returns a Assistant object that represents the Microsoft Office Assistant.

AutoCaptions

Returns a AutoCaptions collection that represents the captions that are automatically added when items such as tables and pictures are inserted into a document.

AutoCorrect

Returns a AutoCorrect object that contains the current AutoCorrect options, entries, and exceptions.

AutoCorrectEmail

Returns a AutoCorrect object that represents automatic corrections made to e-mail messages.

AutomationSecurity

Returns or sets a MsoAutomationSecurity constant that represents the security setting Microsoft Word uses when programmatically opening files.

BackgroundPrintingStatus

Returns the number of print jobs in the background printing queue.

BackgroundSavingStatus

Returns the number of files queued up to be saved in the background.

Bibliography

Returns a Bibliography object that represents the bibliography references sources stored in Microsoft Office Word. Read-only.

BrowseExtraFileTypes

Set this property to "text/html" to allow hyperlinked HTML files to be opened in Microsoft Word (instead of the default Internet browser).

Browser

Returns a Browser object that represents the Select Browse Object tool on the vertical scroll bar.

Build

Returns the version and build number of the Word application.

BuildFeatureCrew

Reserved for internal use.

BuildFull

Reserved for internal use.

CapsLock

Determines if the CAPS LOCK key is turned on. Returns True if the CAPS LOCK key is turned on, and False if it is not.

Caption

Returns or sets the caption text for the specified document or application window.

CaptionLabels

Returns a CaptionLabels collection that represents all the available caption labels.

ChartDataPointTrack

Returns or sets a Boolean (bool in C#) that specifies whether charts use cell-reference data-point tracking. Read-write.

CheckLanguage

Determines if Microsoft Word automatically detects the language you are using as you type. Returns True if Microsoft Word automatically detects the language you are using as you type, and False if it does not automatically detect the language.

COMAddIns

Returns a reference to the COMAddIns collection that represents all the Component Object Model (COM) add-ins currently loaded in Microsoft Word.

CommandBars

Returns a CommandBars collection that represents the menu bar and all the toolbars in Microsoft Word.

Creator

Returns a 32-bit integer that indicates the application in which the specified object was created.

CustomDictionaries

Returns a Dictionaries object that represents the collection of active custom dictionaries. Active custom dictionaries are marked with a check in the Custom Dictionariesdialog box.

CustomizationContext

Returns or sets a Template or Document object that represents the template or document in which changes to menu bars, toolbars, and key bindings are stored.

DefaultLegalBlackline

Determines if Microsoft Word will compare and merge documents using the Legal blackline option in the Compare and Merge Documents dialog box. Returns True if Word will use the option, and False if not.

DefaultSaveFormat

Returns or sets the default format that will appear in the Save as type box in the Save As dialog box (File menu).

DefaultTableSeparator

Returns or sets the single character used to separate text into cells when text is converted to a table.

Dialogs

Returns a Dialogs collection that represents all the built-in dialog boxes in Microsoft Word.

DisplayAlerts

Returns or sets the way certain alerts and messages are handled while a macro is running.

DisplayAutoCompleteTips

Determines if Microsoft Word displays tips that suggest text for completing words, dates, or phrases as you type.

DisplayDocumentInformationPanel

Returns or sets a Boolean that represents whether the document properties panel is displayed. Read/write.

DisplayRecentFiles

Determines if the names of recently used files are displayed on the File menu.

DisplayScreenTips

Determines if comments, footnotes, endnotes, and hyperlinks are displayed as tips. Text marked as having comments is highlighted.

DisplayScrollBars

Determines if Word displays a scroll bar in at least one document window.

DisplayStatusBar

Determines if the status bar is displayed.

Documents

Returns a Documents collection that represents all the open documents.

DontResetInsertionPointProperties

Returns or sets a Boolean that represents whether Microsoft Office Word maintains the formatting properties of the text at that position of the Insertion Point after running other code. Read/write.

Dummy1

Reserved for internal use.

EmailOptions

Returns an EmailOptions object that represents the global preferences for e-mail authoring.

EmailTemplate

Returns or sets a String that represents the document template to use when sending e-mail messages.

EnableCancelKey

Returns or sets the way that Word handles CTRL+BREAK user interruptions.

FeatureInstall

Returns or sets how Microsoft Word handles calls to methods and properties that require features not yet installed.

FileConverters

Returns a FileConverters collection that represents all the file converters available to Microsoft Word.

FileDialog[MsoFileDialogType]

Returns a FileDialog object which represents a single instance of a file dialog box.

FileSearch

Returns a FileSearch object that can be used to search for files using either an absolute or relative path.

FileValidation

Gets or sets how Word will validate files before opening them.

FindKey[Int32, Object]

Returns a KeyBindings object that represents the specified key combination.

FocusInMailHeader

Determines if the insertion point is in an e-mail header field.

FontNames

Returns a FontNames object that includes the names of all the available fonts.

HangulHanjaDictionaries

Returns a HangulHanjaConversionDictionaries collection that represents all the active custom conversion dictionaries.

Height

Returns or sets the height of the active document window.

International[WdInternationalIndex]

Returns information about the current country/region and international settings.

IsObjectValid[Object]

Determines if the specified variable that references an object is valid.

IsSandboxed

Gets whether the application window is a protected view window.

KeyBindings

Returns a KeyBindings collection that represents customized key assignments, which include a key code, a key category, and a command.

KeysBoundTo[WdKeyCategory, String, Object]

Returns a KeysBoundTo object that represents all the key combinations assigned to the specified item.

LandscapeFontNames

Returns a FontNames object that includes the names of all the available landscape fonts.

Language

Returns an MsoLanguageID constant that represents the language selected for the Microsoft Word user interface.

Languages

Returns a Languages collection that represents the proofing languages listed in the Language dialog box.

LanguageSettings

Returns a LanguageSettings object, which contains information about the language settings in Microsoft Word.

Left

Returns or sets an Integer that represents the horizontal position of the active document (for the Application object) or the specified task or window, measured in points.

ListGalleries

Returns a ListGalleries collection that represents the three list template galleries (Bulleted, Numbered, and Outline Numbered).

MacroContainer

Returns a Template or Document object that represents the template or document in which the module that contains the running procedure is stored.

MailingLabel

Returns a MailingLabel object that represents a mailing label.

MailMessage

Returns a MailMessage object that represents the active e-mail message.

MailSystem

Returns the mail system (or systems) installed on the host machine.

MAPIAvailable

Determines if MAPI is installed. This property returns True if MAPI is installed, and False if not.

MathCoprocessorAvailable

Determines if a math coprocessor is installed and available to Microsoft Word. This property returns True if a math coprocessor is installed and available to Microsoft Word, and False if not.

MouseAvailable

Determines if there's a mouse available for the system. This property returns True if there's a mouse available for the system, and False if not.

Name

Returns or sets the name of the specified object.

NewDocument

Returns a NewFile object that represents a document listed on the New Document task pane.

NormalTemplate

Returns a Template object that represents the Normal template.

NumLock

Returns the state of the NUM LOCK key. Returns True if the keys on the numeric keypad insert numbers, and False if the keys move the insertion point.

OMathAutoCorrect

Returns the auto correct entries for equations. Read-only.

OpenAttachmentsInFullScreen

Returns or sets a Boolean that represents whether Microsoft Office Word opens e-mail attachments in Reading mode. Read/write.

Options

Returns an Options object that represents application settings in Microsoft Word.

Parent

Returns an object that represents the parent object of the specified object.

Path

Returns the disk or Web path to the specified object.

PathSeparator

Returns the character used to separate folder names.

PickerDialog

Gets a PickerDialog object that provides the functionality to select people or data in a dialog box.

PortraitFontNames

Returns a FontNames object that includes the names of all the available portrait fonts.

PrintPreview

Determines if print preview is the current view. This property returns True if print preview is the current view, and False if not.

ProtectedViewWindows

Gets a ProtectedViewWindows collection that represents all protected view windows.

RecentFiles

Returns a RecentFiles collection that represents the most recently accessed files.

RestrictLinkedStyles

Returns or sets a Boolean that represents whether Microsoft Office Word allows linked styles. Read/write.

ScreenUpdating

Determines if screen updating is turned on. Returns True if screen updating is turned on, and False if not.

Selection

Returns the Selection object that represents a selected range or the insertion point.

ShowAnimation

This object, member, or enumeration is deprecated and is not intended to be used in your code.

ShowStartupDialog

Determines if the Task Pane will be displayed when starting Microsoft Word.

ShowStylePreviews

Returns or sets a Boolean that represents whether Microsoft Office Word shows a preview of the formatting for styles in the Styles dialog box. Read/write.

ShowVisualBasicEditor

Determines if the Visual Basic Editor window is visible. This property returns True if the Visual Basic Editor window is visible, and False if not.

ShowWindowsInTaskbar

This object, member, or enumeration is deprecated and is not intended to be used in your code.

SmartArtColors

Gets a SmartArtColors object that represents the set of color styles that are currently loaded in the application.

SmartArtLayouts

Gets a SmartArtLayouts object that represents the set of SmartArt layouts that are currently loaded in the application.

SmartArtQuickStyles

Gets a SmartArtQuickStyles object that represents the set of SmartArt styles that are currently loaded in the application.

SmartTagRecognizers

Returns a SmartTagRecognizers collection for an application.

SmartTagTypes

Returns a SmartTagTypes collection that represents the smart tag types for the smart tag components installed in Microsoft Word.

SpecialMode

Determines if Microsoft Word is in a special mode (for example, CopyText mode or MoveText mode).

StartupPath

Returns or sets the complete path of the startup folder, excluding the final separator.

StatusBar

Displays the specified text in the status bar.

SynonymInfo[String, Object]

Returns a SynonymInfo object that contains information from the thesaurus on synonyms, antonyms, or related words and expressions for the specified word or phrase.

System

Returns a System object, which can be used to return system-related information and perform system-related tasks.

TaskPanes

Returns a TaskPanes object that represents the most commonly performed tasks in Microsoft Word.

Tasks

Returns a Tasks collection that represents all the applications that are running.

Templates

Returns a Templates collection that represents all the available templates — global templates as well as those attached to open documents.

Top

Returns or sets the vertical position of the active document, in points.

UndoRecord

Gets an UndoRecord object that provides a custom entry point into the undo stack.

UsableHeight

Returns the maximum height (in points) to which you can set the height of a Microsoft Word document window.

UsableWidth

Returns the maximum width (in points) to which you can set the width of a Microsoft Word document window.

UserAddress

Returns or sets the user's mailing address.

UserControl

Determines if the document or application was created or opened by the user.

UserInitials

Returns or sets the user's initials, which Microsoft Word uses to construct comment marks.

UserName

Returns or sets the user's name, which is used on envelopes and for the Author document property.

VBE

Returns a VBE object that represents the Visual Basic Editor.

Version

Returns the Microsoft Word version number.

Visible

Determines if the specified object is visible. This property returns True if the specified object is visible, and False if not.

Width

Returns or sets the width of the specified object, in points.

Windows

Returns a Windows collection that represents all document windows.

WindowState

Returns or sets the state of the specified document window or task window.

WordBasic

Returns an automation object (Word.Basic) that includes methods for all the WordBasic statements and functions available in Microsoft Word version 6.0 and Word for Windows 95.

XMLNamespaces

Returns an XMLNamespaces collection that represents the XML schemas in the Schema Library.

Methods

Activate()

Activates the specified object.

AddAddress(Array, Array)

Adds an entry to the address book.

AutomaticChange()

Performs an AutoFormat action when there's a change suggested by the Office Assistant.

BuildKeyCode(WdKey, Object, Object, Object)

Returns a unique number for the specified key combination.

CentimetersToPoints(Single)

Converts a measurement from centimeters to points (1 cm = 28.35 points).

ChangeFileOpenDirectory(String)

Sets the folder in which Microsoft Word searches for documents.

CheckGrammar(String)

Checks a string for grammatical errors.

CheckSpelling(String, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Checks a string for spelling errors.

CleanString(String)

Removes nonprinting characters (character codes 1 – 29) and special Microsoft Word characters from the specified string or changes them to spaces (character code 32).

CompareDocuments(Document, Document, WdCompareDestination, WdGranularity, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, String, Boolean)

Compares two documents and returns a _Document object that represents the document that contains the differences between the two documents, marked using tracked changes.

DDEExecute(Int32, String)

Sends a command or series of commands to an application through the specified dynamic data exchange (DDE) channel.

DDEInitiate(String, String)

Opens a dynamic data exchange (DDE) channel to another application, and returns the channel number.

DDEPoke(Int32, String, String)

Uses an open dynamic data exchange (DDE) channel to send data to an application.

DDERequest(Int32, String)

Uses an open dynamic data exchange (DDE) channel to request information from the receiving application, and returns the information as a string.

DDETerminate(Int32)

Closes the specified dynamic data exchange (DDE) channel to another application.

DDETerminateAll()

Closes all dynamic data exchange (DDE) channels opened by Microsoft Word.

DefaultWebOptions()

Returns the DefaultWebOptions object that contains global application-level attributes used by Microsoft Word whenever you save a document as a Web page or open a Web page.

DiscussionSupport(Object, Object, Object)

Reserved for internal use.

Dummy2()

Reserved for internal use.

Dummy4()

Reserved for internal use.

GetAddress(Object, Object, Object, Object, Object, Object, Object, Object)

Returns an address from the default address book.

GetDefaultTheme(WdDocumentMedium)

Returns a String that represents the name of the default theme plus the theme formatting options Microsoft Word uses for new documents, e-mail messages, or Web pages.

GetSpellingSuggestions(String, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Returns a SpellingSuggestions collection that represents the words suggested as spelling replacements for a given word.

GoBack()

Moves the insertion point among the last three locations where editing occurred in the active document.

GoForward()

Moves the insertion point forward among the last three locations where editing occurred in the active document.

Help(Object)

Displays on-line Help information.

HelpTool()

Changes the pointer from an arrow to a question mark, indicating that you'll get context-sensitive Help information about the next command or screen element you click.

InchesToPoints(Single)

Converts a measurement from inches to points (1 inch = 72 points).

Keyboard(Int32)

Returns or sets the keyboard language and layout settings.

KeyboardBidi()

Sets the keyboard language to a right-to-left language and the text entry direction to right-to-left.

KeyboardLatin()

Sets the keyboard language to a left-to-right language and the text entry direction to left-to-right.

KeyString(Int32, Object)

Returns the key combination string for the specified keys (for example, CTRL+SHIFT+A).

LinesToPoints(Single)

Converts a measurement from lines to points (1 line = 12 points).

ListCommands(Boolean)

Creates a new document and then inserts a table of Microsoft Word commands along with their associated shortcut keys and menu assignments.

LoadMasterList(String)

Loads a bibliography source file.

LookupNameProperties(String)

Looks up a name in the global address book list and displays the Properties dialog box, which includes information about the specified name.

MergeDocuments(Document, Document, WdCompareDestination, WdGranularity, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, Boolean, String, String, WdMergeFormatFrom)

Compares two documents and returns a _Document object that represents the document that contains the differences between the two documents, marked using tracked changes.

MillimetersToPoints(Single)

Converts a measurement from millimeters to points (1 mm = 2.85 points).

MountVolume(String, String, String, Object, Object, Object)

This member is for Macintosh only and should not be used.

Move(Int32, Int32)

Positions a task window or the active document window.

NewWindow()

Opens a new window with the same document as the specified window.

NextLetter()

This member is for Macintosh only and should not be used.

OnTime(Object, String, Object)

Starts a background timer that runs a macro at a specified time.

OrganizerCopy(String, String, String, WdOrganizerObject)

Copies the specified AutoText entry, toolbar, style, or macro project item from the source document or template to the destination document or template.

OrganizerDelete(String, String, WdOrganizerObject)

Deletes the specified style, AutoText entry, toolbar, or macro project item from a document or template.

OrganizerRename(String, String, String, WdOrganizerObject)

Renames the specified style, AutoText entry, toolbar, or macro project item in a document or template.

PicasToPoints(Single)

Converts a measurement from picas to points (1 pica = 12 points).

PixelsToPoints(Single, Object)

Converts a measurement from pixels to points.

PointsToCentimeters(Single)

Converts a measurement from points to centimeters (1 centimeter = 28.35 points).

PointsToInches(Single)

Converts a measurement from points to inches (1 inch = 72 points).

PointsToLines(Single)

Converts a measurement from points to lines (1 line = 12 points).

PointsToMillimeters(Single)

Converts a measurement from points to millimeters (1 millimeter = 2.835 points).

PointsToPicas(Single)

Converts a measurement from points to picas (1 pica = 12 points).

PointsToPixels(Single, Object)

Converts a measurement from points to pixels.

PrintOut(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Prints all or part of the specified document.

PrintOut2000(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Reserved for internal use.

PrintOutOld(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Reserved for internal use.

ProductCode()

Returns the Microsoft Word globally unique identifier (GUID) as a String.

PutFocusInMailHeader()

Places the insertion point in the To line of the mail header if the document in the active window is an e-mail document.

Quit(Object, Object, Object)

Quits Microsoft Word and optionally saves or routes the open documents.

Repeat(Object)

Repeats the most recent editing action one or more times.

ResetIgnoreAll()

Clears the list of words that were previously ignored during a spelling check.

Resize(Int32, Int32)

Sizes the Microsoft Word application window or the specified task window.

Run(String, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Runs a Visual Basic macro.

RunOld(String)

Reserved for internal use.

ScreenRefresh()

Updates the display on the monitor with the current information in the video memory buffer.

SendFax()

Starts the Fax Wizard.

SetDefaultTheme(String, WdDocumentMedium)

Sets a default theme for Microsoft Word to use with new documents, e-mail messages, or Web pages.

ShowClipboard()

Displays the Clipboard task pane.

ShowMe()

Displays the Office Assistant or the Help window when there's more information available.

SubstituteFont(String, String)

Sets font-mapping options, which are reflected in theFont Substitution dialog box (Compatibility tab, Options dialog box, Tools menu).

ThreeWayMerge(Document, Document, Document, Boolean)

Reserved for internal use.

ToggleKeyboard()

Switches the keyboard language setting between right-to-left and left-to-right languages.

Applies to