New Members and Constants (Word)

New Members

The following properties, methods, and events have been added to existing objects in Microsoft Word 2010.

Application

Properties

Description

ActiveProtectedViewWindow

Returns a ProtectedViewWindow object that represents the active protected view window. Read-only.

FileValidation

Returns or sets how Word will validate files before opening them. Read/write MsoFileValidationMode.

IsSandboxed

True if the application window is a protected view window. Read-only.

PickerDialog

Returns a PickerDialog object that provides the functionality to select people or data in a dialog box. Read-only.

ProtectedViewWindows

Returns a ProtectedViewWindows collection that represents all protected view windows. Read-only.

SmartArtColors

Returns a SmartArtColors object that represents the set of color styles that are currently loaded in the application. Read-only.

SmartArtLayouts

Returns a SmartArtLayouts object that represents the set of SmartArt layouts that are currently loaded in the application. Read-only.

SmartArtQuickStyles

Returns a SmartArtQuickStyles object that represents the set of SmartArt styles that are currently loaded in the application. Read-only.

UndoRecord

Returns an UndoRecord object that provides a custom entry point into the undo stack. Read-only.

Events

Description

ProtectedViewWindowActivate

Occurs when any protected view window is activated.

ProtectedViewWindowBeforeClose

Occurs immediately before a protected view window or a document in a protected view window closes.

ProtectedViewWindowBeforeEdit

Occurs immediately before editing is enabled on the document in the specified protected view window.

ProtectedViewWindowDeactivate

Occurs when a protected view window is deactivated.

ProtectedViewWindowOpen

Occurs when a protected view window is opened.

ProtectedViewWindowSize

Occurs when the protected view window is resized or moved.

ColorFormat

Properties

Description

Brightness

Returns a Single that represents the brightness of a specified shape color. Read/write.

ContentControl

Properties

Description

Checked

Returns or sets a Boolean that represents the current state (checked/unchecked) for a check box. Read/Write.

Methods

Description

SetCheckedSymbol

Sets the symbol used to represent the checked state of a check box content control.

SetUncheckedSymbol

Sets the symbol used to represent the unchecked state of a check box content control.

Document

Properties

Description

CoAuthoring

Returns a CoAuthoring object that provides an entry point to co-authoring-related object model in the document. Read-only.

CompatibilityMode

Returns a Long that specifies the compatibility mode that Word 2010 uses when opening the document. Read-only.

Methods

Description

ApplyQuickStyleSet2

Applies the specified Quick Style set to the document.

CheckInWithVersion

Saves a document to a server from a local computer, and sets the local document to read-only so that it cannot be edited locally.

ConvertAutoHyphens

Converts hyphens created by automatic hyphenation to manual hyphens.

SaveAs2

Saves the specified document with a new name or format. Some of the arguments for this method correspond to the options in the Save As dialog box (File tab).

SetCompatibilityMode

Sets the compatibility mode for the document.

FillFormat

Properties

Description

GradientAngle

Returns or sets the angle of the gradient fill for the specified fill format. Read/write.

GradientStops

Returns the GradientStops collection associated with the specified fill format. Read-only.

PictureEffects

Returns a PictureEffects object that can be used to apply picture effects to the specified fill formatting. Read-only.

RotateWithObject

Returns or sets whether the fill rotates with the specified shape. Read/write.

TextureAlignment

Returns or sets the alignment (the origin of the coordinate grid) for the tiling of the texture fill. Read/write.

TextureHorizontalScale

Returns or sets a Single that specifies the horizontal scaling factor for the texture fill. Read/write.

TextureOffsetX

Returns or sets a Long that specifies the horizontal offset of the texture from the origin in points. Read/write.

TextureOffsetY

Returns or sets a Long that specifies the vertical offset of the texture from the origin in points. Read/write.

TextureTile

Returns or sets whether the texture fill is tiled or centered. Read/write.

TextureVerticalScale

Returns or sets a Single that specifies the vertical scaling factor for the texture fill. Read/write.

Font

Properties

Description

ContextualAlternates

Specifies whether or not contextual alternates are enabled for the specified font. Read/write Long.

Fill

Returns a FillFormat object that contains fill formatting properties for the font used by the specified range of text. Read-only.

