Class OdfSlide

Namespace

OdfKit.Presentation

Assembly

OdfKit.dll

Provides the OdfSlide API. 提供 OdfSlide API。

public class OdfSlide

Inheritance

object

OdfSlide

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Constructors

OdfSlide(OdfNode, PresentationDocument)

Represents a presentation slide. 表示簡報投影片（Slide）的類別。

public OdfSlide(OdfNode node, PresentationDocument doc)

Parameters

node OdfNode

The underlying OdfKit.DOM.OdfNode instance. / 底層的 OdfKit.DOM.OdfNode 執行個體。

doc PresentationDocument

The owning presentation document instance. / 所屬的簡報文件執行個體。

Properties

AnimationRoot

Gets the animation root node. 取得動畫根節點。

public OdfAnimationNode AnimationRoot { get; }

Property Value

OdfAnimationNode

BackgroundColor

Gets or sets the slide background color, such as #FFFFFF. 取得或設定投影片背景色（例如 #FFFFFF）。

public string? BackgroundColor { get; set; }

Property Value

string

Connectors

Gets the connectors on the slide. 取得投影片上的連接線清單。

public IReadOnlyList<OdfShape> Connectors { get; }

Property Value

IReadOnlyList<OdfShape>

Document

Gets the owning presentation document. 取得所屬的簡報文件。

public PresentationDocument Document { get; }

Property Value

PresentationDocument

EmbeddedTables

Gets the embedded tables on the slide. 取得投影片上的嵌入表格清單。

public IReadOnlyList<OdfEmbeddedTable> EmbeddedTables { get; }

Property Value

IReadOnlyList<OdfEmbeddedTable>

Groups

Gets the drawing groups on the slide. 取得投影片上的繪圖群組清單。

public IReadOnlyList<OdfDrawGroup> Groups { get; }

Property Value

IReadOnlyList<OdfDrawGroup>

MasterPageName

Gets or sets the master page name used by the slide. 取得或設定投影片使用的母片名稱。

public string MasterPageName { get; set; }

Property Value

string

MediaObjects

Gets the media objects on the slide. 取得投影片上的媒體物件清單。

public IReadOnlyList<OdfMediaObject> MediaObjects { get; }

Property Value

IReadOnlyList<OdfMediaObject>

Name

Gets or sets the slide name. 取得或設定投影片名稱。

public string Name { get; set; }

Property Value

string

Pictures

Gets the pictures on the slide. 取得投影片上的圖片清單。

public IReadOnlyList<OdfPicture> Pictures { get; }

Property Value

IReadOnlyList<OdfPicture>

Placeholders

Gets the read-only list of all placeholders in the slide. 取得投影片中所有預留位置的唯讀清單。

public IReadOnlyList<OdfPlaceholder> Placeholders { get; }

Property Value

IReadOnlyList<OdfPlaceholder>

PresentationPageLayoutName

Gets or sets the page layout name used by the slide. 取得或設定投影片使用的版面配置名稱。

public string? PresentationPageLayoutName { get; set; }

Property Value

string

Shapes

Gets the general shapes on the slide. 取得投影片上的一般圖形清單。

public IReadOnlyList<OdfShape> Shapes { get; }

Property Value

IReadOnlyList<OdfShape>

SpeakerNoteParagraphs

Gets the paragraph text of the slide speaker notes. 取得投影片備忘錄的段落文字。

public IReadOnlyList<string> SpeakerNoteParagraphs { get; }

Property Value

IReadOnlyList<string>

SpeakerNotes

Gets or sets the slide speaker notes text. 取得或設定投影片備忘錄文字。

public string SpeakerNotes { get; set; }

Property Value

string

SpeakerNotesPage

Gets the slide notes page. 取得投影片的備忘錄頁面（Notes Page）。

public OdfNotesPage SpeakerNotesPage { get; }

Property Value

OdfNotesPage

TextBoxes

Gets the text boxes on the slide. 取得投影片上的文字方塊清單。

public IReadOnlyList<OdfTextBox> TextBoxes { get; }

Property Value

IReadOnlyList<OdfTextBox>

UseDateTimeName

