excel.interfaces.shapeloadoptions.yml

### YamlMime:TSType
name: Excel.Interfaces.ShapeLoadOptions
uid: 'excel!Excel.Interfaces.ShapeLoadOptions:interface'
package: excel!
fullName: Excel.Interfaces.ShapeLoadOptions
summary: >-
  Represents a generic shape object in the worksheet. A shape could be a geometric shape, a line, a group of shapes,
  etc. To learn more about the shape object model, read [Work with shapes using the Excel JavaScript
  API](https://learn.microsoft.com/office/dev/add-ins/excel/excel-add-ins-shapes)<!-- -->.
remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
isPreview: false
isDeprecated: false
type: interface
properties:
  - name: $all
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#$all:member'
    package: excel!
    fullName: $all
    summary: >-
      Specifying `$all` for the LoadOptions loads all the scalar properties (e.g.: `Range.address`<!-- -->) but not the
      navigational properties (e.g.: `Range.format.fill.color`<!-- -->).
    remarks: ''
    isPreview: false
    isDeprecated: false
    syntax:
      content: '$all?: boolean;'
      return:
        type: boolean
  - name: altTextDescription
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#altTextDescription:member'
    package: excel!
    fullName: altTextDescription
    summary: Specifies the alternative description text for a `Shape` object.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'altTextDescription?: boolean;'
      return:
        type: boolean
  - name: altTextTitle
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#altTextTitle:member'
    package: excel!
    fullName: altTextTitle
    summary: Specifies the alternative title text for a `Shape` object.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'altTextTitle?: boolean;'
      return:
        type: boolean
  - name: connectionSiteCount
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#connectionSiteCount:member'
    package: excel!
    fullName: connectionSiteCount
    summary: Returns the number of connection sites on this shape.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'connectionSiteCount?: boolean;'
      return:
        type: boolean
  - name: fill
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#fill:member'
    package: excel!
    fullName: fill
    summary: Returns the fill formatting of this shape.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'fill?: Excel.Interfaces.ShapeFillLoadOptions;'
      return:
        type: '<xref uid="excel!Excel.Interfaces.ShapeFillLoadOptions:interface" />'
  - name: geometricShape
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#geometricShape:member'
    package: excel!
    fullName: geometricShape
    summary: >-
      Returns the geometric shape associated with the shape. An error will be thrown if the shape type is not
      "GeometricShape".
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'geometricShape?: Excel.Interfaces.GeometricShapeLoadOptions;'
      return:
        type: '<xref uid="excel!Excel.Interfaces.GeometricShapeLoadOptions:interface" />'
  - name: geometricShapeType
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#geometricShapeType:member'
    package: excel!
    fullName: geometricShapeType
    summary: >-
      Specifies the geometric shape type of this geometric shape. See `Excel.GeometricShapeType` for details. Returns
      `null` if the shape type is not "GeometricShape".
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'geometricShapeType?: boolean;'
      return:
        type: boolean
  - name: group
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#group:member'
    package: excel!
    fullName: group
    summary: Returns the shape group associated with the shape. An error will be thrown if the shape type is not "GroupShape".
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'group?: Excel.Interfaces.ShapeGroupLoadOptions;'
      return:
        type: '<xref uid="excel!Excel.Interfaces.ShapeGroupLoadOptions:interface" />'
  - name: height
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#height:member'
    package: excel!
    fullName: height
    summary: >-
      Specifies the height, in points, of the shape. Throws an `InvalidArgument` exception when set with a negative
      value or zero as an input.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'height?: boolean;'
      return:
        type: boolean
  - name: id
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#id:member'
    package: excel!
    fullName: id
    summary: Specifies the shape identifier.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'id?: boolean;'
      return:
        type: boolean
  - name: image
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#image:member'
    package: excel!
    fullName: image
    summary: Returns the image associated with the shape. An error will be thrown if the shape type is not "Image".
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'image?: Excel.Interfaces.ImageLoadOptions;'
      return:
        type: '<xref uid="excel!Excel.Interfaces.ImageLoadOptions:interface" />'
  - name: left
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#left:member'
    package: excel!
    fullName: left
    summary: >-
      The distance, in points, from the left side of the shape to the left side of the worksheet. Throws an
      `InvalidArgument` exception when set with a negative value as an input.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'left?: boolean;'
      return:
        type: boolean
  - name: level
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#level:member'
    package: excel!
    fullName: level
    summary: >-
      Specifies the level of the specified shape. For example, a level of 0 means that the shape is not part of any
      groups, a level of 1 means the shape is part of a top-level group, and a level of 2 means the shape is part of a
      sub-group of the top level.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'level?: boolean;'
      return:
        type: boolean
  - name: line
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#line:member'
    package: excel!
    fullName: line
    summary: Returns the line associated with the shape. An error will be thrown if the shape type is not "Line".
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'line?: Excel.Interfaces.LineLoadOptions;'
      return:
        type: '<xref uid="excel!Excel.Interfaces.LineLoadOptions:interface" />'
  - name: lineFormat
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#lineFormat:member'
    package: excel!
    fullName: lineFormat
    summary: Returns the line formatting of this shape.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'lineFormat?: Excel.Interfaces.ShapeLineFormatLoadOptions;'
      return:
        type: '<xref uid="excel!Excel.Interfaces.ShapeLineFormatLoadOptions:interface" />'
  - name: lockAspectRatio
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#lockAspectRatio:member'
    package: excel!
    fullName: lockAspectRatio
    summary: Specifies if the aspect ratio of this shape is locked.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'lockAspectRatio?: boolean;'
      return:
        type: boolean
  - name: name
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#name:member'
    package: excel!
    fullName: name
    summary: Specifies the name of the shape.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'name?: boolean;'
      return:
        type: boolean
  - name: parentGroup
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#parentGroup:member'
    package: excel!
    fullName: parentGroup
    summary: Specifies the parent group of this shape.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'parentGroup?: Excel.Interfaces.ShapeLoadOptions;'
      return:
        type: '<xref uid="excel!Excel.Interfaces.ShapeLoadOptions:interface" />'
  - name: placement
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#placement:member'
    package: excel!
    fullName: placement
    summary: Represents how the object is attached to the cells below it.
    remarks: '\[ [API set: ExcelApi 1.10](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'placement?: boolean;'
      return:
        type: boolean
  - name: rotation
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#rotation:member'
    package: excel!
    fullName: rotation
    summary: 'Specifies the rotation, in degrees, of the shape.'
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'rotation?: boolean;'
      return:
        type: boolean
  - name: textFrame
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#textFrame:member'
    package: excel!
    fullName: textFrame
    summary: Returns the text frame object of this shape.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'textFrame?: Excel.Interfaces.TextFrameLoadOptions;'
      return:
        type: '<xref uid="excel!Excel.Interfaces.TextFrameLoadOptions:interface" />'
  - name: top
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#top:member'
    package: excel!
    fullName: top
    summary: >-
      The distance, in points, from the top edge of the shape to the top edge of the worksheet. Throws an
      `InvalidArgument` exception when set with a negative value as an input.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'top?: boolean;'
      return:
        type: boolean
  - name: type
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#type:member'
    package: excel!
    fullName: type
    summary: Returns the type of this shape. See `Excel.ShapeType` for details.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'type?: boolean;'
      return:
        type: boolean
  - name: visible
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#visible:member'
    package: excel!
    fullName: visible
    summary: Specifies if the shape is visible.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'visible?: boolean;'
      return:
        type: boolean
  - name: width
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#width:member'
    package: excel!
    fullName: width
    summary: >-
      Specifies the width, in points, of the shape. Throws an `InvalidArgument` exception when set with a negative value
      or zero as an input.
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'width?: boolean;'
      return:
        type: boolean
  - name: zOrderPosition
    uid: 'excel!Excel.Interfaces.ShapeLoadOptions#zOrderPosition:member'
    package: excel!
    fullName: zOrderPosition
    summary: 'Returns the position of the specified shape in the z-order, with 0 representing the bottom of the order stack.'
    remarks: '\[ [API set: ExcelApi 1.9](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]'
    isPreview: false
    isDeprecated: false
    syntax:
      content: 'zOrderPosition?: boolean;'
      return:
        type: boolean