20.1.2 基础¶

中文英文

本节描述与 DrawingML 框架相关的所有基本常见元素。

Basics

This section describes all the basic common elements associated with the DrawingML framework.

20.1.2.1 测量单位 EMU¶

中文英文

在整个 ECMA-376 中，EMU 用作长度测量单位。 EMU的定义如下：

1 emu \(=\frac{1}{914400}\) US 英尺(inch) \(=\frac{1}{360000}\) 厘米(cm)

Rationale

EMU 的创建是为了能够均匀划分英制和公制单位，以避免计算过程中的舍入错误。 EMU 的使用还促进了使用不同测量单位的不同区域之间更加无缝的系统切换和互操作性。 EMU 定义了一个基于整数的高精度坐标系。

EMU Unit of Measurement

Throughout ECMA-376, the EMU is used as a unit of measurement for length. An EMU is defined as follows:

1 emu \(=\frac{1}{914400}\) US inch \(=\frac{1}{360000}\) cm

[Rationale: The EMU was created in order to be able to evenly divide in both English and Metric units, in order to avoid rounding errors during the calculation. The usage of EMUs also facilitates a more seamless system switch and interoperability between different locales utilizing different units of measurement. EMUs define an integer based, high precision coordinate system. end rationale]

20.1.2.2 核心绘图对象信息¶

中文英文

在 DrawingML 中，存在核心绘图元素的概念。这些元素对于 DrawingML 框架至关重要且很常见。这些元素表示 DrawingML 文档结构中最完整的部分，因此是使用最广泛的元素之一。

Note

测量单位 - 长度单位必须以与设备无关的物理单位表示：英制公制单位 (EMU)、点(points)、派卡(pica)和英寸(inche)。不得使用与设备相关的单位，例如像素。

Core Drawing Object Information

Within DrawingML, there is the notion of core drawing elements. These are elements that both are vital to and common across the DrawingML framework. These elements denote the most integral pieces of the DrawingML document structure and thus are among the most widely used.

[Note: Measurement Units - Length units must be expressed in device-independent physical units: English Metric units (EMUs), points, picas, and inches. Device-dependent units such as pixels must not be used. end note]

20.1.2.2.1 bldChart (构建图表)¶

中文英文

该元素指定如何构建图表的动画。

Example

考虑以下示例，其中图表被指定为按类别而不是作为一个实体进行动画处理。因此，bldChart 元素应按如下方式使用：

<p:bdldLst>
    <p:bldGraphic spid="4" grpId="0">
        <p:bldSub>
            <a:bldChart bld="category"/>
        </p:bldSub>
    </p:bldGraphic>
</p:bldLst>

Attributes	Description
animBg (动画背景)	指定图表背景元素是否也应设置动画. [Note: 背景元素的示例是网格线和图表图例. end note] 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
bld (建造)	指定图表的构建方式。动画按照此属性定义的特定顺序对容器中的子元素进行动画处理. 此属性的可能值由 ST_AnimationChartBuildType 简单类型 (§20.1.10.5) 定义。

[Note: 该元素内容模型 (CT_AnimationChartBuildProperties) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

bldChart (Build Chart)

This element specifies how to build the animation for a diagram.

Example

Consider the following example where a chart is specified to be animated by category rather than as one entity. Thus, the bldChart element should be used as follows:

<p:bdldLst>
    <p:bldGraphic spid="4" grpId="0">
        <p:bldSub>
            <a:bldChart bld="category"/>
        </p:bldSub>
    </p:bldGraphic>
</p:bldLst>

Attributes	Description
animBg (Animate Background)	Specifies whether or not the chart background elements should be animated as well. [Note: An example of background elements are grid lines and the chart legend. end note] The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
bld (Build)	Specifies how the chart is built. The animation animates the sub-elements in the container in the particular order defined by this attribute. The possible values for this attribute are defined by the ST_AnimationChartBuildType simple type (§20.1.10.5).

[Note: The W3C XML Schema definition of this element’s content model (CT_AnimationChartBuildProperties) is located in §A.4.1. end note]

20.1.2.2.2 bldDgm (构建图)¶

中文英文

该元素指定如何构建图表的动画。

Example

考虑让图表显示为实体而不是部分。 bldDgm 元素应按如下方式使用：

<p:bdldLst>
    <p:bldGraphic spid="4" grpId="0">
        <p:bldSub>
            <a:bldDgm bld="one"/>
        </p:bldSub>
    </p:bldGraphic>
</p:bldLst>

Attributes	Description
bld (建造)	指定图表的构建方式。动画按照此属性定义的特定顺序对容器中的子元素进行动画处理. 此属性的可能值由 ST_AnimationDgmBuildType 简单类型 (§20.1.10.7) 定义。
rev (Reverse Animation)	指定该图中对象的动画是否应该反转。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.

[Note: 这个元素的内容模型（CT_AnimationDgmBuildProperties）的 W3C XML Schema定义位于§A.4.1。 end note]

bldDgm (Build Diagram)

This element specifies how to build the animation for a diagram.

Example

Consider having a diagram appear as on entity as opposed to by section. The bldDgm element should be used as follows:

<p:bdldLst>
    <p:bldGraphic spid="4" grpId="0">
        <p:bldSub>
            <a:bldDgm bld="one"/>
        </p:bldSub>
    </p:bldGraphic>
</p:bldLst>

Attributes	Description
bld (Build)	Specifies how the chart is built. The animation animates the sub-elements in the container in the particular order defined by this attribute. The possible values for this attribute are defined by the ST_AnimationDgmBuildType simple type (§20.1.10.7).
rev (Reverse Animation)	Specifies whether the animation of the objects in this diagram should be reversed or not. If this attribute is not specified, a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_AnimationDgmBuildProperties) is located in §A.4.1. end note]

20.1.2.2.3 chart (图表动画)¶

中文英文

该元素指定了在幻灯片动画序列中应该被动画的图表的引用。除了作为对图表的引用之外，还定义了动画构建步骤。

Attributes	Description
bldStep (动画构建步骤)	指定使用哪个步骤来构建图表的这一部分。例如，图表可以作为一个整体构建，这意味着它将作为一个单一的图形进行动画。另外，图表也可以进行动画，或者作为单独的部分构建。. 这个属性的可能取值由ST_ChartBuildStep简单类型（§20.1.10.13）定义。
categoryIdx (类别索引)	指定应在相应图表中进行动画处理的类别索引。此属性的可能值由 W3C XML Schema int 数据类型定义.
seriesIdx (系列索引)	指定应设置动画的相应图表中的系列索引. 此属性的可能值由 W3C XML Schema int 数据类型定义.

[Note: 该元素内容模型 (CT_AnimationChartElement) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

chart (Chart to Animate)

This element specifies a reference to a chart that should be animated within a sequence of slide animations. In addition to simply acting as a reference to a chart there is also animation build steps defined.

Attributes	Description
bldStep (Animation Build Step)	Specifies which step this part of the chart should be built using. For instance the chart can be built as one object meaning it is animated as a single graphic. Alternatively the chart can be animated, or built as separate pieces. The possible values for this attribute are defined by the ST_ChartBuildStep simple type (§20.1.10.13).
categoryIdx (Category Index)	Specifies the index of the category within the corresponding chart that should be animated. The possible values for this attribute are defined by the W3C XML Schema int datatype.
seriesIdx (Series Index)	Specifies the index of the series within the corresponding chart that should be animated. The possible values for this attribute are defined by the W3C XML Schema int datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_AnimationChartElement) is located in §A.4.1. end note]

20.1.2.2.4 cNvCxnSpPr (非可视连接器形状绘图属性)¶

中文英文

此元素指定连接器形状的非可视绘图属性。这些非视觉属性是生成应用程序在渲染幻灯片表面时将使用的属性。

[Note: 该元素内容模型 (CT_NonVisualConnectorProperties) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

cNvCxnSpPr (Non-Visual Connector Shape Drawing Properties)

This element specifies the non-visual drawing properties for a connector shape. These non-visual properties are properties that the generating application would utilize when rendering the slide surface.

[Note: The W3C XML Schema definition of this element’s content model (CT_NonVisualConnectorProperties) is located in §A.4.1. end note]

20.1.2.2.5 cNvGraphicFramePr (非可视图形框架绘图属性)¶

中文英文

该元素指定图形框架的非可视绘图属性。这些非视觉属性是生成应用程序在渲染幻灯片表面时将使用的属性。

[Note: 该元素内容模型 (CT_NonVisualGraphicFrameProperties) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

cNvGraphicFramePr (Non-Visual Graphic Frame Drawing Properties)

This element specifies the non-visual drawing properties for a graphic frame. These non-visual properties are properties that the generating application would utilize when rendering the slide surface.

[Note: The W3C XML Schema definition of this element’s content model (CT_NonVisualGraphicFrameProperties) is located in §A.4.1. end note]

20.1.2.2.6 cNvGrpSpPr (非可视组形状绘图属性)¶

中文英文

此元素指定组形状的非可视绘图属性。这些非视觉属性是生成应用程序在渲染幻灯片表面时将使用的属性。

[Note: 此元素内容模型 (CT_NonVisualGroupDrawingShapeProps) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

cNvGrpSpPr (Non-Visual Group Shape Drawing Properties)

This element specifies the non-visual drawing properties for a group shape. These non-visual properties are properties that the generating application would utilize when rendering the slide surface.

[Note: The W3C XML Schema definition of this element’s content model (CT_NonVisualGroupDrawingShapeProps) is located in §A.4.1. end note]

20.1.2.2.7 cNvPicPr (非视觉绘图属性)¶

中文英文

该元素指定图片画布的非视觉属性。生成应用程序将使用这些属性来确定如何更改所讨论的图片对象的某些属性。

Example

<p:pic>
    …
    <p:nvPicPr>
        <p:cNvPr id="4" name="Lilly_by_Lisher.jpg"/>
        <p:cNvPicPr>
            <a:picLocks noChangeAspect="1"/>
        </p:cNvPicPr>
        <p:nvPr/>
    </p:nvPicPr>
    …
</p:pic>

Attributes

Description

preferRelativeResize (首选相对调整大小)

指定用户界面是否应根据图片的当前大小或其原始大小显示图片的大小调整。如果此属性设置为 true，则缩放相对于原始图片大小而不是当前图片大小.

[Example: 考虑这样的情况：文档中的图片大小已调整，现在是原始插入图片大小的 50%。现在，如果用户选择稍后在生成应用程序中调整该图片的大小，则应检查该属性的值.

如果此属性设置为 true，则显示值 50%。同样，如果此属性设置为 false，则应显示 100% 的值，因为图片尚未从其当前（较小）尺寸调整大小. end example]

该属性的可能值由 W3C XML Schema 布尔数据类型定义.

[Note: 该元素内容模型 (CT_NonVisualPictureProperties) 的 W3C XML 架构定义位于 §A.4.1. end note]

cNvPicPr (Non-Visual Picture Drawing Properties)

This element specifies the non-visual properties for the picture canvas. These properties are to be used by the generating application to determine how certain properties are to be changed for the picture object in question.

Example

<p:pic>
    …
    <p:nvPicPr>
        <p:cNvPr id="4" name="Lilly_by_Lisher.jpg"/>
        <p:cNvPicPr>
            <a:picLocks noChangeAspect="1"/>
        </p:cNvPicPr>
        <p:nvPr/>
    </p:nvPicPr>
    …
</p:pic>

Attributes

Description

preferRelativeResize (Relative Resize Preferred)

Specifies if the user interface should show the resizing of the picture based on the picture's current size or its original size. If this attribute is set to true, then scaling is relative to the original picture size as opposed to the current picture size.

[Example: Consider the case where a picture has been resized within a document and is now 50% of the originally inserted picture size. Now if the user chooses to make a later adjustment to the size of this picture within the generating application, then the value of this attribute should be checked.

If this attribute is set to true then a value of 50% is shown. Similarly, if this attribute is set to false, then a value of 100% should be shown because the picture has not yet been resized from its current (smaller) size. end example]

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_NonVisualPictureProperties) is located in §A.4.1. end note]

20.1.2.2.8 cNvPr (非可视绘图属性)¶

中文英文

该元素指定非可视画布属性。这允许存储不影响图片外观的附加信息。

Example

考虑以下 DrawingML。

<p:pic>
    …
    <p:nvPicPr>
        <p:cNvPr id="4" name="Lilly_by_Lisher.jpg"/>
    </p:nvPicPr>
    …
</p:pic>

Attributes	Description
descr (对象的替代文本)	指定当前 DrawingML 对象的替代文本，供不显示当前对象的辅助技术或应用程序使用. 如果省略此元素，则父对象不存在替代文本. [Example: 考虑定义如下的 DrawingML 对象: `<… descr="A picture of a bowl of fruit">` descr 属性包含可替代实际 DrawingML 对象的替代文本. end example] 此属性的可能值由 W3C XML 架构字符串数据类型定义.
hidden (隐藏)	指定是否显示此 DrawingML 对象。当 DrawingML 对象在文档中显示时，该对象可以隐藏（即存在，但不可见）. 该属性决定对象是渲染还是隐藏。 [Note：应用程序可以具有允许查看此对象的设置. end note] 如果省略此属性，则应显示父 DrawingML 对象（即不隐藏）. [Example: 考虑一个必须隐藏在文档内容中的内联 DrawingML 对象。该设置将指定如下: `<… hidden="true" />` hide 属性的值为 true，它指定 DrawingML 对象是隐藏的，并且在显示文档时不显示. end example] 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
id (唯一标识符)	指定当前文档中当前 DrawingML 对象的唯一标识符。该 ID 可用于帮助唯一标识该对象，以便文档的其他部分可以引用它. 如果同一文档中的多个对象共享相同的 id 属性值，则该文档应被视为不合格. [Example: 考虑定义如下的 DrawingML 对象: `<… id="10" … >` id 属性的值为 10，这是此 DrawingML 对象的唯一标识符. end example] 此属性的可能值由 ST_DrawingElementId 简单类型 (§20.1.10.21) 定义。
name (名称)	指定对象的名称. [Note: 通常，这用于存储图片对象的原始文件名. end note] [Example: 考虑定义如下的 DrawingML 对象: `< … name="foo.jpg" >` name 属性的值为 foo.jpg，这是此 DrawingML 对象的名称. end example] 此属性的可能值由 W3C XML 架构字符串数据类型定义.
title (标题)	指定当前 DrawingML 对象的标题 (caption). 如果省略此属性，则父对象不存在标题文本. [Example: 考虑定义如下的 DrawingML 对象: `<… title="Process Flow Diagram">` end example] 此属性的可能值由 W3C XML 架构字符串数据类型定义.

[Note: 该元素内容模型 (CT_NonVisualDrawingProps) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

cNvPr (Non-Visual Drawing Properties)

This element specifies non-visual canvas properties. This allows for additional information that does not affect the appearance of the picture to be stored.

Example

Consider the following DrawingML.

<p:pic>
    …
    <p:nvPicPr>
        <p:cNvPr id="4" name="Lilly_by_Lisher.jpg"/>
    </p:nvPicPr>
    …
</p:pic>

Attributes	Description
descr (Alternative Text for Object)	Specifies alternative text for the current DrawingML object, for use by assistive technologies or applications which do not display the current object. If this element is omitted, then no alternative text is present for the parent object. [Example: Consider a DrawingML object defined as follows: `<… descr="A picture of a bowl of fruit">` The descr attribute contains alternative text which can be used in place of the actual DrawingML object. end example] The possible values for this attribute are defined by the W3C XML Schema string datatype.
hidden (Hidden)	Specifies whether this DrawingML object is displayed. When a DrawingML object is displayed within a document, that object can be hidden (i.e., present, but not visible). This attribute determines whether the object is rendered or made hidden. [Note: An application can have settings which allow this object to be viewed. end note] If this attribute is omitted, then the parent DrawingML object shall be displayed (i.e., not hidden). [Example: Consider an inline DrawingML object which must be hidden within the document's content. This setting would be specified as follows: `<… hidden="true" />` The hidden attribute has a value of true, which specifies that the DrawingML object is hidden and not displayed when the document is displayed. end example] The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
id (Unique Identifier)	Specifies a unique identifier for the current DrawingML object within the current document. This ID can be used to assist in uniquely identifying this object so that it can be referred to by other parts of the document. If multiple objects within the same document share the same id attribute value, then the document shall be considered non-conformant. [Example: Consider a DrawingML object defined as follows: `<… id="10" … >` The id attribute has a value of 10, which is the unique identifier for this DrawingML object. end example] The possible values for this attribute are defined by the ST_DrawingElementId simple type (§20.1.10.21).
name (Name)	Specifies the name of the object. [Note: Typically, this is used to store the original file name of a picture object. end note] [Example: Consider a DrawingML object defined as follows: `< … name="foo.jpg" >` The name attribute has a value of foo.jpg, which is the name of this DrawingML object. end example] The possible values for this attribute are defined by the W3C XML Schema string datatype.
title (Title)	Specifies the title (caption) of the current DrawingML object. If this attribute is omitted, then no title text is present for the parent object. [Example: Consider a DrawingML object defined as follows: `<… title="Process Flow Diagram">` end example] The possible values for this attribute are defined by the W3C XML Schema string datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_NonVisualDrawingProps) is located in §A.4.1. end note]

20.1.2.2.9 cNvSpPr (非视觉形状绘图属性)¶

中文英文

该元素指定形状的非可视绘图属性。生成应用程序将使用这些属性来确定如何处理形状

Example

考虑应用了形状锁定的形状。

<p:sp>
    <p:nvSpPr>
        <p:cNvPr id="2" name="Rectangle 1"/>
        <p:cNvSpPr>
            <a:spLocks noGrp="1"/>
        </p:cNvSpPr>
    </p:nvSpPr>
    …
</p:sp>

该形状锁存储在该形状的非可视绘图属性中。

Attributes	Description
txBox (文本框)	指定相应的形状是文本框，因此生成应用程序应将其视为文本框。如果省略此属性，则假定相应的形状不是特定的文本框. [Note: 由于形状未指定为文本框，并不意味着它不能附加文本。文本框只是具有特定属性的特殊形状. end note] 该属性的可能值由 W3C XML Schema 布尔数据类型定义.

[Note: 该元素内容模型 (CT_NonVisualDrawingShapeProps) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

Non-Visual Shape Drawing Properties

This element specifies the non-visual drawing properties for a shape. These properties are to be used by the generating application to determine how the shape should be dealt with

Example

Consider the shape that has a shape lock applied to it.

<p:sp>
    <p:nvSpPr>
        <p:cNvPr id="2" name="Rectangle 1"/>
        <p:cNvSpPr>
            <a:spLocks noGrp="1"/>
        </p:cNvSpPr>
    </p:nvSpPr>
    …
</p:sp>

This shape lock is stored within the non-visual drawing properties for this shape.

Attributes

Description

txBox (Text Box)

Specifies that the corresponding shape is a text box and thus should be treated as such by the generating application. If this attribute is omitted then it is assumed that the corresponding shape is not specifically a text box.

[Note: Because a shape is not specified to be a text box does not mean that it cannot have text attached to it. A text box is merely a specialized shape with specific properties. end note]

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_NonVisualDrawingShapeProps) is located in §A.4.1. end note]