Gets or sets the style name used by the slide date and time field. 取得或設定投影片日期與時間使用的樣式名稱。

public string? UseDateTimeName { get; set; }

Property Value

string

UseFooterName

Gets or sets the style name used by the slide footer. 取得或設定投影片頁尾使用的樣式名稱。

public string? UseFooterName { get; set; }

Property Value

string

UseHeaderName

Gets or sets the style name used by the slide header. 取得或設定投影片頁首使用的樣式名稱。

public string? UseHeaderName { get; set; }

Property Value

string

Methods

AddAudio(string, OdfLength, OdfLength, OdfLength, OdfLength)

Short overload of AddAudio that accepts packagePath, x, y, width, and height; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 packagePath、x、y、width 與 height；其餘可選參數使用預設值並轉呼叫最長 AddAudio 多載。

public OdfMediaObject AddAudio(string packagePath, OdfLength x, OdfLength y, OdfLength width, OdfLength height)

Parameters

packagePath string

x OdfLength

y OdfLength

width OdfLength

height OdfLength

Returns

OdfMediaObject

AddAudio(string, OdfLength, OdfLength, OdfLength, OdfLength, string)

Adds an audio object to the slide. 在投影片上新增音訊物件。

public OdfMediaObject AddAudio(string packagePath, OdfLength x, OdfLength y, OdfLength width, OdfLength height, string mimeType)

Parameters

packagePath string

The audio path inside the package. / 音訊在封裝包內的路徑。

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

width OdfLength

The width. / 寬度。

height OdfLength

The height. / 高度。

mimeType string

The audio MIME type. / 音訊 MIME 類型。

Returns

OdfMediaObject

The newly created media object. / 新建立的媒體物件。

AddConnector(string, string)

Adds a connector between two drawing objects. 在兩個繪圖物件之間新增連接線。

public OdfShape AddConnector(string startShapeId, string endShapeId)

Parameters

startShapeId string

The starting object identifier. / 起點物件識別碼。

endShapeId string

The ending object identifier. / 終點物件識別碼。

Returns

OdfShape

The newly created connector shape. / 新建立的連接線圖形。

AddEmbeddedObject(string, OdfLength, OdfLength, OdfLength, OdfLength)

Adds an embedded object, such as another document or subcomponent, to the slide. 在投影片上新增內嵌物件（如其他文件或子組件）。

public OdfShape AddEmbeddedObject(string subPath, OdfLength x, OdfLength y, OdfLength w, OdfLength h)

Parameters

subPath string

The path of the embedded object inside the package. / 內嵌物件於套件內的路徑。

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

w OdfLength

The width. / 寬度。

h OdfLength

The height. / 高度。

Returns

OdfShape

The added embedded object shape instance. / 新增內嵌物件圖形執行個體。

AddEmphasisEffect(string, OdfAnimationEffect)

Short overload of AddEmphasisEffect that accepts shapeId and effect; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 shapeId 與 effect；其餘可選參數使用預設值並轉呼叫最長 AddEmphasisEffect 多載。

public OdfAnimation AddEmphasisEffect(string shapeId, OdfAnimationEffect effect)

Parameters

shapeId string

effect OdfAnimationEffect

Returns

OdfAnimation

AddEmphasisEffect(string, OdfAnimationEffect, TimeSpan)

Short overload of AddEmphasisEffect that accepts shapeId, effect, and duration; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 shapeId、effect 與 duration；其餘可選參數使用預設值並轉呼叫最長 AddEmphasisEffect 多載。

public OdfAnimation AddEmphasisEffect(string shapeId, OdfAnimationEffect effect, TimeSpan duration)

Parameters

shapeId string

effect OdfAnimationEffect

duration TimeSpan

Returns

OdfAnimation

AddEmphasisEffect(string, OdfAnimationEffect, TimeSpan, OdfAnimationTrigger)

Short overload of AddEmphasisEffect that accepts shapeId, effect, duration, and trigger; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 shapeId、effect、duration 與 trigger；其餘可選參數使用預設值並轉呼叫最長 AddEmphasisEffect 多載。

