mlreportgen.ppt.Number クラス

名前空間: mlreportgen.ppt

ドキュメントに書式設定済みテキストとして含める数値

R2024b 以降

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

説明

mlreportgen.ppt.Number クラスのオブジェクトを使用して、ドキュメントに含めることができる書式設定済みテキストに数値を変換します。

この変換では、以下の書式指定のうち最初に検出したものを使用します。

  1. Number オブジェクトの Style プロパティに含まれる mlreportgen.ppt.NumberFormat オブジェクトでの指定

  2. Number オブジェクトを含む段落、リスト、テーブルなどの要素の Style プロパティに含まれる NumberFormat オブジェクトでの指定

  3. mlreportgen.ppt.setDefaultNumberFormat によって指定された既定の指定セット

変換時に書式指定が見つからなかった場合、その数値を正確に表すのに必要な最大の桁数を使用して変換が行われます。

mlreportgen.ppt.Number クラスは handle クラスです。

クラス属性

ConstructOnLoad
true
HandleCompatible
true

クラス属性の詳細については、クラスの属性を参照してください。

作成

説明

numberObj = mlreportgen.ppt.Number は、空の Number オブジェクトを作成します。Value プロパティを使用して、書式設定済みテキストに変換する数値を指定します。

numberObj = mlreportgen.ppt.Number(value) は、指定された値をもつ Number オブジェクトを作成します。

例

プロパティ

すべて展開する

書式設定済みテキストに変換する数値。スカラーとして指定します。複素数はサポートされていません。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: double

この数値をテキストに変換したときのスタイル書式。PPT 書式オブジェクトの cell 配列として指定します。変換後の数値の精度を指定するには、mlreportgen.ppt.NumberFormat オブジェクトを使用します。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: cell

このオブジェクトの親。PPT API オブジェクトとして指定します。PPT API オブジェクトの親は 1 つでなければなりません。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

クラスはこのプロパティを無視します。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

タグ。文字ベクトルまたは string スカラーとして指定します。PPT API は、このオブジェクトを作成するときに、セッション固有タグを生成します。生成されるタグの形式は CLASS:ID という形式です。ここで、CLASS はオブジェクト クラスです。ID はオブジェクトの Id プロパティの値です。この値を使用すると、プレゼンテーションの生成中に問題が発生した箇所を容易に特定できるようになります。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

オブジェクト識別子。文字ベクトルまたは string スカラーとして指定します。PPT API は、プレゼンテーション要素オブジェクトの作成時にセッション固有識別子を生成します。Id には独自の値を指定できます。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

データ型: char | string

メソッド

すべて展開する

例

すべて折りたたむ

ライブ スクリプトを開く

mlreportgen.ppt.Number クラスと mlreportgen.ppt.NumberFormat クラスを使用して、プレゼンテーションに書式設定済み数値を追加します。最初のコンテンツ スライドではセッションの既定値を使用して数値の書式設定を行い、2 番目のコンテンツ スライドでは特定の Number オブジェクトに対して書式スタイルを設定します。

PPT API クラスに完全修飾名を使用せずに済むよう、PPT 名前空間をインポートします。

import mlreportgen.ppt.*

セッションに既定の数値書式を設定します。

setDefaultNumberFormat("%0.6f");

プレゼンテーションを作成し、タイトル スライドを追加します。

ppt = Presentation('myPresentation.pptx');
open(ppt);
slideTitle = add(ppt,"Title Slide");
replace(slideTitle,"Title","Formatted Numbers");

最初のタイトルとコンテンツ スライドを作成します。スライドのタイトルに使用する mlreportgen.ppt.Paragraph オブジェクトを作成します。

slide1 = add(ppt,"Title and Content");
p1Title = Paragraph;

pi を使用して Number オブジェクトを作成し、toString メソッドで string に変換します。

number1Obj = Number(pi);
formattedNumber1 = toString(number1Obj);

書式設定済み数値を段落に追加します。

append(p1Title,string(char(960)) + " in default format: " ...
    + formattedNumber1); % char(960) - Unicode for the pi character

最初のタイトルとコンテンツ スライドのタイトルを段落に置き換えます。

replace(slide1,"Title",p1Title);

コンテンツのテキスト ボックスに既定の書式を表示します。

numberFormat = getDefaultNumberFormat();
p1Content = Paragraph("Number format is : ");
p1Content.append(numberFormat);
replace(slide1,"Content",p1Content);

2 番目のタイトルとコンテンツ スライドを作成します。スライドのタイトルに使用する mlreportgen.ppt.Paragraph オブジェクトを作成します。

slide2 = add(ppt,"Title and Content");
p2 = Paragraph;

pi を使用して Number オブジェクトを作成し、toString メソッドで string に変換します。Number の書式を指定して既定の数値書式をオーバーライドすることで、このスライドの pi の小数点以下の桁数を 2 桁に制限します。

number2Obj = Number(pi);
number2Obj.Style = NumberFormat("%0.2f");
formattedNumber2 = toString(number2Obj);

書式設定済み数値を段落に追加します。

append(p2,string(char(960)) + " in individual format: " ...
    + formattedNumber2); % char(960) - Unicode for the pi character

2 番目のタイトルとコンテンツ スライドのタイトルを段落に置き換えます。

replace(slide2,"Title",p2);

コンテンツのテキスト ボックスに個々の形式を表示します。

p2Content = Paragraph("Number format is : ");
p2Content.append("%0.2f");
replace(slide2,"Content",p2Content);

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

close(ppt);
rptview(ppt);

バージョン履歴

R2024b で導入

参考

| |