20.1.2.2.10 cxnSp (连接形状)¶

中文英文

该元素指定用于连接两个 sp 元素的连接形状。使用 cxnSp 指定连接后，生成应用程序将确定连接器采用的确切路径。

也就是说，连接器路由算法由生成的应用程序决定，因为所需的路径可能会根据应用程序的特定需求而有所不同。

Example

考虑以下连接两个常规形状的连接器形状。

<p:spTree>
    …
    <p:sp>
        <p:nvSpPr>
            <p:cNvPr id="1" name="Rectangle 1"/>
            <p:cNvSpPr/>
            <p:nvPr/>
        </p:nvSpPr>
        …
    </p:sp>
    <p:sp>
        <p:nvSpPr>
            <p:cNvPr id="2" name="Rectangle 2"/>
            <p:cNvSpPr/>
            <p:nvPr/>
        </p:nvSpPr>
        …
    </p:sp>
    <p:cxnSp>
        <p:nvCxnSpPr>
            <p:cNvPr id="3" name="Elbow Connector 3"/>
            <p:cNvCxnSpPr>
                <a:stCxn id="1" idx="3"/>
                <a:endCxn id="2" idx="1"/>
            </p:cNvCxnSpPr>
            <p:nvPr/>
        </p:nvCxnSpPr>
        …
    </p:cxnSp>
</p:spTree>

[Note: 该元素内容模型 (CT_GvmlConnector) 的 W3C XML 架构定义位于 §A.4.1. end note]

cxnSp (Connection Shape)

This element specifies a connection shape that is used to connect two sp elements. Once a connection is specified using a cxnSp, it is left to the generating application to determine the exact path the connector takes.

That is the connector routing algorithm is left up to the generating application as the desired path might be different depending on the specific needs of the application.

Example

Consider the following connector shape that connects two regular shapes.

<p:spTree>
    …
    <p:sp>
        <p:nvSpPr>
            <p:cNvPr id="1" name="Rectangle 1"/>
            <p:cNvSpPr/>
            <p:nvPr/>
        </p:nvSpPr>
        …
    </p:sp>
    <p:sp>
        <p:nvSpPr>
            <p:cNvPr id="2" name="Rectangle 2"/>
            <p:cNvSpPr/>
            <p:nvPr/>
        </p:nvSpPr>
        …
    </p:sp>
    <p:cxnSp>
        <p:nvCxnSpPr>
            <p:cNvPr id="3" name="Elbow Connector 3"/>
            <p:cNvCxnSpPr>
                <a:stCxn id="1" idx="3"/>
                <a:endCxn id="2" idx="1"/>
            </p:cNvCxnSpPr>
            <p:nvPr/>
        </p:nvCxnSpPr>
        …
    </p:cxnSp>
</p:spTree>

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlConnector) is located in §A.4.1. end note]

20.1.2.2.11 cxnSpLocks (连接形状锁)¶

中文英文

该元素指定连接形状的所有锁定属性。这些属性向生成应用程序通知先前已锁定的特定属性，因此不应更改。

Attributes	Description
noAdjustHandles (禁止显示调整手柄)	指定生成应用程序不应显示相应连接形状的调整手柄。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noChangeArrowheads (禁止箭头更改)	指定生成应用程序不应允许更改相应连接形状的箭头。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noChangeAspect (禁止更改宽高比)	指定生成应用程序不应允许更改相应连接形状的纵横比。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noChangeShapeType (禁止形状类型更改)	指定生成应用程序不应允许更改相应连接形状的形状类型。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noEditPoints (禁止形状点编辑)	指定生成应用程序不应允许更改相应连接形状的形状点。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noGrp (禁止形状分组)	指定生成应用程序不应允许对相应连接形状进行形状分组。也就是说，它不能与其他形状组合以形成一组形状。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noMove (禁止形状移动)	指定生成应用程序不应允许相应连接形状的位置更改。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noResize (禁止调整形状大小)	指定生成应用程序不应允许更改相应连接形状的尺寸。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noRot (禁止形状旋转)	指定生成应用程序不应允许相应连接形状的形状旋转更改。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noSelect (禁止选择形状)	指定生成应用程序不应允许选择相应的连接形状。这还意味着，如果指定了此属性，则无法选择附加到此连接形状的图片、形状或文本。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.

[Note: 该元素内容模型 (CT_ConnectorLocking) 的 W3C XML 架构定义位于 §A.4.1. end note]

cxnSpLocks (Connection Shape Locks)

This element specifies all locking properties for a connection shape. These properties inform the generating application about specific properties that have been previously locked and thus should not be changed.

Attributes	Description
noAdjustHandles (Disallow Showing Adjust Handles)	Specifies that the generating application should not show adjust handles for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeArrowheads (Disallow Arrowhead Changes)	Specifies that the generating application should not allow arrowhead changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema booleandatatype.
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeShapeType (Disallow ShapeType Change)	Specifies that the generating application should not allow shape type changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noEditPoints (Disallow Shape Point Editing)	Specifies that the generating application should not allow shape point changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the generating application should not allow shape grouping for the corresponding connection shape. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noMove (Disallow Shape Movement)	Specifies that the generating application should not allow position changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noResize (Disallow Shape Resize)	Specifies that the generating application should not allow size changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noRot (Disallow Shape Rotation)	Specifies that the generating application should not allow shape rotation changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the generating application should not allow selecting of the corresponding connection shape. That means also that no picture, shapes or text attached to this connection shape can be selected if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_ConnectorLocking) is located in §A.4.1. end note]

20.1.2.2.12 dgm (图表动画)¶

中文英文

此元素指定对应在幻灯片动画序列中进行动画处理的图表的引用。

除了简单地充当图表的参考之外，还定义了动画构建步骤。

Attributes	Description
bldStep (动画构建步骤)	指定应使用哪个步骤来构建图的这一部分。例如，图表可以构建为一个对象，这意味着它可以作为单个图形进行动画处理。或者，图表可以是动画的，或者构建为单独的部分. 此属性的可能值由 ST_DgmBuildStep 简单类型 (§20.1.10.20) 定义。
id (标识符)	指定动画中此构建步骤的形状的 GUID. 该属性的可能值由 ST_Guid 简单类型定义 (§22.9.2.4).

[Note: 该元素内容模型 (CT_AnimationDgmElement) 的 W3C XML 架构定义位于 §A.4.1. end note]

dgm (Diagram to Animate)

This element specifies a reference to a diagram that should be animated within a sequence of slide animations.

In addition to simply acting as a reference to a diagram there is also animation build steps defined.

Attributes	Description
bldStep (Animation Build Step)	Specifies which step this part of the diagram should be built using. For instance the diagram can be built as one object meaning it is animated as a single graphic. Alternatively the diagram can be animated, or built as separate pieces. The possible values for this attribute are defined by the ST_DgmBuildStep simple type (§20.1.10.20).
id (Identifier)	Specifies the GUID of the shape for this build step in the animation. The possible values for this attribute are defined by the ST_Guid simple type (§22.9.2.4).

[Note: The W3C XML Schema definition of this element’s content model (CT_AnimationDgmElement) is located in §A.4.1. end note]

20.1.2.2.13 endCxn (连接结束)¶

中文英文

该元素指定应由相应连接器形状形成的结束连接。这会将连接器的尾部连接到最终目标形状。

Attributes	Description
id (标识符)	指定要进行最终连接的形状的 id. 该属性的可能值由 ST_DrawingElementId 简单类型定义 (§20.1.10.21).
idx (索引)	指定最终连接形状的连接站点表的索引。即一个形状上有很多连接点，需要指定对应的连接器形状应该连接到哪个连接点. 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。

[Note: 该元素内容模型 (CT_Connection) 的 W3C XML 模式定义位于 §A.4.1 中。 end note]

endCxn (Connection End)

This element specifies the ending connection that should be made by the corresponding connector shape. This connects the end tail of the connector to the final destination shape.

Attributes	Description
id (Identifier)	Specifies the id of the shape to make the final connection to. The possible values for this attribute are defined by the ST_DrawingElementId simple type (§20.1.10.21).
idx (Index)	Specifies the index into the connection site table of the final connection shape. That is there are many connection sites on a shape and it shall be specified which connection site the corresponding connector shape should connect to. The possible values for this attribute are defined by the W3C XML Schema unsignedInt datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_Connection) is located in §A.4.1. end note]

