PictureFormat.Preset Property
Gets or sets the picture’s geometry type.
Namespace: DevExpress.XtraRichEdit.API.Native
Assembly: DevExpress.RichEdit.v26.1.Core.dll
Declaration
Property Value
| Type | Description |
|---|---|
| ShapeGeometryPreset | An enumeration member that specifies the picture’s geometry. |
Available values:
| Name | Description | Example |
|---|---|---|
| Custom | A custom shape. |
|
| LineInverse | An inverse line shape. |
|
| Triangle | An isosceles triangle. |
|
| RightTriangle | A right triangle. |
|
| Rectangle | A rectangle. |
|
| Diamond | A diamond. |
|
| Parallelogram | A parallelogram. |
|
| Trapezoid | A trapezoid. |
|
| NonIsoscelesTrapezoid | A non-isosceles trapezoid. |
|
| RegularPentagon | A regular pentagon. |
|
| Hexagon | A hexagon. |
|
| Heptagon | A heptagon. |
|
| Octagon | An octagon. |
|
| Decagon | A decagon. |
|
| Dodecagon | A dodecagon. |
|
| Star4 | A 4-point star. |
|
| Star5 | A 5-point star. |
|
| Star6 | A 6-point star. |
|
| Star7 | A 7-point star. |
|
| Star8 | An 8-point star. |
|
| Star10 | A 10-point star. |
|
| Star12 | A 12-point star. |
|
| Star16 | A 16-point star. |
|
| Star24 | A 24-point star. |
|
| Star32 | A 32-point star. |
|
| RoundedRectangle | A rounded rectangle. |
|
| RoundSingleCornerRectangle | A rectangle with one rounded corner. |
|
| RoundSameSideCornerRectangle | A rectangle with two-rounded corners that share a side. |
|
| RoundDiagonalCornerRectangle | A rectangle with two rounded corners, diagonally-opposed. |
|
| SnipAndRoundSingleCornerRectangle | A rectangle with one snipped corner and one rounded corner. |
|
| SnipSingleCornerRectangle | A rectangle with one snipped corner. |
|
| SnipSameSideCornerRectangle | A rectangle with two snipped corners that share a side. |
|
| SnipDiagonalCornerRectangle | A rectangle with two snipped corners, diagonally-opposed. |
|
| Plaque | A plaque. |
|
| Oval | An oval. |
|
| Teardrop | A water droplet. |
|
| Pentagon | A pentagon. |
|
| Chevron | A chevron. |
|
| PieWedge | A quarter of a circular shape. |
|
| Pie | A circle with a portion missing. |
|
| BlockArc | A block arc. |
|
| Donut | A donut. |
|
| NoSymbol | A prohibition sign. |
|
| RightArrow | A block arrow that points right. |
|
| LeftArrow | A block arrow that points left. |
|
| UpArrow | A block arrow that points up. |
|
| DownArrow | A block arrow that points down. |
|
| StripedRightArrow | A block arrow that points right and has stripes on the tail. |
|
| NotchedRightArrow | A notched block arrow that points right. |
|
| BentUpArrow | A block arrow that follows a sharp 90-degree angle and points up by default. |
|
| LeftRightArrow | A block arrow that points left and right. |
|
| UpDownArrow | A block arrow that points up and down. |
|
| LeftUpArrow | A block arrow that points left and up. |
|
| LeftRightUpArrow | A block arrow that points left, right, and up. |
|
| QuadArrow | A block arrow that points up, down, left, and right. |
|
| LeftArrowCallout | A callout with an arrow that points left. |
|
| RightArrowCallout | A callout with an arrow that points right. |
|
| UpArrowCallout | A callout with an arrow that points up. |
|
| DownArrowCallout | A callout with an arrow that points down. |
|
| LeftRightArrowCallout | A callout with arrows that point both left and right. |
|
| UpDownArrowCallout | A callout with arrows that point up and down. |
|
| QuadArrowCallout | A callout with arrows that point up, down, left, and right. |
|
| BentArrow | A block arrow that follows a curved 90-degree angle. |
|
| UTurnArrow | A block arrow that forms a U-shape. |
|
| CircularArrow | A block arrow that follows a curved 180-degree angle. |
|
| LeftCircularArrow | A circular arrow pointing counter-clockwise. |
|
| LeftRightCircularArrow | A circular arrow pointing both clockwise and counter-clockwise. |
|
| CurvedRightArrow | A block arrow that curves right. |
|
| CurvedLeftArrow | A block arrow that curves left. |
|
| CurvedUpArrow | A block arrow that curves up. |
|
| CurvedDownArrow | A block arrow that curves down. |
|
| SwooshArrow | A curved arrow. |
|
| Cube | A cube. |
|
| Can | A can. |
|
| LightningBolt | A lightning bolt. |
|
| Heart | A heart. |
|
| Sun | A sun shape. |
|
| Moon | A moon shape. |
|
| SmileyFace | A smiley face. |
|
| Explosion1 | An explosion shape. |
|
| Explosion2 | An explosion shape. |
|
| FoldedCorner | A rectangle with a folded corner. |
|
| Bevel | A bevel. |
|
| Frame | A rectangular picture frame. |
|
| HalfFrame | Half of a rectangular picture frame. |
|
| LShape | An L-shape. |
|
| DiagonalStripe | A diagonal stripe. |
|
| Chord | A circle with a chord. |
|
| Arc | An arc. |
|
| LeftBracket | An opening bracket. |
|
| RightBracket | A closing bracket. |
|
| LeftBrace | An opening brace. |
|
| RightBrace | A closing brace. |
|
| DoubleBracket | A pair of brackets. |
|
| DoubleBrace | A pair of braces. |
|
| LineCallout1 | A callout with no border and a straight callout line. |
|
| LineCallout2 | A callout with no border and a two-segment callout line. |
|
| LineCallout3 | A callout with no border and a three-segment callout line. |
|
| AccentLineCallout1 | A callout with an accent bar and a straight callout line. |
|
| AccentLineCallout2 | A callout with an accent bar and a two-segment callout line. |
|
| AccentLineCallout3 | A callout with an accent bar and a three-segment callout line. |
|
| BorderLineCallout1 | A callout with a border and a straight callout line. |
|
| BorderLineCallout2 | A callout with a border and a two-segment callout line. |
|
| BorderLineCallout3 | A callout with a border and a three-segment callout line. |
|
| AccentBorderLineCallout1 | A callout with a border, accent bar, and a straight callout line. |
|
| AccentBorderLineCallout2 | A callout with a border, accent bar, and a two-segment callout line. |
|
| AccentBorderLineCallout3 | A callout with a border, accent bar, and a three-segment callout line. |
|
| RectangularCallout | A rectangular callout. |
|
| RoundedRectangularCallout | A rectangular callout with rounded corners. |
|
| OvalCallout | An oval-shaped callout. |
|
| CloudCallout | A cloud callout. |
|
| Cloud | A cloud shape. |
|
| DownRibbon | A ribbon banner with its center area below the ribbon ends. |
|
| UpRibbon | A ribbon banner with its center area above the ribbon ends. |
|
| CurvedDownRibbon | A curved down ribbon banner. |
|
| CurvedUpRibbon | A curved up ribbon banner. |
|
| LeftRightRibbon | A ribbon with an arrow at both ends. |
|
| VerticalScroll | A vertical scroll. |
|
| HorizontalScroll | A horizontal scroll. |
|
| Wave | A wave. |
|
| DoubleWave | A double wave. |
|
| Cross | A cross. |
|
| FlowChartProcess | The Process flowchart symbol. |
|
| FlowChartDecision | The Decision flowchart symbol. |
|
| FlowChartInputOutput | The Input/Output (Data) flowchart symbol. |
|
| FlowChartPredefinedProcess | The Predefined Process flowchart symbol. |
|
| FlowChartInternalStorage | The Internal Storage flowchart symbol. |
|
| FlowChartDocument | The Document flowchart symbol. |
|
| FlowChartMultidocument | The Multi-document flowchart symbol. |
|
| FlowChartTerminator | The Terminator flowchart symbol. |
|
| FlowChartPreparation | The Preparation flowchart symbol. |
|
| FlowChartManualInput | The Manual Input flowchart symbol. |
|
| FlowChartManualOperation | The Manual Operation flowchart symbol. |
|
| FlowChartConnector | The Connector flowchart symbol. |
|
| FlowChartPunchedCard | The Card flowchart symbol. |
|
| FlowChartPunchedTape | The Punched Tape flowchart symbol. |
|
| FlowChartSummingJunction | The Summing Junction flowchart symbol. |
|
| FlowChartOr | The Or flowchart symbol. |
|
| FlowChartCollate | The Collate flowchart symbol. |
|
| FlowChartSort | The Sort flowchart symbol. |
|
| FlowChartExtract | The Extract flowchart symbol. |
|
| FlowChartMerge | The Merge flowchart symbol. |
|
| FlowChartOfflineStorage | The Offline Storage flowchart symbol. |
|
| FlowChartStoredData | The Stored Data flowchart symbol. |
|
| FlowChartMagneticTape | The Magnetic Tape (Sequential Access Storage) flowchart symbol. |
|
| FlowChartMagneticDisk | The Magnetic Disk flowchart symbol. |
|
| FlowChartDirectAccessStorage | The Direct Access Storage flowchart symbol. |
|
| FlowChartDisplay | The Display flowchart symbol. |
|
| FlowChartDelay | The Delay flowchart symbol. |
|
| FlowChartAlternateProcess | The Alternate Process flowchart symbol. |
|
| FlowChartOffpageConnector | The Off-page Connector flowchart symbol. |
|
| ActionButtonBlank | An empty button. |
|
| ActionButtonHome | The Home button. |
|
| ActionButtonHelp | The Help button. |
|
| ActionButtonInformation | The Information button. |
|
| ActionButtonForwardNext | The Forward or Next button. |
|
| ActionButtonBackPrevious | The Back or Previous button. |
|
| ActionButtonEnd | The End button. |
|
| ActionButtonBeginning | The Beginning button. |
|
| ActionButtonReturn | The Return button. |
|
| ActionButtonDocument | The Document button. |
|
| ActionButtonSound | The Sound button. |
|
| ActionButtonMovie | The Movie button. |
|
| Gear6 | A gear with six teeth. |
|
| Gear9 | A gear with nine teeth. |
|
| Funnel | A funnel. |
|
| Plus | A plus sign. |
|
| Minus | A minus sign. |
|
| Multiply | A multiplication sign. |
|
| Division | A division sign. |
|
| Equal | An equal sign. |
|
| NotEqual | A not-equal sign. |
|
| CornerTabs | Four right triangles that define a rectangular shape. |
|
| SquareTabs | Four small squares that define a rectangular shape. |
|
| PlaqueTabs | Four quarter circles that define a rectangular shape. |
|
| ChartX | A rectangle divided into four parts along diagonal lines. |
|
| ChartStar | A rectangle divided into six parts along a vertical line and diagonal lines. |
|
| ChartPlus | A rectangle divided vertically and horizontally into four quarters. |
|
Remarks
Use the Preset property to change an existing picture’s geometry. The example below shows how to insert a picture with rounded corners.
// Insert a picture.
Shape picture = document.Shapes.InsertPicture(document.Range.Start, DocumentImageSource.FromFile("Dog.png"));
// Change the picture's form.
picture.PictureFormat.Preset = ShapeGeometryPreset.RoundedRectangle;
// Display a border around the picture.
picture.Line.Color = Color.Black;
picture.Line.Thickness = 3;
// Align the picture.
picture.VerticalAlignment = ShapeVerticalAlignment.Top;
picture.HorizontalAlignment = ShapeHorizontalAlignment.Center;
' Insert a picture.
Dim picture As Shape = document.Shapes.InsertPicture(document.Range.Start, DocumentImageSource.FromFile("Dog.png"))
' Change the picture's form.
picture.PictureFormat.Preset = ShapeGeometryPreset.RoundedRectangle
' Display a border around the picture.
picture.Line.Color = Color.Black
picture.Line.Thickness = 3
' Align the picture.
picture.VerticalAlignment = ShapeVerticalAlignment.Top
picture.HorizontalAlignment = ShapeHorizontalAlignment.Center