PluginToolbarButton

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

作成できません

プラグインツールボックスボタンは、 PluginToolbar:CreateButton() 関数によって作成されるオブジェクトです。ユーザーは、Roblox Studio の Click イベントを通じて、単一のアクションを Roblox Studio で初期化できます。

押すと、Click イベントが発動します。プラグインを有効にするために (Class.PluginToolbar:SetActive()|SetActive) をマニュアルに設定するボタンが

ゲームビューポートが見えない場合、ボタンは Enabled プロパティが偽であるかのように無効になります。無効なボタンはデサティアルされ、ユーザークリックに応答しません。 ClickableWhenViewportHidden を true

概要

プロパティ

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

    スクリプトを別のスタジオタブで編集しているときなど、ゲームビューポートが隠されている場合、ボタンをクリックできるかどうかを決定します。

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

    ボタンが一全般的にクリック可能かどうかを決定します。

  • Icon:ContentId
    複製されていません
    並列読み取り

    ボタンを表示するアイコンを決定します。

方法

  • SetActive(active : bool):void
    プラグインのセキュリティ

    プラグインボタンの状態を設定します。

イベント

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

    ユーザーがボタンのカーソルを押してリリースすると、ファイアが発生します。

プロパティ

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.

BrickColor Randomizer Plugin

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

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

アイコン は、プラグインツールバーのボタンに表示する icon を決定します。このプロパティが設設定するされていないと、ボタンは PluginToolbar:CreateButton() によってボタンのテキストが提供されます。

方法

SetActive

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

このメソッドは、プラグインボタンのアクティブステートを手動で設定するために使用できます。

Class.PluginToolbarButton.Enabled|Enabled プロパティが Enabled されたとき、ボタンはこのメソッドによって設定された最後の状態に戻ります。このメソッドは以前に使用されていない場合、またはこのメソッドを使用していない場合、またはこのメソッドを使用していない場合、またはこのメソッドを使用していない場合、またはこのメソッドを使用してい

パラメータ

active: bool

戻り値

void

イベント

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.

PluginToolbarButton.Click

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)