20.1.2.2.14 ext (扩展)¶

中文英文

此元素指定用于将来对 DrawingML 当前版本进行扩展的扩展。这允许将来指定当前未知的元素，用于生成应用程序的更高版本。

[Note: 该元素无意将过渡模式重新引入严格一致性类别. end note]

Attributes	Description
uri (统一资源标识符)	指定表示存储在该标签下的数据的 URI 或统一资源标识符。 URI 用于识别可以处理此标签内容的正确“服务器”. 此属性的可能值由 W3C XML 架构token数据类型定义.

[Note: 此属性的可能值由 W3C XML 架构令牌数据类型定义。 end note]

ext (Extension)

This element specifies an extension that is used for future extensions to the current version of DrawingML. This allows for the specifying of currently unknown elements in the future that is used for later versions of generating applications.

[Note: This element is not intended to reintroduce transitional schema into the strict conformance class. end note]

Attributes	Description
uri (Uniform Resource Identifier)	Specifies the URI, or uniform resource identifier that represents the data stored under this tag. The URI is used to identify the correct 'server' that can process the contents of this tag. The possible values for this attribute are defined by the W3C XML Schema token datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_OfficeArtExtension) is located in §A.4.1. end note]

20.1.2.2.15 extLst (扩展列表)¶

中文英文

该元素指定扩展列表，在其中定义元素类型 ext 的所有未来扩展。扩展列表以及相应的未来扩展用于扩展 DrawingML 框架的存储功能。这允许各种新类型的数据本地存储在框架内。

[Note: 此元素的内容模型 (CT_OfficeArtExtensionList) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

extLst (Extension List)

This element specifies the extension list within which all future extensions of element type ext is defined. The extension list along with corresponding future extensions is used to extend the storage capabilities of the DrawingML framework. This allows for various new types of data to be stored natively within the framework.

[Note: The W3C XML Schema definition of this element’s content model (CT_OfficeArtExtensionList) is located in §A.4.1. end note]

20.1.2.2.16 graphic (图形对象)¶

中文英文

该元素指定单个图形对象的存在。当文档作者希望保留某种图形对象时，应该引用此元素。该图形对象的规范完全由文档作者提供，并在 GraphicData 子元素中引用.

[Note: 该元素内容模型 (CT_GraphicalObject) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

graphic (Graphic Object)

This element specifies the existence of a single graphic object. Document authors should refer to this element when they wish to persist a graphical object of some kind. The specification for this graphical object is provided entirely by the document author and referenced within the graphicData child element.

[Note: The W3C XML Schema definition of this element’s content model (CT_GraphicalObject) is located in §A.4.1. end note]

20.1.2.2.17 graphicData (图形对象数据)¶

中文英文

该元素指定对文档中图形对象的引用。该图形对象完全由选择将此数据保留在文档中的文档作者提供。

[Note: 根据所使用的图形对象的类型，并非每个支持 OOXML 框架的生成应用程序都能够呈现图形对象. end note]

[Note: 该元素无意将过渡模式重新引入严格一致性类别. end note]

Attributes	Description
uri (统一资源标识符)	指定表示存储在该标签下的数据的 URI 或统一资源标识符。 URI 用于识别可以处理此标签内容的正确“服务器”. 此属性的可能值由 W3C XML 架构令牌数据类型定义.

[Note: 该元素内容模型 (CT_GraphicalObjectData) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

graphicData (Graphic Object Data)

This element specifies the reference to a graphic object within the document. This graphic object is provided entirely by the document authors who choose to persist this data within the document.

[Note: Depending on the kind of graphical object used not every generating application that supports the OOXML framework has the ability to render the graphical object. end note]

[Note: This element is not intended to reintroduce transitional schema into the strict conformance class. end note]

Attributes	Description
uri (Uniform Resource Identifier)	Specifies the URI, or uniform resource identifier that represents the data stored under this tag. The URI is used to identify the correct 'server' that can process the contents of this tag. The possible values for this attribute are defined by the W3C XML Schema token datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_GraphicalObjectData) is located in §A.4.1. end note]

20.1.2.2.18 graphicFrame (图框)¶

中文英文

该元素指定图形框架的存在。该框架包含由外部源生成的图形，并且需要一个容器来在幻灯片表面上显示。

[Note: 该元素内容模型 (CT_GvmlGraphicalObjectFrame) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

graphicFrame (Graphic Frame)

This element specifies the existence of a graphics frame. This frame contains a graphic that was generated by an external source and needs a container in which to be displayed on the slide surface.

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlGraphicalObjectFrame) is located in §A.4.1. end note]

20.1.2.2.19 graphicFrameLocks (图形框架锁)¶

中文英文

该元素指定图形框架的所有锁定属性。这些属性向生成应用程序通知先前已锁定的特定属性，因此不应更改.

Attributes	Description
noChangeAspect (禁止更改宽高比)	指定生成应用程序不应允许更改相应图形框架的纵横比。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noDrilldown (禁止选择子形状)	Specifies that the generating application should not allow selecting of objects within the corresponding graphic frame but allow selecting of the graphic frame itself. If this attribute is not specified, then a value of false is assumed. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noGrp (禁止形状分组)	指定生成应用程序不应允许对相应图形框架进行形状分组。也就是说，它不能与其他形状组合以形成一组形状。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noMove (禁止形状移动)	指定对应的图形框不能移动。驻留在图形框架内的对象仍然可以移动，除非它们也已被锁定。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noResize (禁止调整形状大小)	指定生成应用程序不应允许更改相应图形框架的大小。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noSelect (禁止选择形状)	指定生成应用程序不应允许选择相应的图片。这还意味着，如果指定了此属性，则无法选择附加到此图片的任何图片、形状或文本。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.

[Note: 该元素内容模型 (CT_GraphicalObjectFrameLocking) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

graphicFrameLocks (Graphic Frame Locks)

This element specifies all locking properties for a graphic frame. These properties inform the generating application about specific properties that have been previously locked and thus should not be changed.

Attributes	Description
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding graphic frame. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noDrilldown (Disallow Selection of Child Shapes)	Specifies that the generating application should not allow selecting of objects within the corresponding graphic frame but allow selecting of the graphic frame itself. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the generating application should not allow shape grouping for the corresponding graphic frame. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noMove (Disallow Shape Movement)	Specifies that the corresponding graphic frame cannot be moved. Objects that reside within the graphic frame can still be moved unless they also have been locked. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noResize (Disallow Shape Resize)	Specifies that the generating application should not allow size changes for the corresponding graphic frame. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the generating application should not allow selecting of the corresponding picture. That means also that no picture, shapes or text attached to this picture can be selected if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_GraphicalObjectFrameLocking) is located in §A.4.1. end note]

20.1.2.2.20 grpSp (组合形状)¶

中文英文

该元素指定一个组形状，表示组合在一起的许多形状。该形状应被视为规则形状，但不是由单个几何形状来描述，而是由其中包含的所有形状几何形状组成。在组形状中，组成该组的每个形状都按照通常的方式指定。然而，对元素进行分组的想法是，单个变换可以同时应用于多个形状。

Example

考虑以下组合形状。

<p:grpSp>
    <p:nvGrpSpPr>
        <p:cNvPr id="10" name="Group 9"/>
        <p:cNvGrpSpPr/>
        <p:nvPr/>
    </p:nvGrpSpPr>
    <p:grpSpPr>
        <a:xfrm>
            <a:off x="838200" y="990600"/>
            <a:ext cx="2426208" cy="978408"/>
            <a:chOff x="838200" y="990600"/>
            <a:chExt cx="2426208" cy="978408"/>
        </a:xfrm>
    </p:grpSpPr>
    <p:sp>
    …
    </p:sp>
    <p:sp>
    …
    </p:sp>
    <p:sp>
    …
    </p:sp>
</p:grpSp>

在上面的示例中，我们看到在单个组中指定了三个形状。这三个形状的位置和大小都被指定，就像它们通常在形状树中一样。生成应用程序应在计算出组形状的边界框后应用转换。

[Note: 该元素内容模型 (CT_GvmlGroupShape) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

grpSp (Group shape)

This element specifies a group shape that represents many shapes grouped together. This shape is to be treated just as if it were a regular shape but instead of being described by a single geometry it is made up of all the shape geometries encompassed within it. Within a group shape each of the shapes that make up the group are specified just as they normally would. The idea behind grouping elements however is that a single transform can apply to many shapes at the same time.

Example

Consider the following group shape.

<p:grpSp>
    <p:nvGrpSpPr>
        <p:cNvPr id="10" name="Group 9"/>
        <p:cNvGrpSpPr/>
        <p:nvPr/>
    </p:nvGrpSpPr>
    <p:grpSpPr>
        <a:xfrm>
            <a:off x="838200" y="990600"/>
            <a:ext cx="2426208" cy="978408"/>
            <a:chOff x="838200" y="990600"/>
            <a:chExt cx="2426208" cy="978408"/>
        </a:xfrm>
    </p:grpSpPr>
    <p:sp>
    …
    </p:sp>
    <p:sp>
    …
    </p:sp>
    <p:sp>
    …
    </p:sp>
</p:grpSp>

In the above example we see three shapes specified within a single group. These three shapes have their position and sizes specified just as they normally would within the shape tree. The generating application should apply the transformation after the bounding box for the group shape has been calculated.

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlGroupShape) is located in §A.4.1. end note]

20.1.2.2.21 grpSpLocks (组合形状锁)¶

中文英文

该元素指定连接形状的所有锁定属性。这些属性向生成应用程序通知先前已锁定的特定属性，因此不应更改。

Attributes	Description
noChangeAspect (禁止更改宽高比)	指定生成应用程序不应允许更改相应连接形状的纵横比。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noGrp (禁止形状组合)	指定对应的组形状无法分组。也就是说，它不能与其他形状组合以形成一组形状。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noMove (禁止移动形状)	指定对应的图形框不能移动。驻留在图形框架内的对象仍然可以移动，除非它们也已被锁定。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noResize (禁止调整形状大小)	指定对应的组形状不能调整大小。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noRot (禁止形状旋转)	指定相应的组形状无法旋转驻留在组内的对象仍然可以旋转，除非它们也已被锁定。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noSelect (禁止选择形状)	指定对应的组形状的任何部分都不能被选择。这意味着如果指定了此属性，则无法选择图片、形状或附加文本。如果未指定此属性，则假定值为 false. [Note: 该属性由子元素继承，因此当该属性设置为 true 时，无法选择组形状内的所有形状. end note] 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
noUngrp (禁止形状取消组合)	指定生成应用程序不应显示相应连接形状的调整手柄。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.

[Note: 该元素内容模型 (CT_GroupLocking) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

grpSpLocks (Group Shape Locks)

This element specifies all locking properties for a connection shape. These properties inform the generating application about specific properties that have been previously locked and thus should not be changed.

Attributes	Description
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the corresponding group shape cannot be grouped. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noMove (Disallow Moving Shape)	Specifies that the corresponding graphic frame cannot be moved. Objects that reside within the graphic frame can still be moved unless they also have been locked. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noResize (Disallow Shape Resizing)	Specifies that the corresponding group shape cannot be resized. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noRot (Disallow Shape Rotation)	Specifies that the corresponding group shape cannot be rotated Objects that reside within the group can still be rotated unless they also have been locked. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the corresponding group shape cannot have any part of it be selected. That means that no picture, shapes or attached text can be selected either if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. [Note: This property is inherited by sub-elements and thus all shapes within the group shape cannot be selected when this attribute is set to a value of true. end note] The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noUngrp (Disallow Shape Ungrouping)	Specifies that the generating application should not show adjust handles for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_GroupLocking) is located in §A.4.1. end note]

20.1.2.2.22 grpSpPr (视觉组形状属性)¶

中文英文

该元素指定相应组内所有形状所共有的属性。如果组形状属性和单个形状属性之间存在任何冲突属性，则应优先考虑单个形状属性。

Attributes

Description

bwMode (黑白模式)

指定应仅使用黑色和白色来渲染组形状.

也就是说，在渲染相应形状时，组形状的颜色信息应转换为黑色或白色.

渲染该图像时不使用灰色，仅使用纯黑和纯白.

[Note: 这并不意味着组形状本身仅存储有黑白颜色信息。该属性设置渲染时形状使用的渲染模式. end note]

该属性的可能值由 ST_BlackWhiteMode 简单类型 (§20.1.10.10) 定义。

