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 にのみ適用され、ゲームには適用されません。

コードサンプル

Selection

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

概要

方法

  • Add(instancesToAdd : Instances):void
    プラグインのセキュリティ
  • Get():Instances
    プラグインのセキュリティ

    Roblox Studio の Instances のアレイを返します。

  • Remove(instancesToRemove : Instances):void
    プラグインのセキュリティ
  • Set(selection : Instances):void
    プラグインのセキュリティ

    Roblox Studio の現在選択されているオブジェクトを Instances に渡します。

プロパティ

SelectionThickness

読み取り専用
複製されていません
並列読み取り

方法

Add

void
プラグインのセキュリティ

パラメータ

instancesToAdd: Instances

戻り値

void

Get

Instances
プラグインのセキュリティ

Roblox Studio の Instances のアレイを返します。

Class.Instance|Instances が選択されていない場合、返される配列は空です。この関数は Selection.SelectionChanged イベントと組み合わせて使用して、選択が変更されるたびに取得できます。

注: この関数は Plugins またはコマンドラインでのみ使用できます。

現在の選択を変更するには、Selection:Set() を参照してください。


戻り値

Instances

現在選択されている Instances のアレイ。

コードサンプル

Selection

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
Selection.SelectionChanged

local selection = game:GetService("Selection")
selection.SelectionChanged:Connect(function()
print("Selection contains " .. #selection:Get() .. " items.")
end)

Remove

void
プラグインのセキュリティ

パラメータ

instancesToRemove: Instances

戻り値

void

Set

void
プラグインのセキュリティ

Roblox Studio の現在選択されているオブジェクトを Instances に渡します。

この関数を呼び出すと、新しい選択セットが前の選択セットと同じでない限り、 Selection.SelectionChanged イベントが発動します。

この関数は既存の選択を上書きしますが、Selection:Get() を使用して、Instance を既存の選択に追加することができます:


local selected = Selection:Get()
table.insert(selected, object)
Selection:Set(selected)

パラメータ

selection: Instances

現在の選択を設定する Instances 配列。


戻り値

void

コードサンプル

Selection Set

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() 関数を使用します。


コードサンプル

Selection.SelectionChanged

local selection = game:GetService("Selection")
selection.SelectionChanged:Connect(function()
print("Selection contains " .. #selection:Get() .. " items.")
end)