PowerPoint.ParagraphFormat class

包:: powerpoint

表示附加到 PowerPoint.TextRange 的文本的段落格式属性。

扩展: OfficeExtension.ClientObject

注解

使用方

PowerPoint.TextRange： paragraphFormat

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/text/get-set-textrange.yaml

// Gets navigational (complex) properties of the selected text range.
await PowerPoint.run(async (context) => {
  const textRange: PowerPoint.TextRange = context.presentation.getSelectedTextRange();
  textRange.load("font,paragraphFormat/bulletFormat,paragraphFormat/horizontalAlignment");

  const parentTextFrame: PowerPoint.TextFrame = textRange.getParentTextFrame();
  const parentShape: PowerPoint.Shape = parentTextFrame.getParentShape();
  const parentSlide: PowerPoint.Slide = parentShape.getParentSlide();
  parentShape.load("id");
  parentSlide.load("id");
  await context.sync();

  console.log(`Selected text range found in parent shape with ID ${parentShape.id} on parentSlide with ID ${parentSlide.id}`);

  console.log("Font properties of selected text range:");
  console.log(`\tallCaps: ${textRange.font.allCaps}`);
  console.log(`\tbold: ${textRange.font.bold}`);
  console.log(`\tcolor: ${textRange.font.color}`);
  console.log(`\tdoubleStrikethrough: ${textRange.font.doubleStrikethrough}`);
  console.log(`\titalic: ${textRange.font.italic}`);
  console.log(`\tname: ${textRange.font.name}`);
  console.log(`\tsize: ${textRange.font.size}`);
  console.log(`\tsmallCaps: ${textRange.font.smallCaps}`);
  console.log(`\tstrikethrough: ${textRange.font.strikethrough}`);
  console.log(`\tsubscript: ${textRange.font.subscript}`);
  console.log(`\tsuperscript: ${textRange.font.superscript}`);
  console.log(`\tunderline: ${textRange.font.underline}`);

  console.log("Paragraph format properties of selected text range:");
  console.log(`\tbulletFormat.visible: ${textRange.paragraphFormat.bulletFormat.visible}`);
  console.log(`\thorizontalAlignment: ${textRange.paragraphFormat.horizontalAlignment}`);
});

属性

bulletFormat	表示段落的项目符号格式。有关详细信息，请参阅 PowerPoint.BulletFormat 。
context	与对象关联的请求上下文。这将加载项的进程连接到 Office 主机应用程序的进程。
horizontalAlignment	表示段落的水平对齐方式。如果 'TextRange' 包含具有不同水平对齐值的文本片段，则返回 'null'。有关详细信息，请参阅 PowerPoint.ParagraphHorizontalAlignment 。
indentLevel	表示段落的缩进级别。

方法

load(options)	将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 `context.sync()`。
load(propertyNames)	将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 `context.sync()`。
load(propertyNamesAndPaths)	将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 `context.sync()`。
toJSON()	覆盖 JavaScript `toJSON()` 方法，以便在将 API 对象传递给 `JSON.stringify()`时提供更有用的输出。 (`JSON.stringify`反过来调用 `toJSON` 传递给它的对象的方法。) 虽然原始 `PowerPoint.ParagraphFormat` 对象是 API 对象， `toJSON` 但该方法返回一个纯 JavaScript 对象， (类型化为 `PowerPoint.Interfaces.ParagraphFormatData`) ，其中包含从原始对象加载的任何子属性的浅层副本。

属性详细信息

bulletFormat

表示段落的项目符号格式。有关详细信息，请参阅 PowerPoint.BulletFormat 。

readonly bulletFormat: PowerPoint.BulletFormat;

属性值

PowerPoint.BulletFormat

注解

API 集：PowerPointApi 1.4

context

与对象关联的请求上下文。这将加载项的进程连接到 Office 主机应用程序的进程。

context: RequestContext;

属性值

PowerPoint.RequestContext

horizontalAlignment

表示段落的水平对齐方式。如果 'TextRange' 包含具有不同水平对齐值的文本片段，则返回 'null'。有关详细信息，请参阅 PowerPoint.ParagraphHorizontalAlignment 。

horizontalAlignment: PowerPoint.ParagraphHorizontalAlignment | "Left" | "Center" | "Right" | "Justify" | "JustifyLow" | "Distributed" | "ThaiDistributed" | null;

属性值

注解

API 集：PowerPointApi 1.4

indentLevel

表示段落的缩进级别。

indentLevel: number;

属性值

number

注解

API 集：PowerPointApi 1.10

方法详细信息

load(options)

将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 context.sync()。

load(options?: PowerPoint.Interfaces.ParagraphFormatLoadOptions): PowerPoint.ParagraphFormat;

参数

options: PowerPoint.Interfaces.ParagraphFormatLoadOptions

为要加载的对象属性提供选项。

PowerPoint.ParagraphFormat

load(propertyNames)

将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 context.sync()。

load(propertyNames?: string | string[]): PowerPoint.ParagraphFormat;

参数

propertyNames: string | string[]

指定要加载的属性的逗号分隔的字符串或字符串数组。

PowerPoint.ParagraphFormat

load(propertyNamesAndPaths)

将命令加入队列以加载对象的指定属性。阅读属性前必须先调用 context.sync()。

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): PowerPoint.ParagraphFormat;

参数

propertyNamesAndPaths: { select?: string; expand?: string; }

propertyNamesAndPaths.select 是指定要加载的属性的逗号分隔字符串，以及 propertyNamesAndPaths.expand 指定要加载的导航属性的逗号分隔字符串。

PowerPoint.ParagraphFormat

toJSON()

覆盖 JavaScript toJSON() 方法，以便在将 API 对象传递给 JSON.stringify()时提供更有用的输出。 (JSON.stringify反过来调用 toJSON 传递给它的对象的方法。) 虽然原始 PowerPoint.ParagraphFormat 对象是 API 对象， toJSON 但该方法返回一个纯 JavaScript 对象， (类型化为 PowerPoint.Interfaces.ParagraphFormatData) ，其中包含从原始对象加载的任何子属性的浅层副本。

toJSON(): PowerPoint.Interfaces.ParagraphFormatData;

PowerPoint.Interfaces.ParagraphFormatData

反馈

此页面是否有帮助？