[Note: 该元素内容模型 (CT_GroupShapeProperties) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

grpSpPr (Visual Group Shape Properties)

This element specifies the properties that are to be common across all of the shapes within the corresponding group. If there are any conflicting properties within the group shape properties and the individual shape properties then the individual shape properties should take precedence.

Attributes

Description

bwMode (Black and White Mode)

Specifies that the group shape should be rendered using only black and white coloring.

That is the coloring information for the group shape should be converted to either black or white when rendering the corresponding shapes.

No gray is to be used in rendering this image, only stark black and stark white.

[Note: This does not mean that the group shapes themselves are stored with only black and white color information. This attribute instead sets the rendering mode that the shapes use when rendering. end note]

The possible values for this attribute are defined by the ST_BlackWhiteMode simple type (§20.1.10.10).

[Note: The W3C XML Schema definition of this element’s content model (CT_GroupShapeProperties) is located in §A.4.1. end note]

20.1.2.2.23 hlinkHover (悬停的超链接)¶

中文英文

该元素指定当用户鼠标悬停在相应对象上时要激活的超链接信息。超链接的操作是当用户的鼠标悬停在对象上时激活指定的动作。激活此操作后，可以使用附加属性来指定应与该操作一起执行的其他任务。

Attributes	Description
action (动作设定)	指定激活此超链接时要执行的操作。这可用于指定要导航到的幻灯片或要运行的代码脚本. 此属性的可能值由 W3C XML 架构字符串数据类型定义.
endSnd (结束声音)	指定相关 URL 是否应在单击该 URL 时停止正在播放的所有声音. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
highlightClick (突出显示单击)	指定此属性是否已在本文档中使用。也就是说，当超链接已被访问时，将利用该属性，以便生成应用程序可以确定该文本的颜色。如果省略此属性，则隐含值 0 或 false. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
history (添加超链接到页面历史记录)	指定导航到此 URI 时是否将此 URI 添加到历史记录中。这允许观看该演示文稿而无需在观看机器上存储历史信息。如果省略此属性，则假定值为 1 或 true. 该属性的可能值由 W3C XML Schema 布尔数据类型定义.
id (绘图对象超链接目标) Namespace: http://purl.oclc.org/ooxml/officeDocument/relationships	指定在此幻灯片关系文件中查找时包含此超链接目标的关系 ID。该属性不能省略. 该属性的可能值由 ST_RelationshipId 简单类型定义 (§22.8.2.1).
invalidUrl (无效的网址)	当生成应用程序确定 URL 无效时指定该 URL。也就是说，生成应用程序仍然可以存储 URL，但已知该 URL 不正确. 此属性的可能值由 W3C XML 架构字符串数据类型定义.
tgtFrame (目标框架)	指定打开此超链接时要使用的目标框架。当超链接被激活时，该属性用于确定是否启动新窗口以供查看或是否可以使用现有窗口。如果省略此属性，则会打开一个新窗口. 此属性的可能值由 W3C XML 架构字符串数据类型定义.
tooltip (超链接工具提示)	指定当鼠标悬停在超链接文本上时应显示的工具提示。如果省略该属性，则可以显示超链接文本本身. 此属性的可能值由 W3C XML 架构字符串数据类型定义.

[Note: 该元素内容模型 (CT_Hyperlink) 的 W3C XML 模式定义位于 §A.4.1 中。 end note]

hlinkHover (Hyperlink for Hover)

This element specifies the hyperlink information to be activated when the user's mouse is hovered over the corresponding object. The operation of the hyperlink is to have the specified action be activated when the mouse of the user hovers over the object. When this action is activated then additional attributes can be used to specify other tasks that should be performed along with the action.

Attributes	Description
action (Action Setting)	Specifies an action that is to be taken when this hyperlink is activated. This can be used to specify a slide to be navigated to or a script of code to be run. The possible values for this attribute are defined by the W3C XML Schema string datatype.
endSnd (End Sounds)	Specifies if the URL in question should stop all sounds that are playing when it is clicked. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
highlightClick (Highlight Click)	Specifies if this attribute has already been used within this document. That is when a hyperlink has already been visited that this attribute would be utilized so the generating application can determine the color of this text. If this attribute is omitted, then a value of 0 or false is implied. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
history (Add Hyperlink to Page History)	Specifies whether to add this URI to the history when navigating to it. This allows for the viewing of this presentation without the storing of history information on the viewing machine. If this attribute is omitted, then a value of 1 or true is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
id (Drawing Object Hyperlink Target) Namespace: http://purl.oclc.org/ooxml/officeDocument/relationships	Specifies the relationship id that when looked up in this slides relationship file contains the target of this hyperlink. This attribute cannot be omitted. The possible values for this attribute are defined by the ST_RelationshipId simple type (§22.8.2.1).
invalidUrl (Invalid URL)	Specifies the URL when it has been determined by the generating application that the URL is invalid. That is the generating application can still store the URL but it is known that this URL is not correct. The possible values for this attribute are defined by the W3C XML Schema string datatype.
tgtFrame (Target Frame)	Specifies the target frame that is to be used when opening this hyperlink. When the hyperlink is activated this attribute is used to determine if a new window is launched for viewing or if an existing one can be used. If this attribute is omitted, than a new window is opened. The possible values for this attribute are defined by the W3C XML Schema string datatype.
tooltip (Hyperlink Tooltip)	Specifies the tooltip that should be displayed when the hyperlink text is hovered over with the mouse. If this attribute is omitted, than the hyperlink text itself can be displayed. The possible values for this attribute are defined by the W3C XML Schema string datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_Hyperlink) is located in §A.4.1. end note]

20.1.2.2.24 ln (大纲)¶

中文英文

此元素指定可应用于许多不同对象（例如形状和文本）的轮廓样式。该线允许指定许多不同类型的轮廓，包括甚至线虚线和斜角。

Attributes	Description
algn (笔画对齐)	指定用于下划线描边的对齐方式. 该属性的可能值由 ST_PenAlignment 简单类型定义 (§20.1.10.39).
cap (线端盖类型)	指定应用于该行的结束大写。 [注：上限类型的示例有圆形、扁平等。尾注] 如果省略此属性，则假定值为 square . 该属性的可能值由 ST_LineCap 简单类型定义 (§20.1.10.31).
cmpd (复合线型)	指定用于下划线描边的复合线类型。如果省略此属性，则假定值为 sng. 该属性的可能值由 ST_CompoundLine 简单类型定义 (§20.1.10.15).
w (线宽)	指定用于下划线描边的宽度。如果省略该属性，则假定值为 0. 该属性的可能值由 ST_LineWidth 简单类型定义 (§20.1.10.35).

[Note: 该元素内容模型 (CT_LineProperties) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

ln (Outline)

This element specifies an outline style that can be applied to a number of different objects such as shapes and text. The line allows for the specifying of many different types of outlines including even line dashes and bevels.

Attributes	Description
algn (Stroke Alignment)	Specifies the alignment to be used for the underline stroke. The possible values for this attribute are defined by the ST_PenAlignment simple type (§20.1.10.39).
cap (Line Ending Cap Type)	Specifies the ending caps that should be used for this line. [Note: Examples of cap types are rounded, flat, etc. end note] If this attribute is omitted, than a value of square is assumed. The possible values for this attribute are defined by the ST_LineCap simple type (§20.1.10.31).
cmpd (Compound Line Type)	Specifies the compound line type to be used for the underline stroke. If this attribute is omitted, then a value of sng is assumed. The possible values for this attribute are defined by the ST_CompoundLine simple type (§20.1.10.15).
w (Line Width)	Specifies the width to be used for the underline stroke. If this attribute is omitted, then a value of 0 is assumed. The possible values for this attribute are defined by the ST_LineWidth simple type (§20.1.10.35).

[Note: The W3C XML Schema definition of this element’s content model (CT_LineProperties) is located in §A.4.1. end note]

20.1.2.2.25 nvCxnSpPr (连接形状的非视觉属性)¶

中文英文

该元素指定连接形状的所有非视觉属性。该元素是与连接形状关联的非视觉识别属性、形状属性和应用程序属性的容器。这允许存储不影响连接形状外观的附加信息。

[Note: 该元素内容模型 (CT_GvmlConnectorNonVisual) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

nvCxnSpPr (Non-Visual Properties for a Connection Shape)

This element specifies all non-visual properties for a connection shape. This element is a container for the nonvisual identification properties, shape properties and application properties that are to be associated with a connection shape. This allows for additional information that does not affect the appearance of the connection shape to be stored.

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlConnectorNonVisual) is located in §A.4.1. end note]

20.1.2.2.26 nvGraphicFramePr (图形框架的非视觉属性)¶

中文英文

该元素指定图形框架的所有非视觉属性。该元素是与图形框架关联的非视觉识别属性、形状属性和应用程序属性的容器。这允许存储不影响图形框架的外观的附加信息。

[Note: 该元素内容模型 (CT_GvmlGraphicFrameNonVisual) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

nvGraphicFramePr (Non-Visual Properties for a Graphic Frame)

This element specifies all non-visual properties for a graphic frame. This element is a container for the non-visual identification properties, shape properties and application properties that are to be associated with a graphic frame. This allows for additional information that does not affect the appearance of the graphic frame to be stored.

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlGraphicFrameNonVisual) is located in §A.4.1. end note]

20.1.2.2.27 nvGrpSpPr (组合形状的非视觉属性)¶

中文英文

该元素指定组形状的所有非视觉属性。该元素是与组形状关联的非视觉识别属性、形状属性和应用程序属性的容器。这允许存储不影响组形状外观的附加信息。

[Note: 该元素内容模型 (CT_GvmlGroupShapeNonVisual) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

nvGrpSpPr (Non-Visual Properties for a Group Shape)

This element specifies all non-visual properties for a group shape. This element is a container for the non-visual identification properties, shape properties and application properties that are to be associated with a group shape. This allows for additional information that does not affect the appearance of the group shape to be stored.

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlGroupShapeNonVisual) is located in §A.4.1. end note]

20.1.2.2.28 nvPicPr (图片的非视觉属性)¶

中文英文

该元素指定图片的所有非视觉属性。该元素是与图片关联的非视觉识别属性、形状属性和应用程序属性的容器。这允许存储不影响图片外观的附加信息。

Example

考虑以下PresentationML。

<p:pic>
    …
    <p:nvPicPr>
        …
    </p:nvPicPr>
    …
</p:pic>

[Note: 该元素内容模型 (CT_GvmlPictureNonVisual) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

nvPicPr (Non-Visual Properties for a Picture)

This element specifies all non-visual properties for a picture. This element is a container for the non-visual identification properties, shape properties and application properties that are to be associated with a picture. This allows for additional information that does not affect the appearance of the picture to be stored.

Example

Consider the following PresentationML.

<p:pic>
    …
    <p:nvPicPr>
        …
    </p:nvPicPr>
    …
</p:pic>

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlPictureNonVisual) is located in §A.4.1. end note]

20.1.2.2.29 nvSpPr (形状的非视觉属性)¶

中文英文

该元素指定形状的所有非视觉属性。该元素是与形状关联的非视觉识别属性、形状属性和应用程序属性的容器。这允许存储不影响形状外观的附加信息。

[Note: 该元素内容模型 (CT_GvmlShapeNonVisual) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

nvSpPr (Non-Visual Properties for a Shape)

This element specifies all non-visual properties for a shape. This element is a container for the non-visual identification properties, shape properties and application properties that are to be associated with a shape. This allows for additional information that does not affect the appearance of the shape to be stored.

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlShapeNonVisual) is located in §A.4.1. end note]

20.1.2.2.30 pic (图片)¶

中文英文

该元素指定文档中是否存在图片对象。

Example

考虑下面的PresentationML，它指定文档中是否存在图片。该图片可以具有非视觉属性、图片填充以及附加的形状属性。

<p:pic>
    <p:nvPicPr>
        <p:cNvPr id="4" name="lake.JPG" descr="Picture of a Lake" />
        <p:cNvPicPr>
            <a:picLocks noChangeAspect="1"/>
        </p:cNvPicPr>
        <p:nvPr/>
    </p:nvPicPr>
    <p:blipFill>
    …
    </p:blipFill>
    <p:spPr>
    …
    </p:spPr>
</p:pic>

[Note: 该元素内容模型 (CT_GvmlPicture) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

pic (Picture)

This element specifies the existence of a picture object within the document.

Example

Consider the following PresentationML that specifies the existence of a picture within a document. This picture can have non-visual properties, a picture fill as well as shape properties attached to it.

<p:pic>
    <p:nvPicPr>
        <p:cNvPr id="4" name="lake.JPG" descr="Picture of a Lake" />
        <p:cNvPicPr>
            <a:picLocks noChangeAspect="1"/>
        </p:cNvPicPr>
        <p:nvPr/>
    </p:nvPicPr>
    <p:blipFill>
    …
    </p:blipFill>
    <p:spPr>
    …
    </p:spPr>
</p:pic>

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlPicture) is located in §A.4.1. end note]

20.1.2.2.31 picLocks (图片锁)¶

中文英文

该元素指定图形框架的所有锁定属性。这些属性向生成应用程序通知先前已锁定的特定属性，因此不应更改。

Attributes	Description
noAdjustHandles(禁止显示调整手柄)	指定生成应用程序不应显示相应连接形状的调整手柄。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noChangeArrowheads (禁止箭头更改)	指定生成应用程序不应允许更改相应连接形状的箭头。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noChangeAspect (禁止更改宽高比)	指定生成应用程序不应允许更改相应连接形状的纵横比。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noChangeShapeType (禁止形状类型更改)	指定生成应用程序不应允许更改相应连接形状的形状类型。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noCrop (禁止裁减变化)	指定生成应用程序不应允许裁剪相应的图片。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noEditPoints(禁止形状点编辑)	指定生成应用程序不应允许更改相应连接形状的形状点。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noGrp (禁止形状组合)	指定生成应用程序不应允许对相应连接形状进行形状分组。也就是说，它不能与其他形状组合以形成一组形状。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noMove (禁止形状移动)	指定生成应用程序不应允许相应连接形状的位置更改。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noResize (禁止调整形状大小)	指定生成应用程序不应允许更改相应连接形状的尺寸。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noRot (禁止形状旋转)	指定生成应用程序不应允许相应连接形状的形状旋转更改。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noSelect (禁止选择形状)	指定生成应用程序不应允许选择相应的连接形状。这还意味着，如果指定了此属性，则无法选择附加到此连接形状的图片、形状或文本。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.

picLocks (Picture Locks)

This element specifies all locking properties for a graphic frame. These properties inform the generating application about specific properties that have been previously locked and thus should not be changed.

