# 在 C++ 中管理簡報墨跡物件

> 管理 PowerPoint 墨跡物件——使用 Aspose.Slides for C++ 建立、編輯與設計數位墨跡。取得追蹤、筆刷顏色與大小的程式碼範例。

Source: https://docs.aspose.com/slides/zh-hant/cpp/manage-ink/


## **簡介**

PowerPoint 提供墨跡功能，讓您可以繪製非標準圖形，可用來標示其他物件、顯示連接與流程，並將注意力聚焦在投影片上的特定項目上。

Aspose.Slides 提供 [Aspose.Slides.Ink](https://reference.aspose.com/slides/zh-hant/cpp/aspose.slides.ink/) 介面，其中包含建立與管理墨跡物件所需的類型。

## **常規物件與墨跡物件之差異**

PowerPoint 投影片上的物件通常以形狀物件表示。形狀物件在最簡單的形式下是一個容器，定義了物件本身的區域（其框架）以及其屬性。後者包括容器區域大小、容器的形狀、容器的背景等。相關資訊請參閱 [Shape Layout Format](https://docs.aspose.com/slides/zh-hant/cpp/shape-manipulations/#access-layout-formats-for-shape)。

然而，當 PowerPoint 處理墨跡物件時，會忽略除大小之外的所有框架（容器）屬性。容器區域的大小由標準的 `width` 與 `height` 值決定：

![ink_powerpoint1](ink_powerpoint1.png)

## **墨跡形狀追蹤**

追蹤是用來記錄使用者書寫數位墨跡時筆尖軌跡的基本元素或標準。追蹤是描述相連點序列的錄音。

最簡單的編碼形式指定每個取樣點的 X 與 Y 座標。當所有相連點被渲染時，會產生如下影像：

![ink_powerpoint2](ink_powerpoint2.png)

## **繪圖筆刷屬性**

您可以使用筆刷繪製連接追蹤元素點的線條。筆刷具有其自身的顏色與大小，分別對應 `Brush.Color` 與 `Brush.Size` 屬性。

### **設定墨跡筆刷顏色**

此 C++ 程式碼示範如何設定筆刷的顏色：

```c++
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");

System::SharedPtr<IInk> ink = System::ExplicitCast<IInk>(pres->get_Slide(0)->get_Shape(0));
System::ArrayPtr<System::SharedPtr<IInkTrace>> traces = ink->get_Traces();
System::SharedPtr<IInkBrush> brush = traces[0]->get_Brush();
System::Drawing::Color brushColor = brush->get_Color();
brush->set_Color(System::Drawing::Color::get_Red());
```

### **設定墨跡筆刷大小**

此 C++ 程式碼示範如何設定筆刷的大小：

```c++
System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");

System::SharedPtr<IInk> ink = System::ExplicitCast<IInk>(pres->get_Slide(0)->get_Shape(0));
System::ArrayPtr<System::SharedPtr<IInkTrace>> traces = ink->get_Traces();
System::SharedPtr<IInkBrush> brush = traces[0]->get_Brush();
System::Drawing::SizeF brushSize = brush->get_Size();
brush->set_Size(System::Drawing::SizeF(5.0f, 10.0f));
```

一般而言，筆刷的寬度與高度不相等，PowerPoint 不會顯示筆刷大小（資料區段呈灰色）。但當筆刷寬度與高度相等時，PowerPoint 會以以下方式顯示其大小：

![ink_powerpoint3](ink_powerpoint3.png)

為了更清楚說明，我們將墨跡物件的高度增加，並檢視重要的尺寸：

![ink_powerpoint4](ink_powerpoint4.png)

容器（框架）不會考慮筆刷的大小——它始終假設線條的粗細為零（見最後一張圖）。

因此，要確定整個墨跡物件的可見區域，我們必須考慮追蹤物件的筆刷大小。此處，目標物件（手寫文字追蹤物件）已縮放至容器（框架）大小。當容器（框架）大小變更時，筆刷大小保持不變，反之亦然。

![ink_powerpoint5](ink_powerpoint5.png)

PowerPoint 在處理文字時也會出現相同的行為：

![ink_powerpoint6](ink_powerpoint6.png)

**進一步閱讀**

* 若要了解一般形狀，請參閱 [PowerPoint Shapes](https://docs.aspose.com/slides/zh-hant/cpp/powerpoint-shapes/) 章節。  
* 若需取得有效值的更多資訊，請參閱 [Shape Effective Properties](https://docs.aspose.com/slides/zh-hant/cpp/shape-effective-properties/#get-effective-font-height-value)。