GuiButtons は GuiObjects で、プレイヤーがアクションを実行できるようにします。これらのボタンは、プレイヤーがボタンと対話したときに視覚的な外観を変更したり、スクリプトによる音声フィードバックを提供したりすることで、コンテキストやフィードバックをカスタマイズできます。
画面上またはゲーム内に配置できるボタンには2種類あります。画面上またはゲーム内:
TextButton はテキストを持つ長方形で、クリック/タップ時に Activated および/または SecondaryActivated イベントをトリガーします。
ImageButton は画像を持つ長方形で、クリック/タップ時に Activated および/または SecondaryActivated イベントをトリガーします。プレイヤーがホバーまたは押したときに画像を切り替えるための追加の状態があります。
画面上のボタン
画面上のボタンは、プレイヤーをさまざまなメニューやページに迅速に誘導するのに役立ちます。このタイプのボタンを追加するには:
Explorer ウィンドウで StarterGui にカーソルを合わせ、⊕ ボタンをクリックして ScreenGui を挿入します。
新しい ScreenGui にカーソルを合わせ、⊕ ボタンをクリックして TextButton または ImageButton のいずれかを挿入します。
パートの面上のボタン
パート上のボタンは、プレイヤーがパートと対話できるようにするのに便利です。たとえば、プレイヤーがボタンの上に立つことでアクションを完了できるようにすることができます。
パートの面にボタンを追加するには:
Explorer ウィンドウで part にカーソルを合わせ、⊕ ボタンをクリックして SurfaceGui を挿入します。
新しい SurfaceGui にカーソルを合わせ、⊕ ボタンをクリックして TextButton または ImageButton のいずれかを挿入します。
ボタンの外観
TextButton と ImageButton は GuiObject から継承され、BackgroundColor3、Rotation、および Size などのプロパティを含みます。ボタンは、ほとんどのUIオブジェクトに共通する外観修飾子も受け入れます。
TextButton に特有のさまざまなプロパティがあり、視覚的な外観を変更できます:
- FontFace — テキストをレンダリングするために使用されるフォント。
- Text — ボタンにレンダリングされるテキスト文字列。
- TextSize — オフセットでのテキストの行の高さ。
- TextColor3 — レンダリングされたテキストの色。
ImageButton には、プレイヤーがボタンと対話していることを示すためのホバーおよび押下画像のバリアントを含む、視覚的な外観を変更するためのいくつかのプロパティがあります:
- Image — プレイヤーが ImageButton と対話していないときに表示される画像。
- HoverImage — プレイヤーが ImageButton の上にカーソルをホバーさせているときに表示される画像。
- PressedImage — プレイヤーが ImageButton をクリック/タップしたときに表示される画像。
スクリプトボタン
プレイヤーがボタンを押したときにアクションをスクリプト化するには、ボタンを GuiButton.Activated イベントに接続するか、デスクトップでの右クリックやモバイルでの長押しなどのクロスプラットフォームのセカンダリ入力のために GuiButton.SecondaryActivated に接続します。たとえば、次の LocalScript をボタンに親子関係を持たせると、プレイヤーがボタンをクリック/タップするたびにボタンの色がランダムに変わります。
local button = script.Parent
local RNG = Random.new()
local function onButtonActivated()
-- ボタンの色をランダム化
button.BackgroundColor3 = Color3.fromHSV(RNG:NextNumber(), 1, 1)
end
button.Activated:Connect(onButtonActivated)