Attributes	Description
noAdjustHandles(Disallow Showing Adjust Handles)	Specifies that the generating application should not show adjust handles for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeArrowheads (Disallow Arrowhead Changes)	Specifies that the generating application should not allow arrowhead changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeShapeType (Disallow Shape Type Change)	Specifies that the generating application should not allow shape type changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noCrop (Disallow Crop Changes)	Specifies that the generating application should not allow cropping for the corresponding picture. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noEditPoints(Disallow Shape Point Editing)	Specifies that the generating application should not allow shape point changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the generating application should not allow shape grouping for the corresponding connection shape. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noMove (Disallow Shape Movement)	Specifies that the generating application should not allow position changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noResize (Disallow Shape Resize)	Specifies that the generating application should not allow size changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noRot (Disallow Shape Rotation)	Specifies that the generating application should not allow shape rotation changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the generating application should not allow selecting of the corresponding connection shape. That means also that no picture, shapes or text attached to this connection shape can be selected if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

20.1.2.2.32 snd (超链接声音)¶

中文英文

该元素指定激活文档中的超链接时要播放的声音。该声音是从父超链接元素中指定的。

Attributes	Description
embed (嵌入音频文件关系 ID) Namespace: http://purl.oclc.org/ooxml/officeDocument/relationships	指定嵌入音频文件的标识信息。该属性用于指定本地驻留在文件内的对象的位置. [Note: §15.2.2. 中提供了建议的音频类型列表 end note] 该属性的可能值由 ST_RelationshipId 简单类型定义 (§22.8.2.1)
name (声音名称)	指定相应声音的原始名称或给定的短名称。如果用户需要在 UI 中的其他声音中识别该声音，则可以通过为附加声音提供人类可读的名称来区分该声音与其他声音. 该属性的可能值由 W3C XML Schema string 类型定义.

[Note: 该元素内容模型 (CT_EmbeddedWAVAudioFile) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

snd (Hyperlink Sound)

This element specifies a sound to be played when a hyperlink within the document is activated. This sound is specified from within the parent hyperlink element.

Attributes	Description
embed (Embedded Audio File Relationship ID) Namespace: http://purl.oclc.org/ooxml/officeDocument/relationships	Specifies the identification information for an embedded audio file. This attribute is used to specify the location of an object that resides locally within the file. [Note: A list of suggested audio types is provided in §15.2.2. end note] The possible values for this attribute are defined by the ST_RelationshipId simple type (§22.8.2.1)
name (Sound Name)	Specifies the original name or given short name for the corresponding sound. This is used to distinguish this sound from others by providing a human readable name for the attached sound should the user need to identify the sound among others within the UI. The possible values for this attribute are defined by the W3C XML Schema string datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_EmbeddedWAVAudioFile) is located in §A.4.1. end note]

20.1.2.2.33 sp (形状)¶

中文英文

该元素指定单个形状的存在。形状可以是使用 DrawingML 框架定义的预设几何图形或自定义几何图形。除了几何形状之外，每个形状还可以附加视觉和非视觉属性。文本和相应的样式信息也可以附加到形状。该形状与形状树或组形状元素中的所有其他形状一起指定。

[Note: 形状是在幻灯片上指定文本的首选机制. end note]

[Note: 该元素内容模型 (CT_GvmlShape) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

sp (Shape)

This element specifies the existence of a single shape. A shape can either be a preset or a custom geometry, defined using the DrawingML framework. In addition to a geometry each shape can have both visual and nonvisual properties attached. Text and corresponding styling information can also be attached to a shape. This shape is specified along with all other shapes within either the shape tree or group shape elements.

[Note: Shapes are the preferred mechanism for specifying text on a slide. end note]

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlShape) is located in §A.4.1. end note]

20.1.2.2.34 spLocks (形状锁)¶

中文英文

该元素指定形状的所有锁定属性。这些属性向生成应用程序通知先前已锁定的特定属性，因此不应更改.

Attributes	Description
noAdjustHandles(禁止显示调整手柄)	指定生成应用程序不应显示相应连接形状的调整手柄。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noChangeArrowheads (禁止箭头更改)	指定生成应用程序不应允许更改相应连接形状的箭头。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noChangeAspect (禁止更改宽高比)	指定生成应用程序不应允许更改相应连接形状的纵横比。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noChangeShapeType (禁止形状类型更改)	指定生成应用程序不应允许更改相应连接形状的形状类型。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noEditPoints(禁止形状点编辑)	指定生成应用程序不应允许更改相应连接形状的形状点。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noGrp (禁止形状组合)	指定生成应用程序不应允许对相应连接形状进行形状分组。也就是说，它不能与其他形状组合以形成一组形状。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noMove (禁止形状移动)	指定生成应用程序不应允许相应连接形状的位置更改。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noResize (禁止调整形状大小)	指定生成应用程序不应允许更改相应连接形状的尺寸。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noRot (禁止形状旋转)	指定生成应用程序不应允许相应连接形状的形状旋转更改。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noSelect (禁止选择形状)	指定生成应用程序不应允许选择相应的连接形状。这还意味着，如果指定了此属性，则无法选择附加到此连接形状的图片、形状或文本。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.
noTextEdit(禁止形状文本编辑)	指定生成应用程序不应允许编辑相应形状的形状文本。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema 布尔数据类型.

[Note: 该元素内容模型 (CT_ShapeLocking) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

spLocks (Shape Locks)

This element specifies all locking properties for a shape. These properties inform the generating application about specific properties that have been previously locked and thus should not be changed.

Attributes	Description
noAdjustHandles(Disallow Showing Adjust Handles)	Specifies that the generating application should not show adjust handles for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeArrowheads (Disallow Arrowhead Changes)	Specifies that the generating application should not allow arrowhead changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeShapeType (Disallow Shape Type Change)	Specifies that the generating application should not allow shape type changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noEditPoints(Disallow Shape Point Editing)	Specifies that the generating application should not allow shape point changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the generating application should not allow shape grouping for the corresponding connection shape. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noMove (Disallow Shape Movement)	Specifies that the generating application should not allow position changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noResize (Disallow Shape Resize)	Specifies that the generating application should not allow size changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noRot (Disallow Shape Rotation)	Specifies that the generating application should not allow shape rotation changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the generating application should not allow selecting of the corresponding connection shape. That means also that no picture, shapes or text attached to this connection shape can be selected if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noTextEdit(Disallow Shape Text Editing)	Specifies that the generating application should not allow editing of the shape text for the corresponding shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_ShapeLocking) is located in §A.4.1. end note]

20.1.2.2.35 spPr (形状属性)¶

中文英文

该元素指定可应用于形状的视觉形状属性.

Attributes

Description

bwMode (黑白模式)

指定应仅使用黑色和白色来渲染组形状.

也就是说，在渲染相应形状时，组形状的颜色信息应转换为黑色或白色.

渲染该图像时不使用灰色，仅使用纯黑和纯白.

[Note: 这并不意味着组形状本身仅存储有黑白颜色信息。该属性设置渲染时形状使用的渲染模式. end note]

该属性的可能值由 ST_BlackWhiteMode 简单类型定义 (§20.1.10.10).

[Note: 该元素内容模型 (CT_ShapeProperties) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

spPr (Shape Properties)

This element specifies the visual shape properties that can be applied to a shape.

Attributes

Description

bwMode (Black and White Mode)

Specifies that the group shape should be rendered using only black and white coloring.

That is the coloring information for the group shape should be converted to either black or white when rendering the corresponding shapes.

No gray is to be used in rendering this image, only stark black and stark white.

[Note: This does not mean that the group shapes themselves are stored with only black and white color information. This attribute instead sets the rendering mode that the shapes use when rendering. end note]

The possible values for this attribute are defined by the ST_BlackWhiteMode simple type (§20.1.10.10).

[Note: The W3C XML Schema definition of this element’s content model (CT_ShapeProperties) is located in §A.4.1. end note]

20.1.2.2.36 stCxn (连接开始)¶

中文英文

该元素指定应由相应连接器形状建立的起始连接。这将连接器的头部连接到第一个形状。

Attributes	Description
id (标识符)	指定要进行最终连接的形状的 id. 该属性的可能值由 ST_DrawingElementId 简单类型定义 (§20.1.10.21).
idx (索引)	指定最终连接形状的连接站点表的索引。即一个形状上有很多连接点，需要指定对应的连接器形状应该连接到哪个连接点. 该属性的可能值由 W3C XML Schema unsignedInt 数据类型定义.

[Note: 该元素内容模型 (CT_Connection) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

stCxn (Connection Start)

This element specifies the starting connection that should be made by the corresponding connector shape. This connects the head of the connector to the first shape.

Attributes	Description
id (Identifier)	Specifies the id of the shape to make the final connection to. 该属性的可能值由 ST_DrawingElementId 简单类型定义 (§20.1.10.21).
idx (Index)	Specifies the index into the connection site table of the final connection shape. That is there are many connection sites on a shape and it shall be specified which connection site the corresponding connector shape should connect to. The possible values for this attribute are defined by the W3C XML Schema unsignedInt datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_Connection) is located in §A.4.1. end note]

20.1.2.2.37 style (形状样式)¶

中文英文

该元素指定形状的样式信息.

[Note: 该元素内容模型 (CT_ShapeStyle) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

style (Shape Style)

This element specifies the style information for a shape.

[Note: The W3C XML Schema definition of this element’s content model (CT_ShapeStyle) is located in §A.4.1. end note]

20.1.2.2.38 sx (水平比例)¶

中文英文

该元素指定在缩放计算中使用的水平比例.

Attributes	Description
d (分母/Denominator)	指定方程中使用的分母. 该属性的可能值由 W3C XML Schema long 数据类型定义.
n (分子/Numerator)	指定方程中使用的分子. 该属性的可能值由 W3C XML Schema long 数据类型定义.

[Note: 该元素内容模型 (CT_Ratio) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

sx (Horizontal Ratio)

This element specifies the horizontal ratio for use within a scaling calculation.

Attributes	Description
d (Denominator)	Specifies the denominator to be used within the equation. The possible values for this attribute are defined by the W3C XML Schema long datatype.
n (Numerator)	Specifies the numerator to be used within the equation. The possible values for this attribute are defined by the W3C XML Schema long datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_Ratio) is located in §A.4.1. end note]

20.1.2.2.39 sy (垂直比例)¶

中文英文

该元素指定在缩放计算中使用的垂直比例.

Attributes	Description
d (Denominator)	指定方程中使用的分母. 该属性的可能值由 W3C XML Schema long 数据类型定义.
n (Numerator)	指定方程中使用的分子. 该属性的可能值由 W3C XML Schema long 数据类型定义.

[Note: 该元素内容模型 (CT_Ratio) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

sy (Vertical Ratio)

This element specifies the vertical ratio for use within a scaling calculation.

Attributes	Description
d (Denominator)	Specifies the denominator to be used within the equation. The possible values for this attribute are defined by the W3C XML Schema long datatype.
n (Numerator)	Specifies the numerator to be used within the equation. The possible values for this attribute are defined by the W3C XML Schema long datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_Ratio) is located in §A.4.1. end note]

20.1.2.2.40 txBody (形状文本正文)¶

中文英文

该元素指定相应形状中是否存在要包含的文本。所有可见文本和可见文本相关属性都包含在此元素内。可以有多个段落，段落内可以有多个文本段.

[Note: 该元素内容模型 (CT_TextBody) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

txBody (Shape Text Body)

This element specifies the existence of text to be contained within the corresponding shape. All visible text and visible text related properties are contained within this element. There can be multiple paragraphs and within paragraphs multiple runs of text.

[Note: The W3C XML Schema definition of this element’s content model (CT_TextBody) is located in §A.4.1. end note]

20.1.2.2.41 txSp (文本形状)¶

中文英文

该元素指定父形状中是否存在文本形状。此文本形状专门用于显示文本，因为它仅具有与文本相关的子元素.

[Note: 该元素内容模型 (CT_GvmlTextShape) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

txSp (Text Shape)

This element specifies the existence of a text shape within a parent shape. This text shape is specifically used for displaying text as it has only text related child elements.

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlTextShape) is located in §A.4.1. end note]

20.1.2.2.42 useSpRect (使用形状文本矩形)¶

中文英文

此元素指定父形状中的文本矩形应用于此文本形状。如果指定了此属性，则文本矩形或文本边界框（也称为文本边界框）应与此文本形状所在的父形状的文本边界框具有相同的尺寸.

