msTransform property

[This documentation is preliminary and is subject to change.]

Gets or sets a list of one or more transform functions that specify how to translate, rotate, or scale an element in 2-D or 3-D space.

This property is read/write.

CSS 3D Transforms Module Level 3, Section 2Internet Explorer 9

Syntax

HRESULT put_msTransform(
  [in]           BSTR v
);

HRESULT get_msTransform(
  [out, retval]  BSTR *sTransforms
);

Property values

Type: BSTR

One or more transformation functions (listed in Remarks), separated by whitespace, applied in the order specified.

String format

none | <transform-function> [ <transform-function> ] *

CSS information

Applies To block-level and inline-level elements
Media visual
Inherited no
Initial Value none

Standards information

Remarks

The following transformation functions are supported for use with the -ms-transform property:

  • The matrix(a,b,c,d,e,f) function specifies a 2-D transformation in the form of a transformation matrix of six values (a through f).
  • The translate(tx,ty) function specifies a 2-D translation by the vector [tx,ty], where tx is the first translation-value parameter and ty is the optional second translation-value parameter. If ty is not specified, its value is zero. (Translation-value parameters can be either percentages or lengths.)
  • The translateX(tx) function specifies a translation by the given amount in the x direction.
  • The translateY(ty) function specifies a translation by the given amount in the y direction.
  • The scale(sx,sy) function specifies a 2-D scale operation by the [sx,sy] scaling vector that is described by the two parameters. If the second parameter is not provided, it takes a value equal to the first.
  • The scaleX(sx) function specifies a scale operation by using the [sx,1] scaling vector, where sx is given as the parameter.
  • The scaleY(sy) function specifies a scale operation by using the [1,sy] scaling vector, where sy is given as the parameter.
  • The rotate(angle) function specifies a 2-D rotation by the angle specified in the parameter about the origin of the element, as defined by the -ms-transform-origin property.
  • The skewX(ax) function specifies a skew transformation along the x-axis by the given angle.
  • The skewY(ay) function specifies a skew transformation along the y-axis by the given angle.
  • The skew(ax,ay) function specifies a skew transformation along the x and y axes. The first angle parameter specifies the skew on the x-axis. The second angle parameter specifies the skew on the y-axis. If the second parameter is not given, a value of zero is used for the y angle (that is, no skew on the y-axis).

Requirements

Minimum supported client

Windows Vista with SP1, Windows 7

Minimum supported server

Windows Server 2008 R2

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

-ms-transform-origin

 

 

Build date: 1/23/2012