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

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

前述のとおり、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 プロパティを介してプレゼンテーションファイルに関連付けられたドキュメントプロパティを表すクラス IDocumentProperties を提供します。開発者は Presentation オブジェクトが公開する IDocumentProperties プロパティを使用して、以下のようにプレゼンテーションファイルのドキュメントプロパティにアクセスできます。

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

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

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

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 ドキュメントプロパティを変更する方法を示しています。

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 では、プレゼンテーションのドキュメントプロパティにカスタム値を追加することもできます。以下の例は、プレゼンテーションにカスタムプロパティを設定する方法を示しています。

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 では、カスタムプロパティの値にアクセスすることも可能です。以下の例は、プレゼンテーションのすべてのカスタムプロパティにアクセスし、変更する方法を示しています。

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 クラスが公開する Language_Id プロパティを提供し、PowerPoint ドキュメントの校正言語を設定できます。校正言語は、PowerPoint のスペルチェックや文法チェックが行われる言語です。

以下の Python コードは、PowerPoint の校正言語を設定する方法を示しています。

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 プレゼンテーション全体のデフォルト言語を設定する方法を示しています。

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 オンラインアプリを試して、Aspose.Slides API を使用したドキュメントプロパティの操作方法をご確認ください。

FAQ

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

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

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

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

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

はい、可能です。PresentationFactory クラスの get_presentation_info メソッドを使用してプレゼンテーション情報を取得し、続いて PresentationInfo クラスの read_document_properties メソッドでプロパティを読み取ることで、メモリ使用量を抑えながら効率的にプロパティを取得できます。

Python の安全なプレゼンテーション Python でプレゼンテーションのビュープロパティを取得および更新

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

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

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