PPGItem

Object Hierarchy | 関連する C++クラス:PPGItem

導入

v4.0

詳細

このオブジェクトは、プロパティページのユーザインターフェイスのコンポーネントです。通常、PPGItem は、検証されるオブジェクトのParameterに直接関係するユーザインターフェイスコントロールです。たとえば、タイプが siControlStringである PPGItem は、Stringパラメータの値を表示します。同様に、タイプが siControlFCurve である PPGItem は、FCurve Parameter内に含まれる F カーブを表示します。コントロールと関連する Parameterとの接続は、PPGItem.Nameをベースにして確立されます。

Buttons、Tabs、Groups などのその他の PPGItem は、パラメータに直接対応するものではありません。

各 PPGItem は、その外観の調整に使用できる一連の「属性」を表示します。PPGItem.Labelなどの非常に一般的な属性には、オブジェクトのプロパティとして直接表示されるものもあります。また、専門的で、あまり一般的でない属性には、PPGItem.GetAttributeを介してアクセスします。

PPGItem オブジェクトには、ProjectItemPPGLayoutを介してアクセスします。

メソッド

GetAttributeオペレータ SetAttributeオペレータ    
       

プロパティ

Labelオペレータ LabelMinPixelsオペレータ LabelPercentageオペレータ Nameオペレータ
Typeオペレータ UIItemsオペレータ WidthPercentageオペレータ  
       

1. VBScript の例

'example demonstrating using the PPGItem 
'object to set the Labels of an object.
dim oPSet,oPPGLayout, oItem
set oPSet=ActiveSceneRoot.AddProperty("CustomProperty",false,"Demo")
oPSet.AddParameter3 "Check1", siBool
oPSet.AddParameter3 "Check2", siBool
set oPPGLayout = oPSet.PPGLayout
oPPGLayout.AddGroup "", true
oPPGLayout.AddRow
oPPGLayout.AddItem "Check1"
set oItem = oPPGLayout.AddItem( "Check2" )
oItem.Label = "Check Box 2"
oPPGLayout.EndRow
oPPGLayout.EndGroup
'We can look up and change the items afterwards
set oItem = oPPGLayout.Item( "Check1" )
oItem.Label = "Check Box 1"
'Show our PPG
InspectObj oPSet

2. JScript の例

//example building a layout with two Controls for selecting a 
//filepath and one for selecting a folder.
var oPSet=ActiveSceneRoot.AddProperty("CustomProperty",false,"Demo") ;
oPSet.AddParameter3( "ExportFile", siString ) ;
oPSet.AddParameter3( "ImportFile", siString ) ;
oPSet.AddParameter3( "FolderPicker", siString ) ;
var oPPGLayout = oPSet.PPGLayout ;
var oItem = oPPGLayout.AddItem( "ExportFile","Export Filename",siControlFilePath ) ;
// You can use the string directly, or the typdef siUIInitialDir (see siPPGItemAttribute enum)
oItem.SetAttribute( "initialdir", "project" ) ;
oItem.SetAttribute( siUIFileFilter, "Text files (*.txt)|*.txt|All Files (*.*)|*.*||" ) ;
var oItem = oPPGLayout.AddItem( "ImportFile","",siControlFilePath ) ;
oItem.SetAttribute( siUIFileFilter, 
                                "spdl files (*.spdl)|*.spdl|" +
                                "xsiaddon files (*.xsiaddon)|*.xsiaddon|" +
                                "All Files (*.*)|*.*||" );
oItem.SetAttribute( siUIOpenFile, true ) ;
oItem.SetAttribute( siUIInitialDir, "factory" ) ;
oItem.SetAttribute( siUISubFolder, "Application/spdl" ) ;
oItem.SetAttribute( siUIFileMustExist, true );
var oItem = oPPGLayout.AddItem( "FolderPicker", "", "Folder" );
oItem.SetAttribute( siUIInitialDir, "user" ) ;
InspectObj( oPSet );

関連項目

PPGLayout PPGLayout.AddItem PPGLayout.Item