GroupShape Class
Represents a drawing that groups other drawings on the same slide surface.
public sealed class GroupShape : VisualShape
Public NotInheritable Class GroupShape
Inherits VisualShape
- Inheritance:
- System.ObjectGroupShape
Properties
Drawings
Gets the drawings contained in this group.
public DrawingCollection Drawings { get; }
Public ReadOnly Property Drawings As DrawingCollection
Property Value
The drawings contained in this group.
DrawingType
Gets the GroupShape value.
public override DrawingType DrawingType { get; }
Public Overrides ReadOnly Property DrawingType As DrawingType
Property Value
The GroupShape value.
Overrides
Methods
AddAudio(AudioContentType, Stream, Double, Double)
Adds a new Picture with an AudioContent media to the current GroupShape.
[ComVisible(false)]
public AudioContent AddAudio(AudioContentType contentType, Stream stream, double left, double top)
<ComVisible(False)>
Public Function AddAudio(contentType As AudioContentType, stream As Stream, left As Double, top As Double) As AudioContent
Parameters
contentType
- AudioContentType
Content type of the audio data.
stream
- System.IO.Stream
Stream containing the audio data.
left
- System.Double
top
- System.Double
Returns
A new AudioContent contained in a new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
and top
are specified.
AddAudio(AudioContentType, Stream, Double, Double, LengthUnit)
Adds a new Picture with an AudioContent media to the current GroupShape.
[ComVisible(false)]
public AudioContent AddAudio(AudioContentType contentType, Stream stream, double left, double top, LengthUnit unit)
<ComVisible(False)>
Public Function AddAudio(contentType As AudioContentType, stream As Stream, left As Double, top As Double, unit As LengthUnit) As AudioContent
Parameters
contentType
- AudioContentType
Content type of the audio data.
stream
- System.IO.Stream
Stream containing the audio data.
left
- System.Double
top
- System.Double
unit
- LengthUnit
The measuring unit in which parameters left
and top
are specified.
Returns
A new AudioContent contained in a new Picture added to the current GroupShape.
AddAudio(String, Double, Double)
Adds a new Picture with an AudioContent media to the current GroupShape.
[ComVisible(false)]
public AudioContent AddAudio(string link, double left, double top)
<ComVisible(False)>
Public Function AddAudio(link As String, left As Double, top As Double) As AudioContent
Parameters
link
- System.String
Link to an audio data for a newly added AudioContent media.
left
- System.Double
top
- System.Double
Returns
A new AudioContent contained in a new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
and top
are specified.
AddAudio(String, Double, Double, LengthUnit)
Adds a new Picture with an AudioContent media to the current GroupShape.
[ComVisible(false)]
public AudioContent AddAudio(string link, double left, double top, LengthUnit unit)
<ComVisible(False)>
Public Function AddAudio(link As String, left As Double, top As Double, unit As LengthUnit) As AudioContent
Parameters
link
- System.String
Link to an audio data for a newly added AudioContent media.
left
- System.Double
top
- System.Double
unit
- LengthUnit
The measuring unit in which parameters left
and top
are specified.
Returns
A new AudioContent contained in a new Picture added to the current GroupShape.
AddAudio(String, Stream, Double, Double)
Adds a new Picture with an AudioContent media to the current GroupShape.
[ComVisible(true)]
public AudioContent AddAudio(string contentType, Stream stream, double left, double top)
<ComVisible(True)>
Public Function AddAudio(contentType As String, stream As Stream, left As Double, top As Double) As AudioContent
Parameters
contentType
- System.String
Content type (MIME type) of the audio data.
stream
- System.IO.Stream
Stream containing the audio data.
left
- System.Double
top
- System.Double
Returns
A new AudioContent contained in a new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
and top
are specified.
AddAudio(String, Stream, Double, Double, LengthUnit)
Adds a new Picture with an AudioContent media to the current GroupShape.
[ComVisible(false)]
public AudioContent AddAudio(string contentType, Stream stream, double left, double top, LengthUnit unit)
<ComVisible(False)>
Public Function AddAudio(contentType As String, stream As Stream, left As Double, top As Double, unit As LengthUnit) As AudioContent
Parameters
contentType
- System.String
Content type (MIME type) of the audio data.
stream
- System.IO.Stream
Stream containing the audio data.
left
- System.Double
top
- System.Double
unit
- LengthUnit
The measuring unit in which parameters left
and top
are specified.
Returns
A new AudioContent contained in a new Picture added to the current GroupShape.
AddChart(ChartType, ChartGrouping, Double, Double, Double, Double)
Adds a new GraphicFrame with a Chart content to the current GroupShape.
[ComVisible(true)]
public Chart AddChart(ChartType chartType, ChartGrouping chartGrouping, double left, double top, double width, double height)
<ComVisible(True)>
Public Function AddChart(chartType As ChartType, chartGrouping As ChartGrouping, left As Double, top As Double, width As Double, height As Double) As Chart
Parameters
chartType
- ChartType
Type of the chart.
chartGrouping
- ChartGrouping
The chart's series grouping (clustered, stacked or 100% stacked).
left
- System.Double
The location of the left edge of the bounding box enclosing a newly added GraphicFrame relative to the left edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
top
- System.Double
the location of the top edge of the bounding box enclosing a newly added GraphicFrame relative to the top edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
width
- System.Double
The width of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
Returns
A new Chart contained in a new GraphicFrame added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddChart(ChartType, ChartGrouping, Double, Double, Double, Double, LengthUnit)
Adds a new GraphicFrame with a Chart content to the current GroupShape.
[ComVisible(false)]
public Chart AddChart(ChartType chartType, ChartGrouping chartGrouping, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddChart(chartType As ChartType, chartGrouping As ChartGrouping, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Chart
Parameters
chartType
- ChartType
Type of the chart.
chartGrouping
- ChartGrouping
The chart's series grouping (clustered, stacked or 100% stacked).
left
- System.Double
The location of the left edge of the bounding box enclosing a newly added GraphicFrame relative to the left edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
top
- System.Double
the location of the top edge of the bounding box enclosing a newly added GraphicFrame relative to the top edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
width
- System.Double
The width of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new Chart contained in a new GraphicFrame added to the current GroupShape.
AddChart(ChartType, Double, Double, Double, Double)
Adds a new GraphicFrame with a Chart content to the current GroupShape.
[ComVisible(true)]
public Chart AddChart(ChartType chartType, double left, double top, double width, double height)
<ComVisible(True)>
Public Function AddChart(chartType As ChartType, left As Double, top As Double, width As Double, height As Double) As Chart
Parameters
chartType
- ChartType
Type of the chart.
left
- System.Double
The location of the left edge of the bounding box enclosing a newly added GraphicFrame relative to the left edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
top
- System.Double
the location of the top edge of the bounding box enclosing a newly added GraphicFrame relative to the top edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
width
- System.Double
The width of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
Returns
A new Chart contained in a new GraphicFrame added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddChart(ChartType, Double, Double, Double, Double, LengthUnit)
Adds a new GraphicFrame with a Table content to the current GroupShape.
[ComVisible(false)]
public Chart AddChart(ChartType chartType, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddChart(chartType As ChartType, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Chart
Parameters
chartType
- ChartType
Type of the chart.
left
- System.Double
The location of the left edge of the bounding box enclosing a newly added GraphicFrame relative to the left edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
top
- System.Double
the location of the top edge of the bounding box enclosing a newly added GraphicFrame relative to the top edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
width
- System.Double
The width of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new Table contained in a new GraphicFrame added to the current GroupShape.
AddConnector(ShapeGeometryType, Double, Double, Double, Double)
Adds a new Connector to the current GroupShape.
[ComVisible(true)]
public Connector AddConnector(ShapeGeometryType shapeType, double left, double top, double width, double height)
<ComVisible(True)>
Public Function AddConnector(shapeType As ShapeGeometryType, left As Double, top As Double, width As Double, height As Double) As Connector
Parameters
shapeType
- ShapeGeometryType
Shape type (geometry) of a newly added connector.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Connector (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Connector (prior to any rotation or flipping).
Returns
A new Connector added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddConnector(ShapeGeometryType, Double, Double, Double, Double, LengthUnit)
Adds a new Connector to the current GroupShape.
[ComVisible(false)]
public Connector AddConnector(ShapeGeometryType shapeType, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddConnector(shapeType As ShapeGeometryType, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Connector
Parameters
shapeType
- ShapeGeometryType
Shape type (geometry) of a newly added connector.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Connector (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Connector (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new Connector added to the current GroupShape.
AddConnector(Double, Double, Double, Double)
Adds a new line Connector to the current GroupShape.
[ComVisible(false)]
public Connector AddConnector(double left, double top, double width, double height)
<ComVisible(False)>
Public Function AddConnector(left As Double, top As Double, width As Double, height As Double) As Connector
Parameters
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Connector (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Connector (prior to any rotation or flipping).
Returns
A new line Connector added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddConnector(Double, Double, Double, Double, LengthUnit)
Adds a new line Connector to the current GroupShape.
[ComVisible(false)]
public Connector AddConnector(double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddConnector(left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Connector
Parameters
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Connector (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Connector (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new line Connector added to the current GroupShape.
AddGroup(Drawing[])
Adds a new GroupShape that groups the specified drawings to the current GroupShape.
Drawings should either be contained under the current GroupShape, in which case they will be removed from the current GroupShape and added to a returned GroupShape, or should not be contained in any GroupShape.
[ComVisible(false)]
public GroupShape AddGroup(params Drawing[] drawings)
<ComVisible(False)>
Public Function AddGroup(ParamArray drawings As Drawing()) As GroupShape
Parameters
drawings
- Drawing[]
The drawings that should be grouped.
Returns
A new GroupShape that groups the specified drawings added to the current GroupShape.
Exceptions
- System.ArgumentNullException
drawings
is null.
- System.ArgumentException
drawings
contains a null object.
AddGroup(IEnumerable<Drawing>)
Adds a new GroupShape that groups the specified drawings to the current GroupShape.
Drawings should either be contained under the current GroupShape, in which case they will be removed from the current GroupShape and added to a returned GroupShape, or should not be contained in any GroupShape.
[ComVisible(true)]
public GroupShape AddGroup(IEnumerable<Drawing> drawings)
<ComVisible(True)>
Public Function AddGroup(drawings As IEnumerable(Of Drawing)) As GroupShape
Parameters
drawings
- System.Collections.Generic.IEnumerable<Drawing>
The drawings that should be grouped.
Returns
A new GroupShape that groups the specified drawings added to the current GroupShape.
Exceptions
- System.ArgumentNullException
drawings
is null.
- System.ArgumentException
drawings
contains a null object.
AddOleObject(Stream, String, Double, Double, Double, Double, LengthUnit, String)
Adds a new GraphicFrame with a OleObject content to the current GroupShape.
public OleObject AddOleObject(Stream stream, string originalPathOrFileName, double left, double top, double width, double height, LengthUnit unit, string explicitContentType = null)
Public Function AddOleObject(stream As Stream, originalPathOrFileName As String, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit, explicitContentType As String = Nothing) As OleObject
Parameters
stream
- System.IO.Stream
The stream containing the embedded object data.
originalPathOrFileName
- System.String
The original path or file name of the embedded object.
left
- System.Double
The location of the left edge of the bounding box enclosing a newly added GraphicFrame relative to the left edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
top
- System.Double
the location of the top edge of the bounding box enclosing a newly added GraphicFrame relative to the top edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
width
- System.Double
The width of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
explicitContentType
- System.String
The explicit content type of the embedded object, if any.
Returns
A new OleObject contained in a new GraphicFrame added to the current GroupShape.
AddOleObject(String, Boolean, Double, Double, Double, Double, LengthUnit, String)
Adds a new GraphicFrame with a OleObject content to the current GroupShape.
public OleObject AddOleObject(string path, bool linked, double left, double top, double width, double height, LengthUnit unit, string explicitContentType = null)
Public Function AddOleObject(path As String, linked As Boolean, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit, explicitContentType As String = Nothing) As OleObject
Parameters
path
- System.String
The file path to the embedded or linked object.
linked
- System.Boolean
Indicates whether the object is linked (true) or embedded (false).
left
- System.Double
The location of the left edge of the bounding box enclosing a newly added GraphicFrame relative to the left edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
top
- System.Double
the location of the top edge of the bounding box enclosing a newly added GraphicFrame relative to the top edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
width
- System.Double
The width of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
explicitContentType
- System.String
The explicit content type of the embedded object, if any.
Returns
A new OleObject contained in a new GraphicFrame added to the current GroupShape.
AddPicture(Content, Double, Double, Double, Double)
Adds a new Picture with the specified picture data to the current GroupShape.
[ComVisible(false)]
public Picture AddPicture(Content content, double left, double top, double width, double height)
<ComVisible(False)>
Public Function AddPicture(content As Content, left As Double, top As Double, width As Double, height As Double) As Picture
Parameters
content
- Content
Content of the picture data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
Returns
A new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
Use this overload if multiple Pictures should share the same picture data.
AddPicture(Content, Double, Double, Double, Double, LengthUnit)
Adds a new Picture with the specified picture data to the current GroupShape.
[ComVisible(false)]
public Picture AddPicture(Content content, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddPicture(content As Content, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Picture
Parameters
content
- Content
Content of the picture data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new Picture added to the current GroupShape.
Remarks
Use this overload if multiple Pictures should share the same picture data.
AddPicture(PictureContentType, Stream, Double, Double, Double, Double)
Adds a new Picture with the specified picture data content type and stream to the current GroupShape.
[ComVisible(false)]
public Picture AddPicture(PictureContentType contentType, Stream stream, double left, double top, double width, double height)
<ComVisible(False)>
Public Function AddPicture(contentType As PictureContentType, stream As Stream, left As Double, top As Double, width As Double, height As Double) As Picture
Parameters
contentType
- PictureContentType
Content type of the picture data.
stream
- System.IO.Stream
Stream containing the picture data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
Returns
A new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddPicture(PictureContentType, Stream, Double, Double, Double, Double, LengthUnit)
Adds a new Picture with the specified picture data content type and stream to the current GroupShape.
[ComVisible(false)]
public Picture AddPicture(PictureContentType contentType, Stream stream, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddPicture(contentType As PictureContentType, stream As Stream, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Picture
Parameters
contentType
- PictureContentType
Content type of the picture data.
stream
- System.IO.Stream
Stream containing the picture data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new Picture added to the current GroupShape.
AddPicture(String, Double, Double, Double, Double)
Adds a new Picture with a link to the specified picture data to the current GroupShape.
[ComVisible(false)]
public Picture AddPicture(string link, double left, double top, double width, double height)
<ComVisible(False)>
Public Function AddPicture(link As String, left As Double, top As Double, width As Double, height As Double) As Picture
Parameters
link
- System.String
Link to a picture data for a newly added picture.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
Returns
A new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddPicture(String, Double, Double, Double, Double, LengthUnit)
Adds a new Picture with a link to the specified picture data to the current GroupShape.
[ComVisible(false)]
public Picture AddPicture(string link, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddPicture(link As String, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Picture
Parameters
link
- System.String
Link to a picture data for a newly added picture.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new Picture added to the current GroupShape.
AddPicture(String, Stream, Double, Double, Double, Double)
Adds a new Picture with the specified picture data content type and stream to the current GroupShape.
[ComVisible(true)]
public Picture AddPicture(string contentType, Stream stream, double left, double top, double width, double height)
<ComVisible(True)>
Public Function AddPicture(contentType As String, stream As Stream, left As Double, top As Double, width As Double, height As Double) As Picture
Parameters
contentType
- System.String
Content type (MIME type) of the picture data.
stream
- System.IO.Stream
Stream containing the picture data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
Returns
A new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddPicture(String, Stream, Double, Double, Double, Double, LengthUnit)
Adds a new Picture with the specified picture data content type and stream to the current GroupShape.
[ComVisible(false)]
public Picture AddPicture(string contentType, Stream stream, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddPicture(contentType As String, stream As Stream, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Picture
Parameters
contentType
- System.String
Content type (MIME type) of the picture data.
stream
- System.IO.Stream
Stream containing the picture data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new Picture added to the current GroupShape.
AddPlaceholder(PlaceholderType)
Adds the placeholder Shape to the current GroupShape.
public DrawingPlaceholder AddPlaceholder(PlaceholderType placeholderType)
Public Function AddPlaceholder(placeholderType As PlaceholderType) As DrawingPlaceholder
Parameters
placeholderType
- PlaceholderType
Type of the placeholder to be added.
Returns
A placeholder settings associated with a new placeholder Shape added to the current GroupShape.
Exceptions
- System.InvalidOperationException
Placeholder can only be added directly to a slide (to a root group of shapes).
AddShape(ShapeGeometryType, Double, Double, Double, Double)
Adds a new Shape to the current GroupShape.
[ComVisible(true)]
public Shape AddShape(ShapeGeometryType shapeType, double left, double top, double width, double height)
<ComVisible(True)>
Public Function AddShape(shapeType As ShapeGeometryType, left As Double, top As Double, width As Double, height As Double) As Shape
Parameters
shapeType
- ShapeGeometryType
Shape type (geometry) of a newly added shape.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
Returns
A new Shape added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddShape(ShapeGeometryType, Double, Double, Double, Double, LengthUnit)
Adds a new Shape to the current GroupShape.
[ComVisible(false)]
public Shape AddShape(ShapeGeometryType shapeType, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddShape(shapeType As ShapeGeometryType, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Shape
Parameters
shapeType
- ShapeGeometryType
Shape type (geometry) of a newly added shape.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new Shape added to the current GroupShape.
AddTable(Double, Double, Double, Double)
Adds a new GraphicFrame with a Table content to the current GroupShape.
[ComVisible(true)]
public Table AddTable(double left, double top, double width, double height)
<ComVisible(True)>
Public Function AddTable(left As Double, top As Double, width As Double, height As Double) As Table
Parameters
left
- System.Double
The location of the left edge of the bounding box enclosing a newly added GraphicFrame relative to the left edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
top
- System.Double
the location of the top edge of the bounding box enclosing a newly added GraphicFrame relative to the top edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
width
- System.Double
The width of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
Returns
A new Table contained in a new GraphicFrame added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddTable(Double, Double, Double, Double, LengthUnit)
Adds a new GraphicFrame with a Table content to the current GroupShape.
[ComVisible(false)]
public Table AddTable(double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddTable(left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As Table
Parameters
left
- System.Double
The location of the left edge of the bounding box enclosing a newly added GraphicFrame relative to the left edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
top
- System.Double
the location of the top edge of the bounding box enclosing a newly added GraphicFrame relative to the top edge of the slide on which the GraphicFrame is being added (prior to any rotation or flipping).
width
- System.Double
The width of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added GraphicFrame (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new Table contained in a new GraphicFrame added to the current GroupShape.
AddTextBox(ShapeGeometryType, Double, Double, Double, Double)
Adds a new rectangular Shape to the current GroupShape and returns TextBox associated with it.
[ComVisible(false)]
public TextBox AddTextBox(ShapeGeometryType shapeType, double left, double top, double width, double height)
<ComVisible(False)>
Public Function AddTextBox(shapeType As ShapeGeometryType, left As Double, top As Double, width As Double, height As Double) As TextBox
Parameters
shapeType
- ShapeGeometryType
Shape type (geometry) of a newly added shape.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
Returns
A TextBox associated with the new rectangular Shape added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddTextBox(ShapeGeometryType, Double, Double, Double, Double, LengthUnit)
Adds a new rectangular Shape to the current GroupShape and returns TextBox associated with it.
[ComVisible(false)]
public TextBox AddTextBox(ShapeGeometryType shapeType, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddTextBox(shapeType As ShapeGeometryType, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As TextBox
Parameters
shapeType
- ShapeGeometryType
Shape type (geometry) of a newly added shape.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A TextBox associated with the new rectangular Shape added to the current GroupShape.
AddTextBox(Double, Double, Double, Double)
Adds a new rectangular Shape to the current GroupShape and returns TextBox associated with it.
[ComVisible(true)]
public TextBox AddTextBox(double left, double top, double width, double height)
<ComVisible(True)>
Public Function AddTextBox(left As Double, top As Double, width As Double, height As Double) As TextBox
Parameters
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
Returns
A TextBox associated with the new rectangular Shape added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddTextBox(Double, Double, Double, Double, LengthUnit)
Adds a new rectangular Shape to the current GroupShape and returns TextBox associated with it.
[ComVisible(false)]
public TextBox AddTextBox(double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddTextBox(left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As TextBox
Parameters
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Shape (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A TextBox associated with the new rectangular Shape added to the current GroupShape.
AddVideo(VideoContentType, Stream, Double, Double, Double, Double)
Adds a new Picture with a VideoContent media to the current GroupShape.
[ComVisible(false)]
public VideoContent AddVideo(VideoContentType contentType, Stream stream, double left, double top, double width, double height)
<ComVisible(False)>
Public Function AddVideo(contentType As VideoContentType, stream As Stream, left As Double, top As Double, width As Double, height As Double) As VideoContent
Parameters
contentType
- VideoContentType
Content type (MIME type) of the video data.
stream
- System.IO.Stream
Stream containing the video data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
Returns
A new VideoContent contained in a new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddVideo(VideoContentType, Stream, Double, Double, Double, Double, LengthUnit)
Adds a new Picture with a VideoContent media to the current GroupShape.
[ComVisible(false)]
public VideoContent AddVideo(VideoContentType contentType, Stream stream, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddVideo(contentType As VideoContentType, stream As Stream, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As VideoContent
Parameters
contentType
- VideoContentType
Content type of the video data.
stream
- System.IO.Stream
Stream containing the video data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new VideoContent contained in a new Picture added to the current GroupShape.
AddVideo(String, Double, Double, Double, Double)
Adds a new Picture with a VideoContent media to the current GroupShape.
[ComVisible(false)]
public VideoContent AddVideo(string link, double left, double top, double width, double height)
<ComVisible(False)>
Public Function AddVideo(link As String, left As Double, top As Double, width As Double, height As Double) As VideoContent
Parameters
link
- System.String
Link to a video data for a newly added VideoContent media.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
Returns
A new VideoContent contained in a new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddVideo(String, Double, Double, Double, Double, LengthUnit)
Adds a new Picture with a VideoContent media to the current GroupShape.
[ComVisible(false)]
public VideoContent AddVideo(string link, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddVideo(link As String, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As VideoContent
Parameters
link
- System.String
Link to a video data for a newly added VideoContent media.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new VideoContent contained in a new Picture added to the current GroupShape.
AddVideo(String, Stream, Double, Double, Double, Double)
Adds a new Picture with a VideoContent media to the current GroupShape.
[ComVisible(true)]
public VideoContent AddVideo(string contentType, Stream stream, double left, double top, double width, double height)
<ComVisible(True)>
Public Function AddVideo(contentType As String, stream As Stream, left As Double, top As Double, width As Double, height As Double) As VideoContent
Parameters
contentType
- System.String
Content type (MIME type) of the video data.
stream
- System.IO.Stream
Stream containing the video data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
Returns
A new VideoContent contained in a new Picture added to the current GroupShape.
Remarks
DefaultUnit is the measuring unit in which parameters left
, top
, width
and height
are specified.
AddVideo(String, Stream, Double, Double, Double, Double, LengthUnit)
Adds a new Picture with a VideoContent media to the current GroupShape.
[ComVisible(false)]
public VideoContent AddVideo(string contentType, Stream stream, double left, double top, double width, double height, LengthUnit unit)
<ComVisible(False)>
Public Function AddVideo(contentType As String, stream As Stream, left As Double, top As Double, width As Double, height As Double, unit As LengthUnit) As VideoContent
Parameters
contentType
- System.String
Content type (MIME type) of the video data.
stream
- System.IO.Stream
Stream containing the video data.
left
- System.Double
top
- System.Double
width
- System.Double
The width of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
height
- System.Double
The height of the bounding box enclosing a newly added Picture (prior to any rotation or flipping).
unit
- LengthUnit
The measuring unit in which parameters left
, top
, width
and height
are specified.
Returns
A new VideoContent contained in a new Picture added to the current GroupShape.
Inherited Properties
Action | Gets or sets the action settings for this drawing that specify what should happen when the user clicks on this drawing or hovers over this drawing with a pointing device such as a computer mouse. To remove all actions from this drawing, set this property to null. (Inherited from VisualDrawing) |
AlternativeText | Gets or sets the alternative, text-based representation of the information contained in this drawing. To remove an alternative, text-based representation from this drawing, set this property to null. (Inherited from VisualDrawing) |
CustomerData | Gets or sets the customer defined data. (Inherited from VisualDrawing) |
Format | Gets or sets the shape's formatting options. (Inherited from VisualShape) |
Hidden | Gets or sets a value indicating whether this drawing is hidden. Drawing is automatically hidden if any of its ancestor GroupShape is hidden. Default value is false. (Inherited from VisualDrawing) |
Layout | Gets or sets the location, size and transformations (flipping and rotation) of the bounding box enclosing this drawing. (Inherited from VisualDrawing) |
Locks | Gets or sets the locking settings for this drawing. These settings inform the application about specific drawing properties that have been previously locked and thus should not be changed by the user when viewing a drawing in an application. Default value is None. (Inherited from VisualDrawing) |
Name | Gets or sets the name of this drawing. (Inherited from VisualDrawing) |
Parent | Gets the parent group or null if drawing is not grouped. (Inherited from Drawing) |
Placeholder | Gets the placeholder settings for this drawing if the drawing is a placeholder; otherwise, null. (Inherited from VisualDrawing) |
Slide | Gets the slide associated with this drawing. (Inherited from Drawing) |
TextContent | Gets the text content of the current Drawing. (Inherited from Drawing) |
Inherited Methods
BringForward() | Brings this drawing forward so that it is hidden by fewer drawings that are in front of it. (Inherited from Drawing) |
BringForward(Drawing) | Brings this drawing forward so that is not hidden by the specified drawing and all other drawings behind the specified drawing. (Inherited from Drawing) |
BringToFront() | Brings this drawing in front of all other drawings so that no part of it is hidden behind another drawing. (Inherited from Drawing) |
FormatDrawing() | Formats this VisualDrawing to its default size so it can be exported to PDF, XPS, image, or be printed. (Inherited from VisualDrawing) |
FormatDrawing(System.Double, System.Double, LengthUnit) | Formats this VisualDrawing to specified size so it can be exported to PDF, XPS, image, or be printed. (Inherited from VisualDrawing) |
FormatDrawing(System.Double, System.Double, LengthUnit, PaginatorOptions) | Formats this VisualDrawing to specified size so it can be exported to PDF, XPS, image, or be printed. (Inherited from VisualDrawing) |
FormatDrawing(PaginatorOptions) | Formats this VisualDrawing to its default size so it can be exported to PDF, XPS, image, or be printed. (Inherited from VisualDrawing) |
SendBackward() | Sends this drawing backward so that it is hidden by more drawings that are in front of it. (Inherited from Drawing) |
SendBackward(Drawing) | Sends this drawing backward so that is hidden by the specified drawing and all other drawings in front of the specified drawing. (Inherited from Drawing) |
SendToBack() | Sends this drawing behind all other drawings. (Inherited from Drawing) |
ToString() | Returns a System.String that represents this VisualDrawing instance. (Inherited from VisualDrawing) |