public OdfAnimation AddEmphasisEffect(string shapeId, OdfAnimationEffect effect, TimeSpan duration, OdfAnimationTrigger trigger)

Parameters

shapeId string

effect OdfAnimationEffect

duration TimeSpan

trigger OdfAnimationTrigger

Returns

OdfAnimation

AddEmphasisEffect(string, OdfAnimationEffect, TimeSpan, OdfAnimationTrigger, TimeSpan)

Adds an emphasis animation to the specified shape. 為指定的圖形新增物件強調動畫。

public OdfAnimation AddEmphasisEffect(string shapeId, OdfAnimationEffect effect, TimeSpan duration, OdfAnimationTrigger trigger, TimeSpan delay)

Parameters

shapeId string

The target shape identifier. / 目標圖形識別碼。

effect OdfAnimationEffect

The animation effect type. / 動畫效果類型。

duration TimeSpan

The animation duration; defaults to 0.5 seconds. / 動畫持續時間；預設為 0.5 秒。

trigger OdfAnimationTrigger

The animation trigger mode. / 動畫觸發方式。

delay TimeSpan

The animation startup delay. / 動畫延遲啟動時間。

Returns

OdfAnimation

The added animation object instance. / 新增的動畫物件執行個體。

AddEntranceEffect(string, OdfAnimationEffect, OdfAnimationTrigger)

Short overload of AddEntranceEffect that accepts shapeId, effect, and trigger; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 shapeId、effect 與 trigger；其餘可選參數使用預設值並轉呼叫最長 AddEntranceEffect 多載。

public OdfAnimation AddEntranceEffect(string shapeId, OdfAnimationEffect effect, OdfAnimationTrigger trigger)

Parameters

shapeId string

effect OdfAnimationEffect

trigger OdfAnimationTrigger

Returns

OdfAnimation

AddEntranceEffect(string, OdfAnimationEffect, OdfAnimationTrigger, TimeSpan)

Short overload of AddEntranceEffect that accepts shapeId, effect, trigger, and delay; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 shapeId、effect、trigger 與 delay；其餘可選參數使用預設值並轉呼叫最長 AddEntranceEffect 多載。

public OdfAnimation AddEntranceEffect(string shapeId, OdfAnimationEffect effect, OdfAnimationTrigger trigger, TimeSpan delay)

Parameters

shapeId string

effect OdfAnimationEffect

trigger OdfAnimationTrigger

delay TimeSpan

Returns

OdfAnimation

AddEntranceEffect(string, OdfAnimationEffect, OdfAnimationTrigger, TimeSpan, TimeSpan)

Adds an entrance animation to the specified shape. 為指定的圖形新增物件進場動畫。

public OdfAnimation AddEntranceEffect(string shapeId, OdfAnimationEffect effect, OdfAnimationTrigger trigger, TimeSpan delay, TimeSpan duration)

Parameters

shapeId string

The target shape identifier. / 目標圖形識別碼。

effect OdfAnimationEffect

The animation effect type. / 動畫效果類型。

trigger OdfAnimationTrigger

The animation trigger mode. / 動畫觸發方式。

delay TimeSpan

The animation startup delay. / 動畫延遲啟動時間。

duration TimeSpan

The animation duration; defaults to 0.5 seconds. / 動畫持續時間；預設為 0.5 秒。

Returns

OdfAnimation

The added animation object instance. / 新增的動畫物件執行個體。

AddExitEffect(string, OdfAnimationEffect, OdfAnimationTrigger)

Short overload of AddExitEffect that accepts shapeId, effect, and trigger; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 shapeId、effect 與 trigger；其餘可選參數使用預設值並轉呼叫最長 AddExitEffect 多載。

public OdfAnimation AddExitEffect(string shapeId, OdfAnimationEffect effect, OdfAnimationTrigger trigger)

Parameters

shapeId string

effect OdfAnimationEffect

trigger OdfAnimationTrigger

Returns

OdfAnimation

AddExitEffect(string, OdfAnimationEffect, OdfAnimationTrigger, TimeSpan)

Short overload of AddExitEffect that accepts shapeId, effect, trigger, and delay; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 shapeId、effect、trigger 與 delay；其餘可選參數使用預設值並轉呼叫最長 AddExitEffect 多載。

