Selection
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
選択サービスは、Roblox Studio で選択された Instances を制御します。
このサービスは、Plugins を開発するときに特に便利です。これにより、開発者は現在の選択にアクセスし、操作できます。
現在選択されている Instances は、Selection:Get() および Selection:Set() 機能を使用して入手および設定できます。1> Class.Selection.SelectionChanged1> イベントは、現在の選択が変更されるたびに発動します。
For more information on using Selection and Plugins, see Plugin .
選択は、コマンドバーでもよく使用され、Instances の選択したプロパティを設定したり、実行機能を実行したりします。
このクラスは Roblox Studio にのみ適用され、ゲームには適用されません。
コードサンプル
local Selection = game:GetService("Selection")
for _, object in pairs(Selection:Get()) do
if object:IsA("BasePart") then
object.CFrame = object.CFrame * CFrame.Angles(0, math.pi / 2, 0)
end
end
プロパティ
SelectionThickness
方法
Add
パラメータ
戻り値
Get
Roblox Studio の Instances のアレイを返します。
Class.Instance|Instances が選択されていない場合、返される配列は空です。この関数は Selection.SelectionChanged イベントと組み合わせて使用して、選択が変更されるたびに取得できます。
注: この関数は Plugins またはコマンドラインでのみ使用できます。
現在の選択を変更するには、Selection:Set() を参照してください。
戻り値
現在選択されている Instances のアレイ。
コードサンプル
local Selection = game:GetService("Selection")
for _, object in pairs(Selection:Get()) do
if object:IsA("BasePart") then
object.CFrame = object.CFrame * CFrame.Angles(0, math.pi / 2, 0)
end
end
local selection = game:GetService("Selection")
selection.SelectionChanged:Connect(function()
print("Selection contains " .. #selection:Get() .. " items.")
end)
Remove
パラメータ
戻り値
Set
Roblox Studio の現在選択されているオブジェクトを Instances に渡します。
この関数を呼び出すと、新しい選択セットが前の選択セットと同じでない限り、 Selection.SelectionChanged イベントが発動します。
この関数は既存の選択を上書きしますが、Selection:Get() を使用して、Instance を既存の選択に追加することができます:
local selected = Selection:Get()table.insert(selected, object)Selection:Set(selected)
パラメータ
現在の選択を設定する Instances 配列。
戻り値
コードサンプル
local Selection = game:GetService("Selection")
local newSelection = {}
for _, object in pairs(workspace:GetDescendants()) do
if object:IsA("BasePart") and object.BrickColor == BrickColor.new("Bright red") then
table.insert(newSelection, object)
end
end
Selection:Set(newSelection)
イベント
SelectionChanged
Roblox Studio で選択した Instances が変更されるときに発動します。
このイベントは、新しい選択を与えません。開発者は、Selection:Get() 機能を使用して、現在の選択を取得する必要があります。
このイベントは、プラグインとコマンドバーの外で使用できますが、Roblox Studio の選択にのみ適用され、Studio の外で機能しません。
選択を変更するには、Selection:Set() 関数を使用します。
コードサンプル
local selection = game:GetService("Selection")
selection.SelectionChanged:Connect(function()
print("Selection contains " .. #selection:Get() .. " items.")
end)