コントロール属性を設定する

コントロール属性を使用すると、プロパティページのコントロール項目の外観を調整できます。 PPGLayout または PPGLayout オブジェクトから、PPGItem または PPGItem(レイアウトに追加する場合はPPGLayout.AddItem または PPGLayout::AddItem メソッドを介して、レイアウトをプロパティページのイベントを介して変更する場合は PPGLayout.Item または PPGLayout::GetItem プロパティを使用して)をそれぞれ取得し、GetAttribute および SetAttribute メソッドを使用して、こうした物理的な機能を、ラベルの有無に関係なく幅と高さとして設定できます。これらの属性は、ファイルウィジットで使用するファイルフィルタ(siControlFilePath)などのコントロール特有の機能や、数値パラメータ(siControlNumber)に対して、どの数値ウィジット(thumbwheel やスライダなど)を使用するかなどの基本的な側面を指定するために使用することもできます。詳細については、｢siPPGItemAttribute」を参照してください。

JScript の例: PPGItem 属性を変更する

この例では、プロパティページの作成中にコントロール属性を変更する方法と、(プロパティページロジックを介して)コントロール属性を動的に変更する方法を示します。

// Set up the underlying parameters
var oPSet = Application.ActiveSceneRoot.AddProperty( "CustomProperty", false, "Demo" );

oPSet.AddParameter3( "FileDemo", siString );
oPSet.AddParameter3( "NumberDemo", siDouble );
oPSet.AddParameter3( "Mute", siBool );

// Set up the PPGItems on the layout
var oPPGLayout = oPSet.PPGLayout;
var oParamStr = oPPGLayout.AddItem( "FileDemo", "FileDemo", siControlFilePath );
var oParamDbl = oPPGLayout.AddItem( "NumberDemo", "NumberDemo", siControlNumber );
var oParamBoo = oPPGLayout.AddItem( "Mute", "Mute", siControlBoolean );

この時点では、プロパティページは次の図のようになります。

スライダはその全長が表示され、ファイルフィルタには[すべてのファイル(*.*)]だけが提供されることに注目してください。レイアウトがまったく定義されていないプロパティセットを表示する場合は、使用されるコントロールとプロパティページ上でのレイアウトは Softimage が決定します。

PPGLayout または PPGLayout オブジェクトを使用してコントロールを明示的にセットアップします。

// For the file widget, set the file filter to *.pic and *.bmp
oParamStr.SetAttribute( siUIFileFilter, "Softimage PIC files (*.pic)|*.pic|Bitmap files (*.bmp)|*.bmp|All Files (*.*)|*.*||" );

// For the number control, specify # of decimals and use treadmill widget
oParamDbl.SetAttribute( siUIDecimals, 3 );
oParamDbl.SetAttribute( siUITreadmill, true );

// For the check box, decrease the width
oParamBoo.SetAttribute( siUIWidthPercentage, "50" );
// (equivalent to oParamBoo.WidthPercentage = 50;)

次に、ファイルフィルタ、数値コントロール、チェックボックスに変更を加えた結果を示します。

最後に、siUIContinue 属性を数値コントロール上で動的に変更する(OnClicked ボタンイベントを介して)いくつかのロジックを追加します。

// Add a click event to the button which will demonstrate 
// how to set these attributes via property page logic
oPPGLayout.AddButton( "ChangeLayoutDemo", "Change Layout" );
oPPGLayout.Language = "JScript";
oPPGLayout.Logic = ChangeLayoutDemo_OnClicked.toString();


// This function toggles between displaying the number slider and 
// check box on two lines vs. the same line
function ChangeLayoutDemo_OnClicked()
{
	var oCtrl = PPG.PPGLayout.Item( "NumberDemo" );
	if ( oCtrl.GetAttribute(siUIContinue) ) {
		oCtrl.SetAttribute( siUIContinue, false );
	} else {
		oCtrl.SetAttribute( siUIContinue, true );
	}
	PPG.Refresh();
}

これによって、[Change Layout]ボタンをクリックすると、次の 2 つの状態が切り替わるようになりました。