# Pythonでプレゼンテーション プロパティを管理する

> Aspose.Slides for Python via .NET でプレゼンテーション プロパティをマスターし、PowerPoint ファイルの検索、ブランディング、ワークフローを効率化します。

Source: https://docs.aspose.com/slides/ja/python-net/presentation-properties/
Updated: 2025-12-08


## **プレゼンテーション プロパティについて**

前述のとおり、Aspose.Slides for Python via .NET は **Built-in** と **Custom** の 2 種類のドキュメント プロパティをサポートしています。そのため、開発者は Aspose.Slides for Python via .NET API を使用して両方のプロパティにアクセスできます。Aspose.Slides for Python via .NET は、[Presentation.document_properties](https://reference.aspose.com/slides/python-net/aspose.slides/documentproperties/) プロパティを介してプレゼンテーション ファイルに関連付けられたドキュメント プロパティを表すクラス [IDocumentProperties](https://reference.aspose.com/slides/python-net/aspose.slides/idocumentproperties/) を提供します。開発者は **Presentation** オブジェクトが公開する [IDocumentProperties](https://reference.aspose.com/slides/python-net/aspose.slides/idocumentproperties/) プロパティを使用して、以下のようにプレゼンテーション ファイルのドキュメント プロパティにアクセスできます。

{{% alert color="primary" %}} 
**Application** と **Producer** フィールドの値は設定できません。これらのフィールドには Aspose Ltd. および Aspose.Slides for Python via .NET x.x.x が表示されますのでご注意ください。
{{% /alert %}} 

## **プレゼンテーション プロパティの管理**

Microsoft PowerPoint では、プレゼンテーション ファイルにいくつかのプロパティを追加する機能が提供されています。これらのドキュメント プロパティにより、ドキュメント（プレゼンテーション ファイル）に有用な情報を保存できます。ドキュメント プロパティは以下の 2 種類に分類されます。

- システム定義 (Built-in) プロパティ
- ユーザー定義 (Custom) プロパティ

**Built-in** プロパティは、ドキュメントのタイトル、作成者名、統計情報など、ドキュメント全体に関する一般的な情報を含みます。**Custom** プロパティは、ユーザーが **Name/Value** のペアとして定義するもので、名前も値もユーザーが自由に決められます。Aspose.Slides for Python via .NET を使用すれば、Built-in プロパティと Custom プロパティの値にアクセスし、変更することができます。Microsoft PowerPoint 2007 では、プレゼンテーション ファイルのドキュメント プロパティを管理できます。手順は、Office アイコンをクリックし、**Prepare | Properties | Advanced Properties** メニュー項目を選択するだけです。**Advanced Properties** を選択すると、PowerPoint ファイルのドキュメント プロパティを管理できるダイアログが表示されます。**Properties Dialog** では、**General**, **Summary**, **Statistics**, **Contents**, **Custom** など多数のタブがあり、PowerPoint ファイルに関するさまざまな情報を設定できます。**Custom** タブは、PowerPoint ファイルのカスタム プロパティを管理するために使用します。

## **Built-in プロパティへのアクセス**
**IDocumentProperties** オブジェクトが提供するプロパティは次のとおりです: **Creator(Author)**、**Description**、**Keywords**、**Created**（作成日）、**Modified**（変更日）、**Printed**（最終印刷日）、**LastModifiedBy**、**SharedDoc**（複数のプロデューサー間で共有されているか）、**PresentationFormat**、**Subject**、**Title**  
```py
import aspose.slides as slides

# プレゼンテーションを表す Presentation クラスのインスタンス化
with slides.Presentation(path + "AccessBuiltin Properties.pptx") as pres:
    # Presentation に関連付けられたオブジェクトへの参照を作成
    documentProperties = pres.document_properties

    # 組み込みプロパティを表示
    print("category : " + documentProperties.category)
    print("Current Status : " + documentProperties.content_status)
    print("Creation Date : " + str(documentProperties.created_time))
    print("Author : " + documentProperties.author)
    print("Description : " + documentProperties.comments)
    print("KeyWords : " + documentProperties.keywords)
    print("Last Modified By : " + documentProperties.last_saved_by)
    print("Supervisor : " + documentProperties.manager)
    print("Modified Date : " + str(documentProperties.last_saved_time))
    print("Presentation Format : " + documentProperties.presentation_format)
    print("Last Print Date : " + str(documentProperties.last_printed))
    print("Is Shared between producers : " + str(documentProperties.shared_doc))
    print("Subject : " + documentProperties.subject)
    print("Title : " + documentProperties.title)
```


## **Built-in プロパティの変更**

プレゼンテーション ファイルの Built-in プロパティの変更は、アクセスと同様に簡単です。目的のプロパティに文字列値を代入すれば、プロパティの値が更新されます。以下の例では、プレゼンテーション ファイルの Built-in ドキュメント プロパティを変更する方法を示しています。  
```py
import aspose.slides as slides

# Presentation を表す Presentation クラスのインスタンス化
with slides.Presentation(path + "ModifyBuiltinProperties.pptx") as presentation:
    # Presentation に関連付けられたオブジェクトへの参照を作成
    documentProperties = presentation.document_properties

    # 組み込みプロパティを設定
    documentProperties.author = "Aspose.Slides for .NET"
    documentProperties.title = "Modifying Presentation Properties"
    documentProperties.subject = "Aspose Subject"
    documentProperties.comments = "Aspose Description"
    documentProperties.manager = "Aspose Manager"

    # プレゼンテーションをファイルに保存
    presentation.save("DocumentProperties_out.pptx", slides.export.SaveFormat.PPTX)
```


## **カスタム プレゼンテーション プロパティの追加**

Aspose.Slides for Python via .NET では、プレゼンテーションのドキュメント プロパティにカスタム値を追加することもできます。以下の例は、プレゼンテーションにカスタム プロパティを設定する方法を示しています。  
```py
import aspose.slides as slides

# Presentation クラスをインスタンス化
with slides.Presentation() as presentation:
    # ドキュメント プロパティの取得
    documentProperties = presentation.document_properties

    # カスタム プロパティの追加
    documentProperties.set_custom_property_value("New Custom", 12)
    documentProperties.set_custom_property_value("My Nam", "Mudassir")
    documentProperties.set_custom_property_value("Custom", 124)

    # 特定のインデックスのプロパティ名を取得
    getPropertyName = documentProperties.get_custom_property_name(2)

    # 選択されたプロパティの削除
    documentProperties.remove_custom_property(getPropertyName)

    # プレゼンテーションの保存
    presentation.save("CustomDocumentProperties_out.pptx", slides.export.SaveFormat.PPTX)
```


## **カスタム プロパティのアクセスと変更**

Aspose.Slides for Python via .NET では、カスタム プロパティの値にアクセスすることも可能です。以下の例は、プレゼンテーションのすべてのカスタム プロパティにアクセスし、変更する方法を示しています。  
```py
import aspose.slides as slides

# PPTX を表す Presentation クラスをインスタンス化
with slides.Presentation(path + "AccessModifyingProperties.pptx") as presentation:
    # Presentation に関連付けられた document_properties オブジェクトへの参照を作成
    documentProperties = presentation.document_properties

    # カスタム プロパティにアクセスして変更
    for i in range(documentProperties.count_of_custom_properties):
        # カスタム プロパティの名前と値を表示
        print("Custom Property Name : " + documentProperties.get_custom_property_name(i))
        print("Custom Property Value : " + documentProperties.get_custom_property_value[documentProperties.get_custom_property_name(i)])

        # カスタム プロパティの値を変更
        documentProperties.set_custom_property_value(documentProperties.get_custom_property_name(i), "New Value " + str(i + 1))
    # プレゼンテーションをファイルに保存
    presentation.save("CustomDemoModified_out.pptx", slides.export.SaveFormat.PPTX)
```


## **校正言語の設定**

Aspose.Slides は、[PortionFormat](https://reference.aspose.com/slides/python-net/aspose.slides/portionformat/) クラスが公開する `Language_Id` プロパティを提供し、PowerPoint ドキュメントの校正言語を設定できます。校正言語は、PowerPoint のスペルチェックや文法チェックが行われる言語です。

以下の Python コードは、PowerPoint の校正言語を設定する方法を示しています。  
```python
import aspose.slides as slides

with slides.Presentation(path + "SetProofingLanguage.pptx") as pres:
    auto_shape = pres.slides[0].shapes[0]
    paragraph = auto_shape.text_frame.paragraphs[0]
    paragraph.portions.clear()

    new_portion = slides.Portion()
    font = slides.FontData("SimSun")
    portion_format = new_portion.portion_format
    portion_format.complex_script_font = font
    portion_format.east_asian_font = font
    portion_format.latin_font = font

    # 校正言語の ID を設定
    portion_format.language_id = "zh-CN"
    new_portion.text = "1。"

    paragraph.portions.add(new_portion)
```


## **デフォルト言語の設定**

以下の Python コードは、PowerPoint プレゼンテーション全体のデフォルト言語を設定する方法を示しています。  
```python
import aspose.slides as slides

load_options = slides.LoadOptions()
load_options.default_text_language = "en_US"

with slides.Presentation(load_options) as pres:
    shp = pres.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 150)
    text_frame = shp.text_frame
    text_frame.text = "New Text"

    print(text_frame.paragraphs[0].portions[0].portion_format.language_id)
```


## **ライブ例**

[**Aspose.Slides Metadata**](https://products.aspose.app/slides/metadata) オンライン アプリを試して、Aspose.Slides API を使用したドキュメント プロパティの操作方法をご確認ください。

[![View & Edit PowerPoint Metadata](slides-metadata.png)](https://products.aspose.app/slides/metadata)

## **FAQ**

**プレゼンテーションから Built-in プロパティを削除するにはどうすればよいですか？**

Built-in プロパティはプレゼンテーションの不可欠な部分であり、完全に削除することはできません。ただし、プロパティが許可する場合は、値を変更したり空に設定したりできます。

**既に存在するカスタム プロパティを追加した場合はどうなりますか？**

既に存在するカスタム プロパティを追加すると、既存の値は新しい値で上書きされます。事前に削除や確認を行う必要はなく、Aspose.Slides が自動的にプロパティの値を更新します。

**プレゼンテーションを完全にロードせずにプロパティにアクセスできますか？**

はい、可能です。[PresentationFactory](https://reference.aspose.com/slides/python-net/aspose.slides/presentationfactory/) クラスの [get_presentation_info](https://reference.aspose.com/slides/python-net/aspose.slides/presentationfactory/get_presentation_info/) メソッドを使用してプレゼンテーション情報を取得し、続いて [PresentationInfo](https://reference.aspose.com/slides/python-net/aspose.slides/presentationinfo/) クラスの [read_document_properties](https://reference.aspose.com/slides/python-net/aspose.slides/presentationinfo/read_document_properties/) メソッドでプロパティを読み取ることで、メモリ使用量を抑えながら効率的にプロパティを取得できます。