public OdfAnimation AddExitEffect(string shapeId, OdfAnimationEffect effect, OdfAnimationTrigger trigger, TimeSpan delay)

Parameters

shapeId string

effect OdfAnimationEffect

trigger OdfAnimationTrigger

delay TimeSpan

Returns

OdfAnimation

AddExitEffect(string, OdfAnimationEffect, OdfAnimationTrigger, TimeSpan, TimeSpan)

Adds an exit animation to the specified shape. 為指定的圖形新增物件退場動畫。

public OdfAnimation AddExitEffect(string shapeId, OdfAnimationEffect effect, OdfAnimationTrigger trigger, TimeSpan delay, TimeSpan duration)

Parameters

shapeId string

The target shape identifier. / 目標圖形識別碼。

effect OdfAnimationEffect

The animation effect type. / 動畫效果類型。

trigger OdfAnimationTrigger

The animation trigger mode. / 動畫觸發方式。

delay TimeSpan

The animation startup delay. / 動畫延遲啟動時間。

duration TimeSpan

The animation duration; defaults to 0.5 seconds. / 動畫持續時間；預設為 0.5 秒。

Returns

OdfAnimation

The added animation object instance. / 新增的動畫物件執行個體。

AddGroup()

Adds an unnamed drawing group to the slide. 新增未命名的繪圖群組至投影片。

public OdfDrawGroup AddGroup()

Returns

OdfDrawGroup

The newly created group. / 新建立的群組。

AddGroup(string?)

Adds a drawing group to the slide. 新增繪圖群組至投影片。

public OdfDrawGroup AddGroup(string? name)

Parameters

name string

The optional group name. / 選用的群組名稱。

Returns

OdfDrawGroup

The newly created group. / 新建立的群組。

AddLine(OdfLength, OdfLength, OdfLength, OdfLength)

Adds a line shape to the slide. 在投影片上新增直線圖形。

public OdfShape AddLine(OdfLength x1, OdfLength y1, OdfLength x2, OdfLength y2)

Parameters

x1 OdfLength

The starting X-axis coordinate position. / 起點 X 軸座標位置。

y1 OdfLength

The starting Y-axis coordinate position. / 起點 Y 軸座標位置。

x2 OdfLength

The ending X-axis coordinate position. / 終點 X 軸座標位置。

y2 OdfLength

The ending Y-axis coordinate position. / 終點 Y 軸座標位置。

Returns

OdfShape

The added line shape instance. / 新增的直線圖形執行個體。

AddPicture(byte[], OdfLength, OdfLength, OdfLength, OdfLength)

Short overload of AddPicture that accepts imageBytes, x, y, w, and h; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 imageBytes、x、y、w 與 h；其餘可選參數使用預設值並轉呼叫最長 AddPicture 多載。

public OdfPicture AddPicture(byte[] imageBytes, OdfLength x, OdfLength y, OdfLength w, OdfLength h)

Parameters

imageBytes byte[]

x OdfLength

y OdfLength

w OdfLength

h OdfLength

Returns

OdfPicture

AddPicture(byte[], OdfLength, OdfLength, OdfLength, OdfLength, string?)

Adds an image to the slide. 在投影片上新增圖片。

public OdfPicture AddPicture(byte[] imageBytes, OdfLength x, OdfLength y, OdfLength w, OdfLength h, string? altText)

Parameters

imageBytes byte[]

The image byte array. / 圖片的位元組陣列。

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

w OdfLength

The width. / 寬度。

h OdfLength

The height. / 高度。

altText string

The optional image alternative text. / 選用的圖片替代文字。

Returns

OdfPicture

The added picture shape instance. / 新增的圖片圖形執行個體。

AddPlaceholder(OdfPlaceholderType, OdfLength, OdfLength, OdfLength, OdfLength)

Adds a placeholder to the slide. 在投影片上新增一個預留位置（Placeholder）。

public OdfPlaceholder AddPlaceholder(OdfPlaceholderType type, OdfLength x, OdfLength y, OdfLength w, OdfLength h)

