replace

テンプレート画像から別の画像への置換

このページをすべて展開する

構文

newPicture = replace(templatePicture,replacementPicture)

説明

newPicture = replace(templatePicture,replacementPicture) は、テンプレート画像を他の画像に置き換えます。

入力引数

すべて展開する

置き換えるテンプレート画像。mlreportgen.ppt.TemplatePicture オブジェクトとして指定します。

置き換えられた画像。mlreportgen.ppt.Picture オブジェクトとして指定します。

出力引数

すべて展開する

プレゼンテーション スライドの新しい画像。mlreportgen.ppt.Picture オブジェクトとして指定します。

例

すべて展開する

ライブ スクリプトを開く

既存のプレゼンテーションからプレゼンテーションを作成する場合、既存のプレゼンテーションの画像 ("テンプレート画像") は、mlreportgen.ppt.TemplatePicture オブジェクトで表されます。このオブジェクトのプロパティを設定することで、テンプレート画像の位置、幅、高さを変更できます。テンプレート画像の XML マークアップも変更できます。テンプレート画像を置き換えるには、TemplatePicture オブジェクトの replace メソッドを使用します。たとえば、'Title and Picture' レイアウトのスライドがある既存のプレゼンテーション myPresentation から、プレゼンテーションを作成するとします。次のコードでは、テンプレート画像が別の画像に置き換えられます。

プレゼンテーション MyPicturePresentation を生成し、別のプレゼンテーションのテンプレート プレゼンテーションとして使用します。MyPicturePresentation には、1 つの画像を含む 1 つのスライドがあります。

import mlreportgen.ppt.*
ppt = Presentation("MyPicturePresentation");
open(ppt);
slide1 = add(ppt,"Title and Picture");
replace(slide1,"Title","Street");
replace(slide1,"Picture",Picture("street1.jpg"));

プレゼンテーションを閉じて表示します。

close(ppt);

MyPicturePresentation からプレゼンテーション MyNewPicturePresentation を作成します。MyPicturePresentation は MyNewPicturePresentation のテンプレート プレゼンテーションです。 

ppt = Presentation("MyNewPicturePresentation","MyPicturePresentation");
open(ppt);

スライド オブジェクトの find メソッドを使用して、テンプレート画像を検索します。画像はテンプレート プレゼンテーション スライドから取得されているため、find は画像を mlreportgen.ppt.TemplatePicture オブジェクトとして返します。 

slide1 = ppt.Children(1);
templatePictureObj = find(slide1,"Picture") 
templatePictureObj = 
  TemplatePicture with properties:

    XMLMarkup: '<p:pic><p:nvPicPr><p:cNvPr id="8" name="Picture"/><p:cNvPicPr><a:picLocks noChangeAspect="1" noGrp="1"/></p:cNvPicPr><p:nvPr><p:ph idx="13" sz="quarter" type="pic"/></p:nvPr></p:nvPicPr><p:blipFill><a:blip r:embed="rId2"><a:extLst><a:ext uri="{28A0092B-C50C-407E-A947-70E740481C1C}"><a14:useLocalDpi val="0" xmlns:a14="http://schemas.microsoft.com/office/drawing/2010/main"/></a:ext></a:extLst></a:blip><a:stretch><a:fillRect/></a:stretch></p:blipFill><p:spPr/></p:pic>'
         Name: 'Picture'
            X: []
            Y: []
        Width: []
       Height: []
        Style: []
     Children: []
       Parent: [1×1 mlreportgen.ppt.Slide]
          Tag: 'ppt.TemplatePicture:70:263'
           Id: '70:263'

画像を別の画像に置き換えます。

street2 = Picture("street2.jpg");
replace(templatePictureObj,street2);

プレゼンテーションを閉じて表示します。

close(ppt);
rptview(ppt);

バージョン履歴

R2019b で導入

参考

| | |

トピック