PPGLayout.AddStaticText

PPGLayout.AddStaticText operator

導入

v4.2

詳細

プロパティページに直接表示される読み取り専用の静的な文字列を追加します。この文字列はパラメータのラベルに似ていますが、どのパラメータにも関連付けられません。これは基本的な説明文をユーザインターフェイスに直接追加できる便利なコントロールです。改行を使用してテキストの行数を増やすことができます(例:VBScript の vbCrLf on および Jscript の ¥n)。

注:この操作を行っても、siControlStaticを使用することにより文字列パラメータの値から静的コントロールのテキストを読み取ることは可能です(siPPGControlType を参照)。ただし、このメソッドは Parameter の関連付けが一切不要であるため、高速かつ効果的です。

C#構文

PPGItem PPGLayout.AddStaticText( String in_Text, Int32 in_opt_width, Int32 in_opt_Height );

スクリプト構文

oReturn = PPGLayout.AddStaticText( [Text], [Width], [Height] );

戻り値

PPGItem

パラメータ

パラメータ タイプ 説明
Text String 静的なコントロールを表示する文字列。PPGItem.Label を設定することにより変更できます。
Width Long 固定テキストの幅指定しない場合は、プロパティページに指定されている長さが使用され、それに適応しない場合は禁則処理されません。

デフォルト値: 0

Height Long テキストの高さ。指定されない場合は、テキストの行数に基づいて計算されます。

デフォルト値: 0

JScript の例

/*

	This example places some text directly on the layout

*/

var oPSet = ActiveSceneRoot.AddProperty( "CustomProperty", false, "StaticTextDemo" ) ;

oPSet.AddParameter3( "A", siDouble ) 

oPSet.AddParameter3( "B", siDouble ) 

oPSet.AddParameter3( "C", siDouble ) 

var oLayout = oPSet.PPGLayout

oLayout.AddRow();

var text = "\nThis is some text \nthat goes beside the \nparameters."

	oLayout.AddStaticText( text )

	oLayout.AddGroup()

		oLayout.AddItem( "A" )

		oLayout.AddItem( "B" )

		oLayout.AddItem( "C" )

	oLayout.EndGroup()

oLayout.EndRow();

InspectObj( oPSet ) ;

関連項目

PPGItem