[Note: 该元素内容模型 (CT_GvmlUseShapeRectangle) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

useSpRect (Use Shape Text Rectangle)

This element specifies that the text rectangle from the parent shape should be used for this text shape. If this attribute is specified then the text rectangle, or text bounding box as it is also called should have the same dimensions as the text bounding box of the parent shape within which this text shape resides.

[Note: The W3C XML Schema definition of this element’s content model (CT_GvmlUseShapeRectangle) is located in §A.4.1. end note]

20.1.2.2.43 cpLocks (内容部分锁)¶

中文英文

该元素指定内容部分的所有锁定属性。这些属性向生成应用程序通知先前已锁定的特定属性，因此不应更改.

Attributes	Description
noAdjustHandles(禁止显示调整手柄)	指定生成应用程序不应显示相应连接形状的调整手柄。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.
noChangeArrowheads (禁止箭头更改)	指定生成应用程序不应允许更改相应连接形状的箭头。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.
noChangeAspect (禁止更改宽高比)	指定生成应用程序不应允许更改相应连接形状的纵横比。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.
noChangeShapeType (禁止形状类型更改)	指定生成应用程序不应允许更改相应连接形状的形状类型。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.
noEditPoints(禁止形状点编辑)	指定生成应用程序不应允许更改相应连接形状的形状点。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.
noGrp (禁止形状分组)	指定生成应用程序不应允许对相应连接形状进行形状分组。也就是说，它不能与其他形状组合以形成一组形状。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.
noMove (禁止形状移动)	指定生成应用程序不应允许相应连接形状的位置更改。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.
noResize (禁止调整形状大小)	指定生成应用程序不应允许更改相应连接形状的尺寸。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.
noRot (禁止形状旋转)	指定生成应用程序不应允许相应连接形状的形状旋转更改。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.
noSelect (禁止选择形状)	指定生成应用程序不应允许选择相应的连接形状。这还意味着，如果指定了此属性，则无法选择附加到此连接形状的图片、形状或文本。如果未指定此属性，则假定值为 false. 该属性的可能值由 W3C XML Schema boolean 数据类型定义.

[Note: 该元素内容模型 (CT_ContentPartLocking) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

cpLocks (Content Part Locks)

This element specifies all locking properties for a content part. These properties inform the generating application about specific properties that have been previously locked and thus should not be changed.

Attributes	Description
noAdjustHandles(Disallow Showing Adjust Handles)	Specifies that the generating application should not show adjust handles for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeArrowheads (Disallow Arrowhead Changes)	Specifies that the generating application should not allow arrowhead changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeAspect (Disallow Aspect Ratio Change)	Specifies that the generating application should not allow aspect ratio changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noChangeShapeType (Disallow Shape Type Change)	Specifies that the generating application should not allow shape type changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noEditPoints(Disallow Shape Point Editing)	Specifies that the generating application should not allow shape point changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noGrp (Disallow Shape Grouping)	Specifies that the generating application should not allow shape grouping for the corresponding connection shape. That is it cannot be combined within other shapes to form a group of shapes. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noMove (Disallow Shape Movement)	Specifies that the generating application should not allow position changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noResize (Disallow Shape Resize)	Specifies that the generating application should not allow size changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noRot (Disallow Shape Rotation)	Specifies that the generating application should not allow shape rotation changes for the corresponding connection shape. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.
noSelect (Disallow Shape Selection)	Specifies that the generating application should not allow selecting of the corresponding connection shape. That means also that no picture, shapes or text attached to this connection shape can be selected if this attribute has been specified. If this attribute is not specified, then a value of false is assumed. The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

[Note: The W3C XML Schema definition of this element’s content model (CT_ContentPartLocking) is located in §A.4.1. end note]

20.1.2.3 颜色¶

中文英文

鉴于在 DrawingML 基础知识中拥有自己的部分，颜色是 DrawingML 框架的一个组成部分。几乎每个对象都使用颜色来帮助描述其在屏幕上渲染时的外观。由于并非每个生成应用程序都希望以相同的方式表示颜色，因此可以通过多种不同的方式指定颜色。

Colors

Given its own section within DrawingML Basics, colors are an integral part of the DrawingML framework. Colors are used in virtually every object to help describe it's appearance when it is rendered on the screen. Since not every generating application wishes to represent color in the same manner, it is possible to specify color in a number of different ways.

20.1.2.3.1 alpha (阿尔法)¶

中文英文

该元素使用特定的不透明度指定其输入颜色，但其颜色保持不变。

Attributes	Description
val (Value)	指定以百分比值表示的不透明度. [Example: 下面代表了 50% 不透明的绿色实心填充 `<a:solidFill>` `<a:srgbClr val="00FF00">` `<a:alpha val="50%"/>` `</a:srgbClr>` `</a:solidFill>` end example] 该属性的可能值由 ST_PositiveFixedPercentage 简单类型定义 (§20.1.10.45).

[Note: 该元素内容模型 (CT_PositiveFixedPercentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

alpha (Alpha)

This element specifies its input color with the specific opacity, but with its color unchanged.

Attributes	Description
val (Value)	Specifies the opacity as expressed by a percentage value. [Example: The following represents a green solid fill which is 50% opaque `<a:solidFill>` `<a:srgbClr val="00FF00">` `<a:alpha val="50%"/>` `</a:srgbClr>` `</a:solidFill>` end example] The possible values for this attribute are defined by the ST_PositiveFixedPercentage simple type (§20.1.10.45).

[Note: The W3C XML Schema definition of this element’s content model (CT_PositiveFixedPercentage) is located in §A.4.1. end note]

20.1.2.3.2 alphaMod (阿尔法调制)¶

中文英文

该元素指定其输入颜色的或多或少不透明的版本。 Alpha 调制永远不会将 Alpha 值增加到超过 100%。 200% Alpha 调制使输入颜色的不透明度是以前的两倍。 50% Alpha 调制使输入颜色的不透明度减半。

Attributes	Description
val (值)	指定不透明度，以相对于输入颜色的百分比表示. [Example: 下面代表了 50% 不透明的绿色实心填充 `<a:solidFill>` `<a:srgbClr val="00FF00">` `<a:alphaMod val="50%"/>` `</a:srgbClr>` `</a:solidFill>` end example] 该属性的可能值由 ST_PositivePercentage 简单类型定义 (§20.1.10.46).

[Note: 该元素内容模型 (CT_PositivePercentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

alphaMod (Alpha Modulation)

This element specifies a more or less opaque version of its input color. An alpha modulate never increases the alpha beyond 100%. A 200% alpha modulate makes an input color twice as opaque as before. A 50% alpha modulate makes an input color half as opaque as before.

Attributes	Description
val (Value)	Specifies the opacity as expressed by a percentage relative to the input color. [Example: The following represents a green solid fill which is 50% opaque `<a:solidFill>` `<a:srgbClr val="00FF00">` `<a:alphaMod val="50%"/>` `</a:srgbClr>` `</a:solidFill>` end example] The possible values for this attribute are defined by the ST_PositivePercentage simple type (§20.1.10.46).

[Note: The W3C XML Schema definition of this element’s content model (CT_PositivePercentage) is located in §A.4.1. end note]

20.1.2.3.3 alphaOff (阿尔法偏移)¶

中文英文

该元素指定其输入颜色的或多或少不透明的版本。按指定的百分比偏移量增加或减少输入 Alpha 百分比。 10% 的 Alpha 偏移会将 50% 的不透明度增加到 60%。 -10% Alpha 偏移会将 50% 的不透明度降低到 40%。转换后的 alpha 值限制在 0 到 100% 的范围内。对 100% 不透明对象增加 10% Alpha 偏移仍会导致 100% 不透明度。

Attributes Description

val (Value) 指定不透明度，以相对于输入颜色的偏移增加或减少的百分比表示。增加永远不会将不透明度增加到超过 100%，减少永远不会将不透明度降低到 0% 以下。

[Example: 下面代表了 90% 不透明的绿色实心填充

<a:solidFill>
<a:srgbClr val="00FF00">
<a:alphaOff val="-10%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_FixedPercentage 简单类型定义 (§20.1.10.24).

[Note: 该元素内容模型 (CT_FixedPercentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

alphaOff (Alpha Offset)

This element specifies a more or less opaque version of its input color. Increases or decreases the input alpha percentage by the specified percentage offset. A 10% alpha offset increases a 50% opacity to 60%. A -10% alpha offset decreases a 50% opacity to 40%. The transformed alpha values are limited to a range of 0 to 100%. A 10% alpha offset increase to a 100% opaque object still results in 100% opacity.

Attributes Description

val (Value) Specifies the opacity as expressed by a percentage offset increase or decrease to theinput color. Increases never increase the opacity beyond 100%, decreases never decrease the opacity below 0%.

[Example: The following represents a green solid fill which is 90% opaque

<a:solidFill>
<a:srgbClr val="00FF00">
<a:alphaOff val="-10%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_FixedPercentage simple type (§20.1.10.24).

[Note: The W3C XML Schema definition of this element’s content model (CT_FixedPercentage) is located in §A.4.1. end note]

20.1.2.3.4 blue (蓝色的)¶

中文英文

该元素指定具有特定蓝色分量的输入颜色，但红色和绿色分量不变。

Attributes	Description
val (值)	指定蓝色分量的值。分配的值指定为百分比，0% 表示最小蓝色，100% 表示最大蓝色. [Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (00, FF, FF) `<a:solidFill>` `<a:srgbClr val="00FF00">` `<a:blue val="100%"/>` `</a:srgbClr>` `</a:solidFill>` end example] 该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

blue (Blue)

This element specifies the input color with the specific blue component, but with the red and green color components unchanged.

Attributes Description

val (Value) Specifies the value of the blue component. The assigned value is specified as a percentage with 0% indicating minimal blue and 100% indicating maximum blue.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, FF, FF)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:blue val="100%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.5 blueMod (蓝色调制)¶

中文英文

该元素指定输入颜色，其蓝色分量按给定百分比调制。 50% 蓝色调制将蓝色分量减少一半。 200% 蓝色调制使蓝色分量加倍。

Attributes Description

val (值) 指定蓝色分量，以相对于输入颜色分量的百分比表示。增加永远不会将蓝色分量增加到超过 100%，减少永远不会将蓝色分量减少到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, 00, FF) 更改为值 RRGGBB= (00, 00, 80)

<a:solidFill>
<a:srgbClr val="0000FF">
<a:blueMod val=""50%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

blueMod (Blue Modulation)

This element specifies the input color with its blue component modulated by the given percentage. A 50% blue modulate reduces the blue component by half. A 200% blue modulate doubles the blue component.

Attributes Description

val (Value) Specifies the blue component as expressed by a percentage relative to the input color component. Increases never increase the blue component beyond 100%, decreases never decrease the blue component below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, 00, FF) to value RRGGBB= (00, 00, 80)

<a:solidFill>
<a:srgbClr val="0000FF">
<a:blueMod val=""50%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.6 blueOff (蓝色偏移)¶

中文英文

该元素指定输入颜色，其蓝色分量发生偏移，但红色和绿色分量不变。

Attributes Description

val (值) 指定蓝色分量，以相对于输入颜色分量的偏移增加或减少的百分比表示。增加永远不会将蓝色分量增加到超过 100%，减少永远不会将蓝色分量减少到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, 00, FF) 更改为值 RRGGBB= (00, 00, CC)

<a:solidFill>
<a:srgbClr val="0000FF">
<a:blueOff val=""-20%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

blueOff (Blue Offset)

This element specifies the input color with its blue component shifted, but with its red and green color components unchanged.

Attributes Description

val (Value) Specifies the blue component as expressed by a percentage offset increase or decrease to the input color component. Increases never increase the blue component beyond 100%, decreases never decrease the blue component below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, 00, FF) to value RRGGBB= (00, 00, CC)

<a:solidFill>
<a:srgbClr val="0000FF">
<a:blueOff val=""-20%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.7 comp (补充)¶

中文英文

该元素指定渲染的颜色应该是其输入颜色的补色，补色是这样定义的。如果两种颜色混合时产生灰色阴影，则称为互补色。例如，红色的补色是 RGB (255, 0, 0)，而青色是 RGB (0, 255, 255)。

原色和间色通常以这种方式配对：

红色和青色（其中青色是绿色和蓝色的混合物）
绿色和洋红色（其中洋红色是红色和蓝色的混合物）
蓝色和黄色（其中黄色是红色和绿色的混合物）

Example

下式表示红色的补码：

<a:solidFill>
    <a:srgbClr val="FF0000">
        <a:comp/>
    </a:srgbClr>
</a:solidFill>

[Note: 该元素内容模型 (CT_ComplementTransform) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

comp (Complement)

This element specifies that the color rendered should be the complement of its input color with the complement being defined as such. Two colors are called complementary if, when mixed they produce a shade of grey. For instance, the complement of red which is RGB (255, 0, 0) is cyan which is RGB (0, 255, 255).

Primary colors and secondary colors are typically paired in this way:

red and cyan (where cyan is the mixture of green and blue)
green and magenta (where magenta is the mixture of red and blue)
blue and yellow (where yellow is the mixture of red and green)

Example

The following represents the complement of red:

<a:solidFill>
    <a:srgbClr val="FF0000">
        <a:comp/>
    </a:srgbClr>
</a:solidFill>

[Note: The W3C XML Schema definition of this element’s content model (CT_ComplementTransform) is located in §A.4.1. end note]

20.1.2.3.8 gamma (伽玛)¶

中文英文

该元素指定生成应用程序渲染的输出颜色应该是输入颜色的 sRGB gamma 偏移。

[Note: 该元素内容模型 (CT_GammaTransform) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

gamma (Gamma)

This element specifies that the output color rendered by the generating application should be the sRGB gamma shift of the input color.

[Note: The W3C XML Schema definition of this element’s content model (CT_GammaTransform) is located in §A.4.1. end note]

20.1.2.3.9 gray (灰色)¶

中文英文

该元素指定其输入颜色的灰度，考虑红、绿、蓝原色的相对强度.

[Note: 该元素内容模型 (CT_GrayscaleTransform) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

gray (Gray)

This element specifies a grayscale of its input color, taking into relative intensities of the red, green, and blue primaries.

[Note: The W3C XML Schema definition of this element’s content model (CT_GrayscaleTransform) is located in §A.4.1. end note]

20.1.2.3.10 green (绿色)¶

中文英文

该元素指定具有指定绿色分量的输入颜色，但其红色和蓝色分量不变。

Attributes	Description
val (Value)	指定绿色分量的值。分配的值指定为百分比，0% 表示最小绿色，100% 表示最大绿色. [Example: 以下操作将填充从 RGB 值 RRGGBB = (00, 00, FF) 更改为值 RRGGBB= (00, FF, FF) `<a:solidFill>` `<a:srgbClr val="0000FF">` `<a:green val="100%"/>` `</a:srgbClr>` `</a:solidFill>` end example] 该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

green (Green)

This elements specifies the input color with the specified green component, but with its red and blue color components unchanged.

Attributes Description

val (Value) Specifies the value of the green component. The assigned value is specified as a percentage with 0% indicating minimal green and 100% indicating maximum green.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, 00, FF) to value RRGGBB= (00, FF, FF)

<a:solidFill>
<a:srgbClr val="0000FF">
<a:green val="100%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.11 greenMod (绿色调制)¶

中文英文

该元素指定输入颜色，其绿色分量按给定百分比调制。 50% 绿色调制将绿色成分减少一半。 200% 绿色调制使绿色成分加倍.

Attributes Description

val (值) 指定绿色分量，以相对于输入颜色分量的百分比表示。增加绝不会将绿色成分增加到超过 100%，减少绝不会将绿色成分减少到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (00, 80, 00)

<a:solidFill>
<a:srgbClr val="0000FF">
<a:greenMod val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

greenMod (Green Modulation)

This element specifies the input color with its green component modulated by the given percentage. A 50% green modulate reduces the green component by half. A 200% green modulate doubles the green component.

Attributes Description

val (Value) Specifies the green component as expressed by a percentage relative to the input color component. Increases never increase the green component beyond 100%, decreases never decrease the green component below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, 80, 00)

<a:solidFill>
<a:srgbClr val="0000FF">
<a:greenMod val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.12 greenOff (绿色偏移)¶

中文英文

该元素指定输入颜色，其绿色分量发生偏移，但红色和蓝色分量不变。

Attributes Description

val (值) 指定绿色分量，以相对于输入颜色分量的偏移增加或减少的百分比表示。增加绝不会将绿色成分增加到超过 100%，减少绝不会将绿色成分减少到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (00, CC, 00)

<a:solidFill>
<a:srgbClr val="0000FF">
<a:greenOff val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

greenOff (Green Offset)

This element specifies the input color with its green component shifted, but with its red and blue color components unchanged.

Attributes Description

val (Value) Specifies the green component as expressed by a percentage offset increase or decrease to the input color component. Increases never increase the green component beyond 100%, decreases never decrease the green component below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, CC, 00)

<a:solidFill>
<a:srgbClr val="0000FF">
<a:greenOff val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.13 hslClr (色相、饱和度、亮度颜色模型)¶

中文英文

该元素使用 HSL 颜色模型指定颜色。假设感知伽玛值为 2.2。

色调是指颜色的主波长，饱和度是指其色调的纯度，亮度是指其明度或暗度。

与所有颜色一样，使用 HSL 颜色模型定义的颜色可以应用颜色变换。

Example

具有 RGB 值 RRGGBB = (00, 00, 80) 的蓝色调当于

<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="50%">
</a:solidFill>

Attributes	Description
hue (色调/Hue)	指定描述波长的角度值. 该属性的可能值由 ST_PositiveFixedAngle 简单类型定义 (§20.1.10.44).
lum (亮度/Luminance)	指定指颜色的明度或暗度的亮度。以百分比表示，0% 表示最大暗（黑色），100% 表示最大白色. 该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).
sat (饱和度/Saturation)	指定指色调纯度的饱和度。以百分比表示，0% 指灰色，100% 指最纯粹的色调。该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_HslColor) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

hslClr (Hue, Saturation, Luminance Color Model)

This element specifies a color using the HSL color model. A perceptual gamma of 2.2 is assumed.

Hue refers to the dominant wavelength of color, saturation refers to the purity of its hue, and luminance refers to its lightness or darkness.

As with all colors, colors defined with the HSL color model can have color transforms applied to it.

Example

The color blue having RGB value RRGGBB = (00, 00, 80) is equivalent to

<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="50%">
</a:solidFill>

Attributes	Description
hue (Hue)	Specifies the angular value describing the wavelength. The possible values for this attribute are defined by the ST_PositiveFixedAngle simple type (§20.1.10.44).
lum (Luminance)	Specifies the luminance referring to the lightness or darkness of the color. Expressed as a percentage with 0% referring to maximal dark (black) and 100% referring to maximal white. The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).
sat (Saturation)	Specifies the saturation referring to the purity of the hue. Expressed as a percentage with 0% referring to grey, 100% referring to the purest form of the hue. The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_HslColor) is located in §A.4.1. end note]

