Adjustments Interface

Definition

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Contains a collection of adjustment values for the specified AutoShape or WordArt object.

public interface class Adjustments

[System.Runtime.InteropServices.Guid("000209C4-0000-0000-C000-000000000046")]
public interface Adjustments

type Adjustments = interface

Public Interface Adjustments

Attributes

GuidAttribute

Remarks

Each adjustment value represents one way an adjustment handle can be adjusted. Because some adjustment handles can be adjusted in two ways — for instance, some handles can be adjusted both horizontally and vertically — a shape can have more adjustment values than it has adjustment handles. A shape can have up to eight adjustments.

Use the Adjustments property to return an Adjustments object. Use Adjustments(index), where index is the adjustment value's index number, to return a single adjustment value.

Different shapes have different numbers of adjustment values, different kinds of adjustments change the geometry of a shape in different ways, and different kinds of adjustments have different ranges of valid values.

Because each adjustable shape has a different set of adjustments, the best way to verify the adjustment behavior for a specific shape is to manually create an instance of the shape, make adjustments with the macro recorder turned on, and then examine the recorded code.

The following table summarizes the ranges of valid adjustment values for different types of adjustments. In most cases, if you specify a value that's beyond the range of valid values, the closest valid value will be assigned to the adjustment.

	Linear (horizontal or vertical)	Generally the value 0.0 represents the left or top edge of the shape and the value 1.0 represents the right or bottom edge of the shape. Valid values correspond to valid adjustments you can make to the shape manually. For example, if you can only pull an adjustment handle half way across the shape manually, the maximum value for the corresponding adjustment will be 0.5. For shapes such as callouts, where the values 0.0 and 1.0 represent the limits of the rectangle defined by the starting and ending points of the callout line, negative numbers and numbers greater than 1.0 are valid values.
	Radial	An adjustment value of 1.0 corresponds to the width of the shape. The maximum value is 0.5, or half way across the shape.
	Angle	Values are expressed in degrees. If you specify a value outside the range — 180 to 180, it will be normalized to be within that range.

Properties

Application	Returns an Application object that represents the creator of the specified object.
Count	Returns a value indicating the number of items in the specified Adjustments collection.
Creator	Returns a value that indicates the application in which the specified object was created.
Item[Int32]	Returns or sets the specified adjustment value.
Parent	Returns an object that represents the parent object of the specified Adjustments collection.