移動先: 概要 戻り値 MEL 例.

概要

renameSelectionList(string $newName)

セレクション リストのすべての書き込み可能オブジェクトの名前を変更する際に、引数として渡された文字列がベース名として使われます。複数の選択したオブジェクトに対して、引数の名前に増分値がアペンドされます。

この方法は、セレクション リストの項目の中に子の名前が同じものがあると、うまく機能しないことに注意してください。たとえば、 group1|child と group2|child は、子の名前が同じです。 セレクション リストのこれらの項目にこの方法を使おうとすると、複数のオブジェクトで子の名前が一致していることを示すエラー メッセージが表示されます。

戻り値

なし

引数
変数名 変数型 説明
$newNamestringセレクション リスト内のオブジェクトの名前です。 空の文字列にしないでください。有効な名前は文字やアンダースコアで始まり、文字、数字またはアンダースコアが続きます。

MEL 例

	//	Create a few objects. Select one and rename it.
	//
	$cone1 = `cone`;
	$cone2 = `cone`;
	$cone3 = `cone`;
	select $cone1;
	renameSelectionList("Cone");

	//	Add the other objects to the selection list and rename
	//	them all.
	//
	select -add $cone2;
	select -add $cone3;
	renameSelectionList("Object");