Parameters

type OdfPlaceholderType

The placeholder type. / 預留位置類型。

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

w OdfLength

The width. / 寬度。

h OdfLength

The height. / 高度。

Returns

OdfPlaceholder

The added placeholder shape instance. / 新增的預留位置圖形執行個體。

AddPolyline(IEnumerable<PointF>, OdfLength, OdfLength, OdfLength, OdfLength)

Adds a polyline shape to the slide. 在投影片上新增折線圖形。

public OdfShape AddPolyline(IEnumerable<PointF> points, OdfLength x, OdfLength y, OdfLength w, OdfLength h)

Parameters

points IEnumerable<PointF>

The point coordinate collection. / 點座標集合。

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

w OdfLength

The width. / 寬度。

h OdfLength

The height. / 高度。

Returns

OdfShape

The added polyline shape instance. / 新增的折線圖形執行個體。

AddShape(OdfShapeType, OdfLength, OdfLength, OdfLength, OdfLength)

Adds a basic shape to the slide. 在投影片上新增基本圖形。

public OdfShape AddShape(OdfShapeType shapeType, OdfLength x, OdfLength y, OdfLength w, OdfLength h)

Parameters

shapeType OdfShapeType

The shape type. / 圖形類型。

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

w OdfLength

The width. / 寬度。

h OdfLength

The height. / 高度。

Returns

OdfShape

The added shape instance. / 新增的圖形執行個體。

AddTable(int, int, OdfLength, OdfLength, OdfLength, OdfLength)

Adds an embedded table to the slide. 新增嵌入表格至投影片。

public OdfEmbeddedTable AddTable(int rows, int columns, OdfLength x, OdfLength y, OdfLength width, OdfLength height)

Parameters

rows int

The row count. / 列數。

columns int

The column count. / 欄數。

x OdfLength

The X-axis coordinate. / X 軸座標。

y OdfLength

The Y-axis coordinate. / Y 軸座標。

width OdfLength

The width. / 寬度。

height OdfLength

The height. / 高度。

Returns

OdfEmbeddedTable

The newly created embedded table. / 新建立的嵌入表格。

AddTextBox(OdfLength, OdfLength, OdfLength, OdfLength, IEnumerable<string>)

Adds a multi-paragraph text box to the slide. 在投影片上新增多段落文字方塊。

public OdfTextBox AddTextBox(OdfLength x, OdfLength y, OdfLength w, OdfLength h, IEnumerable<string> paragraphs)

Parameters

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

w OdfLength

The width. / 寬度。

h OdfLength

The height. / 高度。

paragraphs IEnumerable<string>

The paragraph text collection. / 段落文字集合。

Returns

OdfTextBox

The added text box shape instance. / 新增的文字方塊圖形執行個體。

AddTextBox(OdfLength, OdfLength, OdfLength, OdfLength, string)

Adds a text box to the slide. 在投影片上新增文字方塊。

public OdfTextBox AddTextBox(OdfLength x, OdfLength y, OdfLength w, OdfLength h, string text)

Parameters

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

w OdfLength

The width. / 寬度。

h OdfLength

The height. / 高度。

text string

The text content. / 文字內容。

Returns

OdfTextBox

The added text box shape instance. / 新增的文字方塊圖形執行個體。

AddTextBox(OdfLength, OdfLength, OdfLength, OdfLength, string, OdfTextFontFallbackOptions)

Adds a text box with the specified font fallback options. 使用指定的字型遞補選項新增文字方塊。

public OdfTextBox AddTextBox(OdfLength x, OdfLength y, OdfLength w, OdfLength h, string text, OdfTextFontFallbackOptions options)

Parameters

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

w OdfLength

The width. / 寬度。

h OdfLength

The height. / 高度。

text string

The text content. / 文字內容。

options OdfTextFontFallbackOptions

The font fallback options. / 字型遞補選項。

Returns

OdfTextBox

The added text box shape instance. / 新增的文字方塊圖形執行個體。

AddVideo(string, OdfLength, OdfLength, OdfLength, OdfLength)

