PptxGenJS

Appearance

@shbernal/pptxgenjs

@shbernal/pptxgenjs / index / GroupProps

Interface: GroupProps ​

Defined in: core-interfaces.ts:3089

Options for slide.addGroup().

The group keeps an identity child coordinate space (chOff/chExt == off/ext) at every depth: children — including nested groups — keep their slide-absolute x/y/w/h. When x/y/w/h are omitted the group's bounds are auto-computed as the bounding box of its children.

Extends ​

Properties ​

altText? ​

optional altText?: string

Defined in: core-interfaces.ts:800

Alt Text value ("How would you describe this object and its contents to someone who is blind?")

  • serialized to the generated object's p:cNvPr descr attribute
  • PowerPoint: [right-click on the object] > "Edit Alt Text..."

Example ​

ts
'Quarterly revenue bar chart'

Inherited from ​

ObjectNameProps.altText

flipH? ​

optional flipH?: boolean

Defined in: core-interfaces.ts:3093

Flip the group horizontally

flipV? ​

optional flipV?: boolean

Defined in: core-interfaces.ts:3095

Flip the group vertically

h? ​

optional h?: Coord

Defined in: core-interfaces.ts:61

Height

  • inches or percentage

Examples ​

ts
10.25 // height in inches
ts
'75%' // height as percentage of slide size

Inherited from ​

PositionProps.h

objectLock? ​

optional objectLock?: ObjectLockProps

Defined in: core-interfaces.ts:811

Object lock flags (DrawingML a:spLocks / a:picLocks / a:graphicFrameLocks)

  • restrict how the object can be manipulated in PowerPoint (e.g. prevent moving, resizing, or grouping)
  • each flag maps 1:1 to the OOXML attribute of the same name; only flags set to true are emitted
  • PowerPoint UI: Selection Pane / right-click protections (most locks are honored at edit time, not as a password)
  • flags only apply to the object types that support them (see each flag); flags set on an unsupported object type are ignored with a console warning

Examples ​

ts
{ noMove: true, noResize: true } // pin an object in place
ts
{ noGrp: true } // exclude from grouping

Inherited from ​

ObjectNameProps.objectLock

objectName? ​

optional objectName?: string

Defined in: core-interfaces.ts:793

Object name

  • used instead of default "Object N" name
  • PowerPoint: Home > Arrange > Selection Pane...

Default ​

ts
'Object 1'

Example ​

ts
'Antenna Design 9'

Inherited from ​

ObjectNameProps.objectName

rotate? ​

optional rotate?: number

Defined in: core-interfaces.ts:3091

Rotation in degrees (applied to the whole group)

w? ​

optional w?: Coord

Defined in: core-interfaces.ts:68

Width

  • inches or percentage

Examples ​

ts
10.25 // width in inches
ts
'75%' // width as percentage of slide size

Inherited from ​

PositionProps.w

x? ​

optional x?: Coord

Defined in: core-interfaces.ts:47

Horizontal position

  • inches or percentage

Examples ​

ts
10.25 // position in inches
ts
'75%' // position as percentage of slide size

Inherited from ​

PositionProps.x

y? ​

optional y?: Coord

Defined in: core-interfaces.ts:54

Vertical position

  • inches or percentage

Examples ​

ts
10.25 // position in inches
ts
'75%' // position as percentage of slide size

Inherited from ​

PositionProps.y