Glow

Returns a GlowFormat object that represents the glow formatting for the font used by the specified range of text. Read-only.

Ligatures

Returns or sets the ligatures setting for the specified Font object. Read/write WdLigatures.

Line

Returns a LineFormat object that specifies the formatting for a line. Read/write.

NumberForm

Returns or sets the number form setting for an OpenType font. Read/write WdNumberForm.

NumberSpacing

Returns or sets the number spacing setting for a font. Read/write WdNumberSpacing.

Reflection

Returns a ReflectionFormat object that represents the reflection formatting for a shape. Read-only.

StylisticSet

Specifies the stylistic set for the specified font. Read/write WdStylisticSet.

TextColor

Returns a ColorFormat object that represents the color for the specified font. Read-only.

TextShadow

Returns a ShadowFormat object that specifies the shadow formatting for the specified font.

ThreeD

Returns a ThreeDFormat object that contains 3-D effect formatting properties for the specified font. Read-only.

Global

Properties

Description

ActiveProtectedViewWindow

Returns a ProtectedViewWindow object that represents the active protected view window (the protected view window with the focus). Read-only.

IsSandboxed

True if the application window is a protected view window. Read-only.

ProtectedViewWindows

Returns a ProtectedViewWindows object that represents the open protected view windows. Read-only.

GlowFormat

Properties

Description

Application

Returns an Application object that represents the Microsoft Word application. Read-only.

Creator

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

Parent

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

Transparency

Returns or sets the degree of transparency for the glow effect as a value between 0.0 (opaque) and 1.0 (clear). Read/write Single.

InlineShape

Properties

Description

Chart

Returns a Chart object that represents a chart within the collection of inline shapes in a document. Read-only.

HasSmartArt

Returns True if there is a SmartArt diagram present on the shape. Read-only.

SmartArt

Returns a SmartArt object that provides a way to work with the SmartArt associated with the specified inline shape. Read-only.

Title

Returns or sets a String that contains a title for the specified inline shape. Read/write.

InlineShapes

Methods

Description

AddSmartArt

Inserts a SmartArt graphic as an inline shape into the active document.

Options

Properties

Description

BrazilReform

Returns or sets the mode for the Brazilian Portuguese speller. Read/write.

HideChartDraftModeNotification

True if the Draft Mode notification label is hidden on charts that are inserted in Draft Mode. Read/write.

InsertChartInDraftMode

True if charts are inserted into the document using Draft Mode. Read/write.

PortugalReform

Returns or sets the mode for the European Portuguese speller. Read/write WdPortugueseReform.

SpanishMode

Returns or sets the mode for the Spanish speller. Read/write WdSpanishSpeller.

StrictRussianE

True if the spelling checker uses spelling rules regarding Russian words that use the strict ë character. Read/write.

StrictTaaMarboota

True if the spelling checker uses spelling rules to flag Arabic words ending with haa instead of taa marboota. Read/write.

UpdateFieldsWithTrackedChangesAtPrint

True if Word 2010 allows fields containing tracked changes to update before printing. Read/write.

UpdateStyleListBehavior

Returns or sets a WdUpdateStyleListBehavior constant that specifies the behavior Word 2010 should take when updating a style to match a selection that contains numbering or bullets. Read/write.

PictureFormat

Properties

Description

Crop

Returns or sets a Crop object that represents an image cropping. Read/write.

Range

Properties

Description

Conflicts

Returns a Conflicts collection object that contains all the conflict objects in the range. Read-only.

Locks

Returns a CoAuthLocks collection object that represents all the locks in the range. Read-only.

Updates

Returns a CoAuthUpdates collection object that represents all the available updates in the range. Read-only.

ReflectionFormat

Properties

Description

Application

Returns an Application object that represents the Microsoft Word application. Read-only.

Blur

Returns or sets a Single that specifies the degree of blur effect applied to the specified object. Read/write.

Creator

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

Offset

Returns or sets the amount of separation, in points, of the reflected image from the shape. Read/write.

Parent

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

Size

Returns or sets the size of the reflection as a percentage of the reflected shape from 0 to 100. Read/write.

Transparency

