GuiButton

非推奨を表示

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

作成できません
閲覧できません

GuiButton は、GuiObject から継承する抽象クラスです。それは、インタラクティブでクリック可能な ImageButton および TextButton オブジェクトのベースクラスです。このクラスは、対話型動作のための複数のプロパティも定義します、具体的には AutoButtonColorModal です。

の最も重要なイベントは、ボタンが有効になったときに発動する 、マルチプラットフォームイベントです。マウスを使用すると、これはボタンをクリックして、カーソルがまだUIオブジェクトの上にある状態でリリース押することを意味します。タッチの場合は、同じことが適用されますが、ボタンの押し代わりにタッチが使用されます。最後に、ゲームパッドの場合、Activated は、GuiButton ボタンが押されてリリースされたときに、 **** が選択されると、発射します。要するに、このイベントは、単一のユーザー入力のための良い一般インターフェイスを提供するため、マルチプラットフォームユーザーインターフェイスプログラミングにとても役立ちます。

概要

プロパティ

  • 並列読み取り

    ボタンがマウスがホバーしたりクリックしたりすると自動的に色が変更されるかどうかを決定します。

  • A HapticEffect インスタンスは、GuiButton がホバリングされているときに再生する。

  • 並列読み取り

    GUI 要素が表示されている間、true であれば、右マウスボタンが下になっていない限り、マウスはロックされません。

  • A HapticEffect インスタンスは、GuiButton が押されたときに再生する。

  • 並列読み取り

    オブジェクトが選択されたかどうかを示すブールプロパティ。

  • 並列読み取り

    GuiButton のスタイルを、事前決定されたスタイルのリストに基づいて設定します。

GuiObject から継承した プロパティGuiBase2d から継承した プロパティ

方法

GuiObject から継承した 方法

イベント

GuiObject から継承した イベントGuiBase2d から継承した イベント

プロパティ

AutoButtonColor

並列読み取り

このプロパティは、ユーザーの Mouse がホバーしたりクリックしたりすると、ボタンの色が自動的に変更されるかどうかを決定します。If true 、マウスがホバーしたりクリックしたりすると、ボタンの色が自動的に変更されます。If false であれば、ボタンは変更されません。

ユーザーのマウスがホバーしたりクリックしたときにボタンがどのように変更されるかをカスタマイズしたい場合は、ImageButton を使用して要素の HoverImagePressedImage を変更することを検討してください。

このプロパティは、 プロパティが画像に設定されている場合、効果を持たないことに注意してください。さらに、このプロパティは、その HoverImagenil ではないとき、またはその PressedImagenil ではないとき、マウスホバーで ImageButton に影響しません。

HoverHapticEffect

並列読み取り

A HapticEffect インスタンスは、GuiButton がホバリングされているときに再生する。

並列読み取り

GUI 要素が表示されている間、true であれば、右マウスボタンが下になっていない限り、マウスはロックされません。

PressHapticEffect

並列読み取り

A HapticEffect インスタンスは、GuiButton が押されたときに再生する。

Selected

並列読み取り

オブジェクトが選択されたかどうかを示すブールプロパティ。

並列読み取り

GuiButton のスタイルを、事前決定されたスタイルのリストに基づいて設定します。

方法

イベント

Activated

ボタンが有効になったときに発火します。このイベントはサーバーで発動しないので、LocalScript または ScriptRunContextEnum.RunContext.Client を使用するだけでよいでしょう。

パラメータ

inputObject: InputObject
clickCount: number

MouseButton1Click

このイベントは、ユーザーのマウスが完全に左クリックして GuiButton をクリックすると発動します。

クリックに関しては、マウスが GuiButton の境界内にある必要があり、マウスボタンがこのイベントが発動する前に再度下押しおよび上押しされる必要があります。マウスが GuiButton の境界を離れてリリースされると、イベントが発動しない。この制限を避けたい場合は、MouseButton1DownMouseButton1Up を使用できます;これらのイベントは似ていますが、ユーザーが左マウスボタンを下または上に押すときに発動します。


MouseButton1Down

このイベントは、ユーザーが GuiButton の左マウスボタンを押したときに発動します。

ユーザーが を押して左マウスをリリースする必要があるイベントで、イベントが発火するには、GuiButtonMouseButton1Click を使用することを検討してください。

パラメータ

マウスの X ピクセル単位の画面座標

マウスの Y ピクセルスクリーン座標。


MouseButton1Up

このイベントは、ユーザーが GuiButton から左マウスボタンを解放すると発動します。

ユーザーが を押して左マウスをリリースする必要があるイベントで、イベントが発火するには、GuiButtonMouseButton1Click を使用することを検討してください。

パラメータ

マウスの X ピクセル単位の画面座標

マウスの Y ピクセルスクリーン座標。


MouseButton2Click

このイベントは、ユーザーのマウスが完全に右クリックして GuiButton をクリックすると発動します。

クリックに関しては、マウスが GuiButton の境界内にある必要があり、マウスボタンがこのイベントが発動する前に再度下押しおよび上押しされる必要があります。マウスが GuiButton の境界を離れてリリースされると、イベントが発動しない。この制限を避けたい場合は、MouseButton2DownMouseButton2Up を使用できます;これらのイベントは似ていますが、ユーザーがそれぞれ右または上のマウスボタンを押すときに発動します。


MouseButton2Down

このイベントは、ユーザーが GuiButton の右マウスボタンを押したときに発動します。

ユーザーが を押して、イベントの発射のために右マウスを GuiButton にリリースする必要があるイベントの場合、MouseButton2Click を使用することを検討してください。

パラメータ

マウスの X ピクセル単位の画面座標

マウスの Y ピクセルスクリーン座標。


MouseButton2Up

このイベントは、ユーザーが GuiButton から右マウスボタンをリリースすると発動します。

ユーザーが を押して、イベントの発射のために右マウスを GuiButton にリリースする必要があるイベントの場合、MouseButton2Click を使用することを検討してください。

パラメータ

マウスの X ピクセル単位の画面座標

マウスの Y ピクセルスクリーン座標。