PluginToolbarButton
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
プラグインツールボックスボタンは、 PluginToolbar:CreateButton() 関数によって作成されるオブジェクトです。ユーザーは、Roblox Studio の Click イベントを通じて、単一のアクションを Roblox Studio で初期化できます。
押すと、Click イベントが発動します。プラグインを有効にするために (Class.PluginToolbar:SetActive()|SetActive) をマニュアルに設定するボタンが
ゲームビューポートが見えない場合、ボタンは Enabled プロパティが偽であるかのように無効になります。無効なボタンはデサティアルされ、ユーザークリックに応答しません。 ClickableWhenViewportHidden を true
概要
プロパティ
スクリプトを別のスタジオタブで編集しているときなど、ゲームビューポートが隠されている場合、ボタンをクリックできるかどうかを決定します。
ボタンが一全般的にクリック可能かどうかを決定します。
ボタンを表示するアイコンを決定します。
イベント
ユーザーがボタンのカーソルを押してリリースすると、ファイアが発生します。
プロパティ
ClickableWhenViewportHidden
ClickableWhenViewportHidden は、ゲームビューポートが隠されているときにプラグインツールボックスボタンをクリックできるかどうかを決定します。たとえば、Script が他のタブで編集されている場合などです。
通常、このプロパティは、プラグインボタンの Click イベントがゲームワールド (Workspace) で発生しない場合に有効にすることが好ましい。たとえ、ウィジェットを開くボタンが見えても、ゲームビューが見えないユーザーには、このプロパティが true になっている必要があります。
Enabled
有効化済み は、ボタンが一全般的にクリック可能かどうかを判断します。このプロパティが偽択されていると、ボタンはグレー表示され、クリックできなくなります。ボタンはデフォルトで有効になっています。
このプロパティを再有効化すると、ユーザーがボタンを押した状態の前の状態では、プラグインボタンの状態は記憶されません。代わりに、 SetActive() または、SetActive() が使用されていない状態でデフォルトに�
プラグインは、ボタンアクションが現在のコンテキストで不関係な場合、ボタンを無効にする必要があります。たとえば、ランダムな色を割り当てるプラグインボタンは、選択にパーツが含まれていない場合、無効にする必要があります。コードサンプルを参照してください。
参照してください:
- ClickableWhenViewportHidden 、これは、ゲームビューが隠されているときにボタンをクリックできるかどうかを決定します (および一全般的には)
コードサンプル
This code sample is for a studio Plugin. The plugin creates a PluginToolbarButton which randomizes the BrickColor() of each selected part using BrickColor.random(). Furthermore, the button is only enabled if at least one part is selected. It does this by detecting changes in the Selection using Selection.SelectionChanged.
assert(plugin, "This script must be run as a plugin")
local Selection = game:GetService("Selection")
local toolbar = plugin:CreateToolbar("Parts")
local pluginToolbarButton = toolbar:CreateButton(
"Randomize Colors",
"Click this button to assign random colors to selected parts",
"rbxassetid://5325741572" -- A rainbow
)
local function onClick()
local selection = Selection:Get()
for _, object in pairs(selection) do
if object:IsA("BasePart") then
object.BrickColor = BrickColor.random()
end
end
end
pluginToolbarButton.Click:Connect(onClick)
local function doesSelectionContainAPart()
local selection = Selection:Get()
for _, object in pairs(selection) do
if object:IsA("BasePart") then
return true
end
end
return false
end
local function onSelectionChanged()
pluginToolbarButton.Enabled = doesSelectionContainAPart()
end
Selection.SelectionChanged:Connect(onSelectionChanged)
onSelectionChanged()
Icon
アイコン は、プラグインツールバーのボタンに表示する icon を決定します。このプロパティが設設定するされていないと、ボタンは PluginToolbar:CreateButton() によってボタンのテキストが提供されます。
方法
イベント
Click
クリック は、ユーザーがプラグインツールボックスボタンを押してリリースしたときに発動します。
プラグインツールボックスをクリックすると、ボタンの状態が切り替わります。 SetActive を呼び出して、ボタンの状態を手動で設定します。
コードサンプル
This code sample demonstrates creating a PluginToolbar and a PluginToolbarButton on it, then connecting a function onClick to the PluginToolbarButton.Click event. When pressed, the button will print "Hello, world" to the output.
assert(plugin, "This script must be run as a plugin")
local toolbar = plugin:CreateToolbar("Hello World Plugin Toolbar")
local pluginToolbarButton = toolbar:CreateButton(
"Print Hello World",
"Click this button to print Hello World!",
"rbxassetid://133293265"
)
local function onClick()
print("Hello, world")
end
pluginToolbarButton.Click:Connect(onClick)