Returns or sets the degree of transparency for the reflection effect as a value between 0.0 (opaque) and 1.0 (clear). Read/write Single.

Research

Properties

Description

FavoriteService

Returns or sets a String that specifies the favorite research service.

Shape

Properties

Description

BackgroundStyle

Sets or returns the background style of the specified shape. Read/write MsoBackgroundStyleIndex.

Chart

Returns a Chart object that represents a chart within the collection of shapes in a document. Read-only.

HasSmartArt

Returns True if there is a SmartArt diagram present on the shape. Read-only.

ShapeStyle

Returns or sets the shape style for the specified shape. Read/write MsoShapeStyleIndex.

SmartArt

Returns a SmartArt object that provides a way to work with the SmartArt associated with the specified shape. Read-only.

Title

Returns or sets a String that contains a title for the specified shape. Read/write.

ShapeRange

Properties

Description

BackgroundStyle

Sets or returns the background style of the shapes in the specified shape range. Read/write MsoBackgroundStyleIndex.

ShapeStyle

Returns or sets the shape style for the shapes in the specified shape range. Read/write MsoShapeStyleIndex.

Title

Returns or sets a String that contains a title for the shapes in the specified shape range. Read/write.

Shapes

Methods

Description

AddSmartArt

Inserts the specified SmartArt graphic into the active document.

SoftEdgeFormat

Properties

Description

Application

Returns an Application object that represents the Microsoft Word 2010 application. Read-only.

Creator

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

Parent

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

Radius

Returns or sets a Single that represents the length of the radius for a soft edge effect. Read/write.

Table

Properties

Description

Descr

Returns or sets a String that contains a description for the specified table. Read/write.

Title

Returns or sets a String that contains a title for the specified table. Read/write.

TextFrame

Properties

Description

Column

Returns the Column object that represents the columns of the specified text frame. Read-only.

HorizontalAnchor

Returns or sets the horizontal alignment of text in a text frame. Read/write MsoHorizontalAnchor.

NoTextRotation

True if text in the text frame should not rotate when the shape is rotated. Read/write MsoTriState.

PathFormat

Returns or sets the path type for the specified text frame. Read/write MsoPathType.

ThreeD

Returns a ThreeDFormat object that contains 3-D effect formatting properties for the specified text frame. Read-only.

WarpFormat

Returns or sets the warp format (how the text is warped) for the specified text frame. Read/write MsoWarpFormat.

Methods

Description

DeleteText

Deletes the text from a text frame and all the associated properties of the text, including font attributes.

View

Properties

Description

ConflictMode

True if the document is in conflict mode view. Read/write.

ShowOtherAuthors

True if other authors' presence should be visible in the document. Read/write Boolean.

XSLTransform

Properties

Description

ID

Returns a String containing the GUID assigned to the current XSLTransform object. Read-only.

New Constants

The following constants have been added to existing enumerations in Microsoft Word 2010.

Enumeration

New Constants

WdBuiltinStyle

  • wdStyleTocHeading

WdCalendarType

  • wdCalendarTaiwan

  • wdCalendarUmalqura

WdCompatibility

  • wdDisableOTKerning

  • wdDontOverrideTableStyleFontSzAndJustification

  • wdFlipMirrorIndents

WdContentControlType

  • wdContentControlCheckBox

WdListNumberStyle

  • wdListNumberStyleArabicLZ2

  • wdListNumberStyleArabicLZ3

  • wdListNumberStyleArabicLZ4

  • wdListNumberStyleLowercaseBulgarian

  • wdListNumberStyleLowercaseGreek

  • wdListNumberStyleLowercaseTurkish

  • wdListNumberStyleUppercaseBulgarian

  • wdListNumberStyleUppercaseGreek

  • wdListNumberStyleUppercaseTurkish

WdOpenFormat

  • wdOpenFormatOpenDocumentText

WdRevisionType

  • wdRevisionCellSplit

  • wdRevisionConflictDelete

  • wdRevisionConflictInsert

WdSaveFormat

  • wdFormatOpenDocumentText

WdTaskPanes

  • wdTaskPaneNav

  • wdTaskPaneSelection

WdViewType

  • wdConflictView

WdWordDialog

  • wdDialogFileNew2007