GemBox.Presentation
  • Overview
  • Examples
  • Free version
  • Support
  • Pricelist

    Show / Hide Table of Contents

    GeometryShape Class

    Namespace:
    GemBox.Presentation
    Assembly:
    GemBox.Presentation.dll

    Represents a shape that is outlined and/or filled in locations specified by the geometric primitives such as lines, arcs and Bézier curves.

    • C#
    • VB.NET
    public abstract class GeometryShape : VisualShape
    Public MustInherit Class GeometryShape
        Inherits VisualShape
    Inheritance:
    System.Object
    Drawing
    VisualDrawing
    VisualShape
    GeometryShape
    Derived
    Connector
    Picture
    Shape

    Properties

    Geometry

    Gets or sets the shape's geometry that contains additional information about the ShapeType.

    • C#
    • VB.NET
    public ShapeGeometry Geometry { get; set; }
    Public Property Geometry As ShapeGeometry
    Property Value
    ShapeGeometry

    The shape's geometry that contains additional information about the ShapeType.

    Remarks

    This property always returns a new instance of a ShapeGeometry that points to geometry data associated with this shape. This reduces memory footprint since simpler internal structures can be used to hold the geometry data and execution time increase is negligible since Garbage Collector has a very good performance for a short-lived (Generation 0) objects. Also, this behavior is required because geometry can be inherited from the placeholder (and changes in the placeholder's geometry must be immediately visible in this shape's geometry), but when the geometry is being modified, it should be modified for this shape, not for the placeholder.

    When setting a value, instance of a ShapeGeometry won't actually be stored in this shape, but the geometry data to which the instance points to will be copied. This enables easy copying of complex geometries from one shape to another.

    Exceptions
    System.ArgumentException

    Value is a connector geometry and the current shape is not a Connector or value is not a connector geometry and the current shape is a Connector.

    ShapeType

    Gets or sets the type of the shape (geometry).

    • C#
    • VB.NET
    public ShapeGeometryType ShapeType { get; set; }
    Public Property ShapeType As ShapeGeometryType
    Property Value
    ShapeGeometryType

    The type of the shape (geometry).

    Exceptions
    System.ArgumentException

    Value is a connector geometry type and the current shape is not a Connector or value is not a connector geometry type and the current shape is a Connector.

    Methods

    ToString()

    Returns a System.String that represents this GeometryShape instance.

    • C#
    • VB.NET
    public override string ToString()
    Public Overrides Function ToString As String
    Returns
    System.String

    A System.String that represents this GeometryShape instance.

    Overrides
    VisualDrawing.ToString()
    Remarks

    This method should be used primarily for debugging purposes and should be considered volatile (format of its return value might change in future versions).

    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)

    DrawingType

    Gets the type of the drawing.

    (Inherited from Drawing)

    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)

    Back to top

    Facebook • Twitter • LinkedIn

    © GemBox Ltd. — All rights reserved.