Shape.ScaleHeight Method
Scales the height of the shape by a specified factor.
Namespace: Microsoft.Office.Interop.PowerPoint
Assembly: Microsoft.Office.Interop.PowerPoint (in Microsoft.Office.Interop.PowerPoint.dll)
Syntax
'Declaration
Sub ScaleHeight ( _
Factor As Single, _
RelativeToOriginalSize As MsoTriState, _
fScale As MsoScaleFrom _
)
'Usage
Dim instance As Shape
Dim Factor As Single
Dim RelativeToOriginalSize As MsoTriState
Dim fScale As MsoScaleFrom
instance.ScaleHeight(Factor, RelativeToOriginalSize, _
fScale)
void ScaleHeight(
float Factor,
MsoTriState RelativeToOriginalSize,
MsoScaleFrom fScale
)
Parameters
- Factor
Type: System.Single
Specifies the ratio between the height of the shape after you resize it and the current or original height. For example, to make a rectangle 50 percent larger, specify 1.5 for this argument.
- RelativeToOriginalSize
Type: Microsoft.Office.Core.MsoTriState
Specifies whether the shape is scaled relative to its current or original size.
- fScale
Type: Microsoft.Office.Core.MsoScaleFrom
The part of the shape that retains its position when the shape is scaled.
Remarks
For pictures and OLE objects, you can indicate whether you want to scale the shape relative to its original size or relative to its current size. Shapes other than pictures and OLE objects are always scaled relative to their current height.
The RelativeToOriginalSize parameter value can be one of the following MsoTriState constants. You can specify msoTrue for this parameter only if the specified shape is a picture or an OLE object.
Constant |
Description |
|---|---|
msoFalse |
Scales the shape relative to its current size. |
msoTrue |
Scales the shape relative to its original size. |
The fScale parameter value can be one of the following MsoTriState constants. The default is msoScaleFromTopLeft.
msoScaleFromBottomRight |
msoScaleFromMiddle |
msoScaleFromTopLeft |
Examples
This example scales all pictures and OLE objects on myDocument to 175 percent of their original height and width, and it scales all other shapes to 175 percent of their current height and width.
Set myDocument = ActivePresentation.Slides(1)
For Each s In myDocument.Shapes
Select Case s.Type
Case msoEmbeddedOLEObject, msoLinkedOLEObject, _
msoOLEControlObject, msoLinkedPicture, msoPicture
s.ScaleHeight1.75, msoTrue
s.ScaleWidth 1.75, msoTrue
Case Else
s.ScaleHeight1.75, msoFalse
s.ScaleWidth 1.75, msoFalse
End Select
Next