20.1.2.3.14 hue (色相)¶

中文英文

该元素指定具有指定色调的输入颜色，但其饱和度和亮度不变。

Example

以下两个实体填充是等效的。

<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="50%">
</a:solidFill>
<a:solidFill>
    <a:hslClr hue="0" sat="100%" lum="50%">
        <a:hue val="14400000"/>
    <a:hslClr/>
</a:solidFill>

Attributes	Description
val (值)	指定要与输入颜色的色调分量一起使用的实际角度值. 该属性的可能值由 ST_PositiveFixedAngle 简单类型定义 (§20.1.10.44).

[Note: 该元素内容模型 (CT_PositiveFixedAngle) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

hue (Hue)

This element specifies the input color with the specified hue, but with its saturation and luminance unchanged.

Example

The following two solid fills are equivalent.

<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="50%">
</a:solidFill>
<a:solidFill>
    <a:hslClr hue="0" sat="100%" lum="50%">
        <a:hue val="14400000"/>
    <a:hslClr/>
</a:solidFill>

Attributes	Description
val (Value)	Specifies the actual angle value to be used with the input color's hue component. The possible values for this attribute are defined by the ST_PositiveFixedAngle simple type (§20.1.10.44).

[Note: The W3C XML Schema definition of this element’s content model (CT_PositiveFixedAngle) is located in §A.4.1. end note]

20.1.2.3.15 hueMod (色相调制)¶

中文英文

该元素指定输入颜色，其色调按给定百分比调制。 50% 色调调制会将角度色调值减少一半。 200% 色调调制使角度色调值加倍。

Attributes	Description
val (值)	指定色调，以相对于输入颜色的百分比表示. [Example: 以下操作将填充颜色从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB = (FF, FF, 00) `<a:solidFill>` `<a:srgbClr val="00FF00">` `<a:hueMod val="50%"/>` `</a:srgbClr>` `</a:solidFill>` end example] 该属性的可能值由 ST_PositivePercentage 简单类型定义 (§20.1.10.46).

[Note: 该元素内容模型 (CT_PositivePercentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

hueMod (Hue Modulate)

This element specifies the input color with its hue modulated by the given percentage. A 50% hue modulate decreases the angular hue value by half. A 200% hue modulate doubles the angular hue value.

Attributes Description

val (Value) Specifies the hue as expressed by a percentage relative to the input color.

[Example: The following manipulates the fill color from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB = (FF, FF, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:hueMod val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_PositivePercentage simple type (§20.1.10.46).

[Note: The W3C XML Schema definition of this element’s content model (CT_PositivePercentage) is located in §A.4.1. end note]

20.1.2.3.16 hueOff (色相偏移)¶

中文英文

该元素指定输入颜色，其色调发生变化，但饱和度和亮度不变。

Attributes Description

val (Value) 指定平移的实际角度值。平移的结果应在 0 到 360 度之间。导致角度值小于 0 的平移将被视为 0。导致角度值大于 360 的平移将被视为 360.

[Example: 下面将色调角度值增加10度.

<a:solidFill>
<a:hslClr hue="0" sat="100%" lum="50%"/>
<a:hueOff val="600000"/>
</a:solidFill>

end example]

该属性的可能值由 ST_Angle 简单类型定义 (§20.1.10.3).

[Note: 该元素内容模型 (CT_Angle) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

hueOff (Hue Offset)

This element specifies the input color with its hue shifted, but with its saturation and luminance unchanged.

Attributes Description

val (Value) Specifies the actual angular value of the shift. The result of the shift shall be between 0 and 360 degrees. Shifts resulting in angular values less than 0 are treated as 0. Shifts resulting in angular values greater than 360 are treated as 360.

[Example: The following increases the hue angular value by 10 degrees.

<a:solidFill>
<a:hslClr hue="0" sat="100%" lum="50%"/>
<a:hueOff val="600000"/>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Angle simple type (§20.1.10.3).

[Note: The W3C XML Schema definition of this element’s content model (CT_Angle) is located in §A.4.1. end note]

20.1.2.3.17 inv (逆向)¶

中文英文

该元素指定其输入颜色的反色。

!!! info "Example":

红色 (1, 0, 0) 的逆色是青色 (0, 1, 1 )。

以下代表青色，红色的反色：

```xml
<a:solidFill>
    <a:srgbClr val="FF0000">
        <a:inv/>
    </a:srgbClr>
</a:solidFill>
```

[Note: 该元素内容模型 (CT_InverseTransform) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

inv (Inverse)

This element specifies the inverse of its input color.

!!! info "Example":

The inverse of red (1, 0, 0) is cyan (0, 1, 1 ).

The following represents cyan, the inverse of red:

```xml
<a:solidFill>
    <a:srgbClr val="FF0000">
        <a:inv/>
    </a:srgbClr>
</a:solidFill>
```

[Note: The W3C XML Schema definition of this element’s content model (CT_InverseTransform) is located in §A.4.1. end note]

20.1.2.3.18 invGamma (逆向伽玛)¶

中文英文

该元素指定生成应用程序渲染的输出颜色应该是输入颜色的逆 sRGB gamma 偏移。

[Note: 该元素内容模型 (CT_InverseGammaTransform) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

invGamma (Inverse Gamma)

This element specifies that the output color rendered by the generating application should be the inverse sRGB gamma shift of the input color.

[Note: The W3C XML Schema definition of this element’s content model (CT_InverseGammaTransform) is located in §A.4.1. end note]

20.1.2.3.19 lum (亮度)¶

中文英文

该元素指定具有指定亮度的输入颜色，但其色调和饱和度保持不变。通常亮度值落在 [0%, 100%] 范围内。

example

以下两个实体填充是等效的：

<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="50%">
</a:solidFill>
<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="0%">
        <a:lum val="50%"/>
    <a:hslClr/>
</a:solidFill>

Attributes	Description
val (值)	指定亮度值。分配的值指定为百分比，0% 表示最小亮度，100% 表示最大亮度。 [Example：以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (00, 66, 00) `<a:solidFill>` `<a:srgbClr val="00FF00">` `<a:lum val="20%"/>` `</a:srgbClr>` `</a:solidFill>` end example] 该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

lum (Luminance)

This element specifies the input color with the specified luminance, but with its hue and saturation unchanged. Typically luminance values fall in the range [0%, 100%].

example

The following two solid fills are equivalent:

<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="50%">
</a:solidFill>
<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="0%">
        <a:lum val="50%"/>
    <a:hslClr/>
</a:solidFill>

Attributes Description

val (Value) Specifies the value of the luminance. The assigned value is specified as a percentage with 0% indicating minimal luminance and 100% indicating maximum luminance.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, 66, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:lum val="20%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.20 lumMod (亮度调制)¶

中文英文

该元素指定输入颜色，其亮度按给定百分比调制。 50% 亮度调制会将亮度降低一半。 200% 亮度调制使亮度加倍。

Attributes Description

val (Value) 指定以相对于输入颜色的百分比表示的亮度。增加绝不会将亮度增加到超过 100%，减少绝不会将亮度降低到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (00, 75, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:lumMod val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

lumMod (Luminance Modulation)

This element specifies the input color with its luminance modulated by the given percentage. A 50% luminance modulate reduces the luminance by half. A 200% luminance modulate doubles the luminance.

Attributes Description

val (Value) Specifies the luminance as expressed by a percentage relative to the input color. Increases never increase the luminance beyond 100%, decreases never decrease the luminance below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, 75, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:lumMod val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.21 lumOff (亮度偏移)¶

中文英文

该元素指定亮度发生变化但色调和饱和度不变的输入颜色。

Attributes Description

val (Value) 指定以相对于输入颜色的偏移增加或减少的百分比表示的亮度。增加绝不会将亮度增加到超过 100%，减少绝不会将亮度降低到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (00, 99, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:lumOff val="-20%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

lumOff (Luminance Offset)

This element specifies the input color with its luminance shifted, but with its hue and saturation unchanged.

Attributes Description

val (Value) Specifies the luminance as expressed by a percentage offset increase or decrease to the input color. Increases never increase the luminance beyond 100%, decreases never decrease the luminance below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, 99, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:lumOff val="-20%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.22 prstClr (预设颜色)¶

中文英文

该元素指定绑定到预定义颜色集合之一的颜色。

Example

下面定义了绑定到“黑色(black)”预设颜色的实心填充。

<a:solidFill>
    <a:prstClr val="black">
</a:solidFill>

Attributes	Description
val (Value)	指定实际预设颜色值. 该属性的可能值由 ST_PresetColorVal 简单类型定义 (§20.1.10.48).

[Note: 该元素内容模型 (CT_PresetColor) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

prstClr (Preset Color)

This element specifies a color which is bound to one of a predefined collection of colors.

Example

The following defines a solid fill bound to the "black" preset color.

<a:solidFill>
    <a:prstClr val="black">
</a:solidFill>

Attributes	Description
val (Value)	Specifies the actual preset color value. The possible values for this attribute are defined by the ST_PresetColorVal simple type (§20.1.10.48).

[Note: The W3C XML Schema definition of this element’s content model (CT_PresetColor) is located in §A.4.1. end note]

20.1.2.3.23 red (红色)¶

中文英文

该元素指定具有指定红色分量的输入颜色，但其绿色和蓝色分量不变。

Attributes Description

val (值) 指定红色分量的值。分配的值指定为百分比，其中 0% 表示最小红色，100% 表示最大红色.

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (FF, FF, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:red val="100%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

red (Red)

This element specifies the input color with the specified red component, but with its green and blue color components unchanged.

Attributes Description

val (Value) Specifies the value of the red component. The assigned value is specified as a percentage with 0% indicating minimal red and 100% indicating maximum red.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (FF, FF, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:red val="100%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.24 redMod (红色调制)¶

中文英文

该元素指定输入颜色，其红色分量按给定百分比调制。 50% 红色调制将红色分量减少一半。 200% 红色调制使红色分量加倍。

Attributes Description

val (Value) 指定红色分量，以相对于输入颜色分量的百分比表示。增加永远不会将红色分量增加到超过 100%，减少永远不会将红色分量减少到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (FF, 00, 00) 更改为值 RRGGBB= (80, 00, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:redMod val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

redMod (Red Modulation)

This element specifies the input color with its red component modulated by the given percentage. A 50% red modulate reduces the red component by half. A 200% red modulate doubles the red component.

Attributes Description

val (Value) Specifies the red component as expressed by a percentage relative to the input color component. Increases never increase the red component beyond 100%, decreases never decrease the red component below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (FF, 00, 00) to value RRGGBB= (80, 00, 00)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:redMod val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.25 redOff (红色偏移)¶

中文英文

该元素指定输入颜色，其红色分量发生偏移，但绿色和蓝色分量不变。

Attributes Description

val (Value) 指定红色分量，以相对于输入颜色分量的偏移增加或减少的百分比表示。增加永远不会将红色分量增加到超过 100%，减少永远不会将红色分量减少到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (FF, 00, 00) 更改为值 RRGGBB= (CC, 00, 00)

<a:solidFill>
<a:srgbClr val="FF0000">
<a:redOff val="-20%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

redOff (Red Offset)

This element specifies the input color with its red component shifted, but with its green and blue color components unchanged.

Attributes Description

val (Value) Specifies the red component as expressed by a percentage offset increase or decrease to the input color component. Increases never increase the red component beyond 100%, decreases never decrease the red component below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (FF, 00, 00) to value RRGGBB= (CC, 00, 00)

<a:solidFill>
<a:srgbClr val="FF0000">
<a:redOff val="-20%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.26 sat (饱和度)¶

中文英文

该元素指定具有指定饱和度的输入颜色，但其色调和亮度不变。通常饱和度值落在 [0%, 100%] 范围内。

Example

以下两个实体填充是等效的：

<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="50%">
</a:solidFill>
<a:solidFill>
    <a:hslClr hue="14400000" sat="0%" lum="50%">
    <a:sat val="100000"/>
    <a:hslClr/>
</a:solidFill>

Attributes Description

val (Value) 指定饱和度的值。分配的值指定为百分比，其中 0% 表示最小饱和度，100% 表示最大饱和度。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (40, C0, 40)

<a:solidFill>
<a:srgbClr val="FF0000">
<a:sat val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

sat (Saturation)

This element specifies the input color with the specified saturation, but with its hue and luminance unchanged. Typically saturation values fall in the range [0%, 100%].

Example

The following two solid fills are equivalent:

<a:solidFill>
    <a:hslClr hue="14400000" sat="100%" lum="50%">
</a:solidFill>
<a:solidFill>
    <a:hslClr hue="14400000" sat="0%" lum="50%">
    <a:sat val="100000"/>
    <a:hslClr/>
</a:solidFill>

Attributes Description

val (Value) Specifies the value of the saturation. The assigned value is specified as a percentage with 0% indicating minimal saturation and 100% indicating maximum saturation.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (40, C0, 40)

<a:solidFill>
<a:srgbClr val="FF0000">
<a:sat val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.27 satMod (饱和度调制)¶

中文英文

该元素指定输入颜色，其饱和度按给定百分比调制。 50% 饱和度调制可将饱和度降低一半。 200% 饱和度调制使饱和度加倍。

Attributes Description

val (Value) 指定饱和度，以相对于输入颜色的百分比表示。增加永远不会将饱和度增加到超过 100%，减少永远不会将饱和度降低到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (66, 99, 66)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:satMod val="20%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

satMod (Saturation Modulation)

This element specifies the input color with its saturation modulated by the given percentage. A 50% saturation modulate reduces the saturation by half. A 200% saturation modulate doubles the saturation.

Attributes Description

val (Value) Specifies the saturation as expressed by a percentage relative to the input color. Increases never increase the saturation beyond 100%, decreases never decrease the saturation below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (66, 99, 66)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:satMod val="20%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.28 satOff (饱和度偏移)¶

中文英文

该元素指定饱和度发生变化但色调和亮度不变的输入颜色。 20% 饱和度偏移 10% 会产生 30% 饱和度。

Attributes Description

val (值) 指定饱和度，以输入颜色的偏移增加或减少百分比表示。增加永远不会将饱和度增加到超过 100%，减少永远不会将饱和度降低到 0% 以下。

[Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (19, E5, 19)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:satOff val="-20%"/>
</a:srgbClr>
</a:solidFill>

end example]

该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_Percentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

satOff (Saturation Offset)

This element specifies the input color with its saturation shifted, but with its hue and luminance unchanged. A 10% offset to 20% saturation yields 30% saturation.

Attributes Description

val (Value) Specifies the saturation as expressed by a percentage offset increase or decrease to the input color. Increases never increase the saturation beyond 100%, decreases never decrease the saturation below 0%.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00)to value RRGGBB= (19, E5, 19)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:satOff val="-20%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_Percentage) is located in §A.4.1. end note]

20.1.2.3.29 schemeClr (方案颜色)¶

中文英文

该元素指定与用户主题绑定的颜色。与定义颜色的所有元素一样，可以将颜色变换列表应用于定义的基色。

Attributes	Description
val (值)	指定所需的方案. [Example: 以下代表与“lt1”主题颜色绑定的颜色 `<a:solidFill>` `<a:schemeClr val="lt1"/>` `</a:solidFill>` end example] 该属性的可能值由 ST_SchemeColorVal 简单类型定义 (§20.1.10.54).

[Note: 该元素内容模型 (CT_SchemeColor) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

schemeClr (Scheme Color)

This element specifies a color bound to a user's theme. As with all elements which define a color, it is possible to apply a list of color transforms to the base color defined.

Attributes	Description
val (Value)	Specifies the desired scheme. [Example: The following represents a color bound to the "lt1" theme color `<a:solidFill>` `<a:schemeClr val="lt1"/>` `</a:solidFill>` end example] The possible values for this attribute are defined by the ST_SchemeColorVal simple type (§20.1.10.54).

[Note: The W3C XML Schema definition of this element’s content model (CT_SchemeColor) is located in §A.4.1. end note]

20.1.2.3.30 scrgbClr (RGB 颜色模型 - 百分比变体)¶

中文英文

该元素使用红、绿、蓝 RGB 颜色模型指定颜色。每个分量（红色、绿色和蓝色）均表示为 0% 到 100% 的百分比。假设线性伽马为 1.0。

指定红色级别，以相对于输入颜色的偏移增加或减少百分比表示。

Example

以下代表相同颜色

<a:solidFill>
    <a:scrgbClr r="50%" g="50%" b="50%"/>
</a:solidFill>
<a:solidFill>
    <a:srgbClr val="BCBCBC"/>
</a:solidFill>

Attributes	Description
b (Blue)	指定蓝色的百分比. 该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).
g (Green)	指定绿色的百分比. 该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).
r (Red)	指定红色的百分比. 该属性的可能值由 ST_Percentage 简单类型定义 (§20.1.10.40).

[Note: 该元素内容模型 (CT_ScRgbColor) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

scrgbClr (RGB Color Model - Percentage Variant)

This element specifies a color using the red, green, blue RGB color model. Each component, red, green, and blue is expressed as a percentage from 0% to 100%. A linear gamma of 1.0 is assumed.

Specifies the level of red as expressed by a percentage offset increase or decrease relative to the input color.

Example

The following represent the same color

<a:solidFill>
    <a:scrgbClr r="50%" g="50%" b="50%"/>
</a:solidFill>
<a:solidFill>
    <a:srgbClr val="BCBCBC"/>
</a:solidFill>

Attributes	Description
b (Blue)	Specifies the percentage of blue. The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).
g (Green)	Specifies the percentage of green. The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).
r (Red)	Specifies the percentage of red. The possible values for this attribute are defined by the ST_Percentage simple type (§20.1.10.40).

[Note: The W3C XML Schema definition of this element’s content model (CT_ScRgbColor) is located in §A.4.1. end note]

20.1.2.3.31 shade (阴影)¶

中文英文

该元素指定其输入颜色的较暗版本。 10% 阴影是输入颜色的 10% 与 90% 黑色的组合。

Attributes	Description
val (Value)	指定以百分比值表示的阴影. [Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (00, BC, 00) `<a:solidFill>` `<a:srgbClr val="FF0000">` `<a:shade val="50%"/>` `</a:srgbClr>` `</a:solidFill>` end example] 该属性的可能值由 ST_PositiveFixedPercentage 简单类型定义 (§20.1.10.45).

[Note: 该元素内容模型 (CT_PositiveFixedPercentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

shade (Shade)

This element specifies a darker version of its input color. A 10% shade is 10% of the input color combined with 90% black.

Attributes Description

val (Value) Specifies the shade as expressed by a percentage value.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (00, BC, 00)

<a:solidFill>
<a:srgbClr val="FF0000">
<a:shade val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_PositiveFixedPercentage simple type (§20.1.10.45).

[Note: 该元素内容模型 (CT_PositiveFixedPercentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

20.1.2.3.32 srgbClr (RGB 颜色模型 - 十六进制变体)¶

中文英文

该元素使用红、绿、蓝 RGB 颜色模型指定颜色。红色、绿色和蓝色表示为十六进制数字序列 RRGGBB。使用 2.2 的感知伽玛。

指定红色级别，以相对于输入颜色的偏移增加或减少百分比表示。

!!! info "Example":

以下代表相同颜色

```xml
<a:solidFill>
    <a:scrgbClr r="50%" g="50%" b="50%"/>
</a:solidFill>
<a:solidFill>
    <a:srgbClr val="BCBCBC"/>
</a:solidFill>
```

Attributes	Description
val (值)	实际颜色值。表示为十六进制数字 RRGGBB 序列。该属性的可能值由 ST_HexColorRGB 简单类型定义 (§22.9.2.5).

[Note: The W3C XML Schema definition of this element’s content model (CT_SRgbColor) is located in §A.4.1. end note]

srgbClr (RGB Color Model - Hex Variant)

This element specifies a color using the red, green, blue RGB color model. Red, green, and blue is expressed as sequence of hex digits, RRGGBB. A perceptual gamma of 2.2 is used.

Specifies the level of red as expressed by a percentage offset increase or decrease relative to the input color.

!!! info "Example":

The following represent the same color

```xml
<a:solidFill>
    <a:scrgbClr r="50%" g="50%" b="50%"/>
</a:solidFill>
<a:solidFill>
    <a:srgbClr val="BCBCBC"/>
</a:solidFill>
```

Attributes	Description
val (Value)	The actual color value. Expressed as a sequence of hex digits RRGGBB. The possible values for this attribute are defined by the ST_HexColorRGB simple type (§22.9.2.5).

[Note: 该元素内容模型 (CT_SRgbColor) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

20.1.2.3.33 sysClr (系统颜色)¶

中文英文

该元素指定绑定到预定义操作系统元素的颜色。

!!! info "Example":

以下表示用于在窗口中显示文本的默认颜色。

```xml
<a:solidFill>
    <a:sysClr val="windowText"/>
</a:solidFill>
```

Attributes	Description
lastClr (最后的颜色)	指定生成应用程序最后计算的颜色值该属性的可能值由 ST_HexColorRGB 简单类型定义 (§22.9.2.5).
val (值)	指定系统颜色值. 该属性的可能值由 ST_SystemColorVal 简单类型定义 (§20.1.10.58).

[Note: 该元素内容模型 (CT_SystemColor) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

sysClr (System Color)

This element specifies a color bound to predefined operating system elements.

!!! info "Example":

The following represents the default color used for displaying text in a window.

```xml
<a:solidFill>
    <a:sysClr val="windowText"/>
</a:solidFill>
```

Attributes	Description
lastClr (Last Color)	Specifies the color value that was last computed by the generating application The possible values for this attribute are defined by the ST_HexColorRGB simple type (§22.9.2.5).
val (Value)	Specifies the system color value. The possible values for this attribute are defined by the ST_SystemColorVal simple type (§20.1.10.58).

[Note: The W3C XML Schema definition of this element’s content model (CT_SystemColor) is located in §A.4.1. end note]

20.1.2.3.34 tint (色调)¶

中文英文

该元素指定其输入颜色的较浅版本。 10% 色调是输入颜色的 10% 与 90% 白色调结合。

Attributes	Description
val (Value)	指定以百分比值表示的色调. [Example: 以下操作将填充从 RGB 值 RRGGBB = (00, FF, 00) 更改为值 RRGGBB= (BC, FF, BC) `<a:solidFill>` `<a:srgbClr val="00FF00">` `<a:tint val="50%"/>` `</a:srgbClr>` `</a:solidFill>` end example] 该属性的可能值由 ST_PositiveFixedPercentage 简单类型 (§20.1.10.45) 定义。

[Note: 该元素内容模型 (CT_PositiveFixedPercentage) 的 W3C XML 架构定义位于 §A.4.1 中。 end note]

tint (Tint)

This element specifies a lighter version of its input color. A 10% tint is 10% of the input color combined with 90% white.

Attributes Description

val (Value) Specifies the tint as expressed by a percentage value.

[Example: The following manipulates the fill from having RGB value RRGGBB = (00, FF, 00) to value RRGGBB= (BC, FF, BC)

<a:solidFill>
<a:srgbClr val="00FF00">
<a:tint val="50%"/>
</a:srgbClr>
</a:solidFill>

end example]

The possible values for this attribute are defined by the ST_PositiveFixedPercentage simple type (§20.1.10.45).

[Note: The W3C XML Schema definition of this element’s content model (CT_PositiveFixedPercentage) is located in §A.4.1. end note]

最后更新: 2024年4月11日
创建日期: 2024年4月11日