Short overload of AddVideo that accepts packagePath, x, y, width, and height; remaining optional parameters use defaults and forward to the full overload. 便利多載：提供 packagePath、x、y、width 與 height；其餘可選參數使用預設值並轉呼叫最長 AddVideo 多載。

public OdfMediaObject AddVideo(string packagePath, OdfLength x, OdfLength y, OdfLength width, OdfLength height)

Parameters

packagePath string

x OdfLength

y OdfLength

width OdfLength

height OdfLength

Returns

OdfMediaObject

AddVideo(string, OdfLength, OdfLength, OdfLength, OdfLength, string)

Adds a video object to the slide. 在投影片上新增影片物件。

public OdfMediaObject AddVideo(string packagePath, OdfLength x, OdfLength y, OdfLength width, OdfLength height, string mimeType)

Parameters

packagePath string

The video path inside the package. / 影片在封裝包內的路徑。

x OdfLength

The X-axis coordinate position. / X 軸座標位置。

y OdfLength

The Y-axis coordinate position. / Y 軸座標位置。

width OdfLength

The width. / 寬度。

height OdfLength

The height. / 高度。

mimeType string

The video MIME type. / 影片 MIME 類型。

Returns

OdfMediaObject

The newly created media object. / 新建立的媒體物件。

ApplyPresentationPageLayout(string)

Applies the presentation page layout with the specified name to this slide. 將指定名稱的投影片版面配置套用至此投影片。

public void ApplyPresentationPageLayout(string layoutName)

Parameters

layoutName string

The page layout name. / 版面配置名稱。

ClearAnimations()

Removes all recognized animation effects while preserving unknown timing content. 移除所有已辨識的動畫效果，並保留未知的時間軸內容。

public int ClearAnimations()

Returns

int

The number of removed effects. / 已移除的效果數量。

ClearConnectors()

Removes all connectors and their dependent animation effects. 移除所有連接線及其相依動畫效果。

public int ClearConnectors()

Returns

int

The number of removed connectors. / 已移除的連接線數量。

ClearDrawingObjects()

Removes all top-level drawing objects and their dependent animation effects while preserving notes and unknown content. 移除所有最上層繪圖物件與其相依動畫效果，並保留備忘稿與未知內容。

public int ClearDrawingObjects()

Returns

int

The number of removed top-level drawing objects. / 已移除的最上層繪圖物件數量。

ClearEmbeddedTables()

Removes all embedded tables and their containing drawing objects. 移除所有嵌入表格及其外層繪圖物件。

public int ClearEmbeddedTables()

Returns

int

The number of removed embedded tables. / 已移除的嵌入表格數量。

ClearGroups()

Removes all drawing groups and their dependent animation effects. 移除所有繪圖群組及其相依動畫效果。

public int ClearGroups()

Returns

int

The number of removed groups. / 已移除的群組數量。

ClearMediaObjects()

Removes all media objects and their dependent animation effects. 移除所有媒體物件及其相依動畫效果。

public int ClearMediaObjects()

Returns

int

The number of removed media objects. / 已移除的媒體物件數量。

ClearPlaceholders()

Removes all placeholders and their dependent animation effects. 移除所有預留位置及其相依動畫效果。

public int ClearPlaceholders()

Returns

int

The number removed. / 移除數量。

ClearSpeakerNotes()

Clears speaker-note paragraphs while preserving other notes-page content. 清除主講人備忘錄段落，同時保留其他備忘錄頁面內容。

public int ClearSpeakerNotes()

Returns

int

The number of removed paragraphs. / 已移除的段落數量。

FindAnimation(Predicate<OdfAnimationInfo>)

Finds the first animation effect that matches the predicate. 尋找第一個符合述詞的動畫效果。

public OdfAnimationInfo? FindAnimation(Predicate<OdfAnimationInfo> predicate)

Parameters

predicate Predicate<OdfAnimationInfo>

The matching predicate. / 比對述詞。

Returns

OdfAnimationInfo

The matching animation summary, or null. / 相符的動畫摘要；若不存在則為 null。

FindConnector(string)

Finds a connector by its drawing identifier. 依繪圖識別碼尋找連接線。

public OdfShape? FindConnector(string id)

Parameters

id string

The exact drawing identifier. / 精確的繪圖識別碼。

Returns

OdfShape

The matching connector, or null. / 相符的連接線；若不存在則為 null。

FindDrawingObject(string)

Finds a top-level drawing object by its draw or XML identifier. 依 draw 或 XML 識別碼尋找最上層繪圖物件。

public OdfShape? FindDrawingObject(string id)

Parameters

id string

The exact object identifier. / 物件的精確識別碼。

Returns

OdfShape

The matching object, or null. / 相符的物件；若不存在則為 null。

FindEmbeddedTable(string)

Finds an embedded table by its containing drawing object identifier. 依外層繪圖物件識別碼尋找嵌入表格。

public OdfEmbeddedTable? FindEmbeddedTable(string id)

Parameters

id string

The exact drawing identifier. / 精確的繪圖識別碼。

Returns

OdfEmbeddedTable

The matching table, or null. / 相符的表格；若不存在則為 null。

FindGroup(string)

Finds a drawing group by its identifier. 依識別碼尋找繪圖群組。

public OdfDrawGroup? FindGroup(string id)

Parameters

id string

The exact drawing identifier. / 精確的繪圖識別碼。

Returns

OdfDrawGroup

The matching group, or null. / 相符的群組；若不存在則為 null。

FindMediaObject(string)

Finds a media object by its drawing identifier. 依繪圖識別碼尋找媒體物件。

public OdfMediaObject? FindMediaObject(string id)

Parameters

id string

The exact drawing identifier. / 精確的繪圖識別碼。

Returns

OdfMediaObject

The matching media object, or null. / 相符的媒體物件；若不存在則為 null。

FindPlaceholder(OdfPlaceholderType)

Finds the first placeholder of the requested type. 尋找第一個指定類型的預留位置。

public OdfPlaceholder? FindPlaceholder(OdfPlaceholderType type)

Parameters

type OdfPlaceholderType

The placeholder type. / 預留位置類型。

Returns

OdfPlaceholder

The matching placeholder, or null. / 相符的預留位置；若不存在則為 null。

FindSpeakerNotesPage()

Finds the existing slide notes page without creating one. 尋找現有投影片備忘錄頁面，且不會建立新頁面。

public OdfNotesPage? FindSpeakerNotesPage()

Returns

OdfNotesPage

The notes page, or null if none exists. / 備忘錄頁面；若不存在則為 null。

GetAnimations()

Gets the summary list of all animation effects on this slide. 取得此投影片上所有動畫效果的摘要清單。

public IReadOnlyList<OdfAnimationInfo> GetAnimations()

Returns

IReadOnlyList<OdfAnimationInfo>

GetLayout()

Gets the layout type of this slide. 取得此投影片的版面配置型態。

public OdfPresentationLayout GetLayout()

Returns

OdfPresentationLayout

The layout type. / 版面配置型態。

GetPlaceholderInfos()

Gets the summary list of all placeholders in the slide. 取得投影片中所有預留位置的摘要清單。

public IReadOnlyList<OdfPlaceholderInfo> GetPlaceholderInfos()

Returns

IReadOnlyList<OdfPlaceholderInfo>

RemoveAnimations(string)

Removes all animation effects that target the specified drawing-object identifier. 移除所有以指定繪圖物件識別碼為目標的動畫效果。

public int RemoveAnimations(string targetElementId)

Parameters

targetElementId string

The exact target identifier. / 目標的精確識別碼。

Returns

int

The number of removed effects. / 已移除的效果數量。

RemoveConnector(string)

Removes a connector and its dependent animation effects. 移除連接線及其相依動畫效果。

public bool RemoveConnector(string id)

Parameters

id string

The exact drawing identifier. / 精確的繪圖識別碼。

Returns

bool

true if removed; otherwise false. / 若已移除則為 true，否則為 false。

RemoveDrawingObject(string)

Removes a top-level drawing object and dependent connectors and animation effects. 移除最上層繪圖物件，以及依賴該物件的連接線與動畫效果。

public bool RemoveDrawingObject(string id)

Parameters

id string

The exact object identifier. / 物件的精確識別碼。

Returns

bool

true if removed; otherwise false. / 若已移除則為 true，否則為 false。

RemoveEmbeddedTable(string)

Removes an embedded table and its containing drawing object. 移除嵌入表格及其外層繪圖物件。

public bool RemoveEmbeddedTable(string id)

Parameters

id string

The exact drawing identifier. / 精確的繪圖識別碼。

Returns

bool

true if removed; otherwise false. / 若已移除則為 true，否則為 false。

RemoveGroup(string)

Removes a drawing group and its dependent animation effects. 移除繪圖群組及其相依動畫效果。

public bool RemoveGroup(string id)

Parameters

id string

The exact drawing identifier. / 精確的繪圖識別碼。

Returns

bool

true if removed; otherwise false. / 若已移除則為 true，否則為 false。

RemoveMediaObject(string)

Removes a media object and its dependent animation effects. 移除媒體物件及其相依動畫效果。

public bool RemoveMediaObject(string id)

Parameters

id string

The exact drawing identifier. / 精確的繪圖識別碼。

Returns

bool

true if removed; otherwise false. / 若已移除則為 true，否則為 false。

RemovePlaceholder(OdfPlaceholder)

Removes the specified placeholder and dependent animation effects. 移除指定預留位置及其相依動畫效果。

public bool RemovePlaceholder(OdfPlaceholder placeholder)

Parameters

placeholder OdfPlaceholder

The placeholder to remove. / 要移除的預留位置。

Returns

bool

true if removed; otherwise false. / 若已移除則為 true，否則為 false。

RemoveSpeakerNotesPage()

Removes the slide notes page. 移除投影片備忘錄頁面。

public bool RemoveSpeakerNotesPage()

Returns

bool

true if the page was removed; otherwise false. / 若已移除頁面則為 true，否則為 false。

SetLayout(OdfPresentationLayout)

Sets the layout type of this slide and automatically arranges the corresponding placeholders. 設定此投影片的版面配置型態，並自動配置對應的預留位置。

public void SetLayout(OdfPresentationLayout layout)

Parameters

layout OdfPresentationLayout

The layout type. / 版面配置型態。

SetMasterPage(string)

Sets the master page name used by this slide. 設定此投影片使用的母片名稱。

public void SetMasterPage(string masterPageName)

Parameters

masterPageName string

The master page name. / 母片名稱。

SetPlaceholderText(OdfPlaceholderType, string?)

Sets the visible text of the first placeholder with the requested type. 設定第一個指定類型預留位置的可見文字。

public OdpPlaceholderUpdateResult SetPlaceholderText(OdfPlaceholderType placeholderType, string? text)

Parameters

placeholderType OdfPlaceholderType

The placeholder type. / 預留位置類型。

text string

The replacement text. / 取代文字。

Returns

OdpPlaceholderUpdateResult

The placeholder update result. / 預留位置更新結果。

SetSpeakerNotes(IEnumerable<string>)

Sets slide speaker notes as multiple paragraphs. 以多段落形式設定投影片備忘錄文字。

public OdfSlide SetSpeakerNotes(IEnumerable<string> paragraphs)

Parameters

paragraphs IEnumerable<string>

The paragraph text collection. / 段落文字集合。

Returns

OdfSlide

The current slide. / 目前投影片。

SetTransition(OdfTransitionType, OdfLength)

Sets the slide transition animation effect. 設定投影片切換動畫效果。

public void SetTransition(OdfTransitionType type, OdfLength duration)

Parameters

type OdfTransitionType

The transition effect type. / 切換效果類型。

duration OdfLength

The duration. / 持續時間。

SetTransition(OdfTransitionType, OdfLength, OdfTransitionSpeed)

Sets the slide transition animation effect and speed. 設定投影片切換動畫效果與速度。

public void SetTransition(OdfTransitionType type, OdfLength duration, OdfTransitionSpeed speed)

Parameters

type OdfTransitionType

The transition effect type. / 切換效果類型。

duration OdfLength

The duration. / 持續時間。

speed OdfTransitionSpeed

The transition speed. / 切換速度。