GuiButton
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
GuiButton は、GuiObject から継承する抽象クラスです。それは、インタラクティブでクリック可能な ImageButton および TextButton オブジェクトのベースクラスです。このクラスは、対話型動作のための複数のプロパティも定義します、具体的には AutoButtonColor と Modal です。
の最も重要なイベントは、ボタンが有効になったときに発動する 、マルチプラットフォームイベントです。マウスを使用すると、これはボタンをクリックして、カーソルがまだUIオブジェクトの上にある状態でリリース押することを意味します。タッチの場合は、同じことが適用されますが、ボタンの押し代わりにタッチが使用されます。最後に、ゲームパッドの場合、Activated は、GuiButton ボタンが押されてリリースされたときに、 **** が選択されると、発射します。要するに、このイベントは、単一のユーザー入力のための良い一般インターフェイスを提供するため、マルチプラットフォームユーザーインターフェイスプログラミングにとても役立ちます。
概要
プロパティ
ボタンがマウスがホバーしたりクリックしたりすると自動的に色が変更されるかどうかを決定します。
A HapticEffect インスタンスは、GuiButton がホバリングされているときに再生する。
GUI 要素が表示されている間、true であれば、右マウスボタンが下になっていない限り、マウスはロックされません。
A HapticEffect インスタンスは、GuiButton が押されたときに再生する。
オブジェクトが選択されたかどうかを示すブールプロパティ。
GuiButton のスタイルを、事前決定されたスタイルのリストに基づいて設定します。
このUI 要素が入力を受け取るかどうかを決定します。
絶対サイズに対して、GuiObject の起源ポイントを決定します。
子コンテンツに基づいてサイズ変更が発生するかどうかを決定します。
背景色を GuiObject 決定します。
GuiObject 背景とボーダーの透明度を決定します。
GuiObject ボーダーの色を決定します。
GuiObject ボーダーがどのように配置されるかを決定し、そのサイズに対して。
GuiObject ボーダーのピクセル幅を決定します。
親の GUI 要素の境界内で描画するかどうか、子孫 GuiObjects が決定します。
プレイヤーのマウスが GuiObject にアクティブに押されているかどうかを決定します。
GuiButton が相互作用できるかどうか、または GuiState の GuiObject が変更されているかどうかを決定します。
GuiObject を使用すると、ソート順序が制御されます。UIGridStyleLayout と一緒に使用すると、ソート順序が制御されます。
ゲームパッドセレクターが下向きに移動されると、選択される GuiObject を設定します。
ゲームパッドセレクターが左に移動されると選択される GuiObject を設定します。
ゲームパッドセレクターが右に移動されると選択される GuiObject を設定します。
ゲームパッドセレクターが上に移動したときに選択される GuiObject を設定します。
GuiObject のピクセルとスカラー位置を決定します。
GuiObject が回転する度数の数を決定します。
ゲームパッドで GuiObject が選択できるかどうかを決定します。
ゲームパッド用のデフォルトの選択装飾をオーバーライドします。
ゲームパッド UI の選択によって選択された GuiObjects の順序。
GuiObject のピクセルとスカラーサイズを決定します。
BackgroundTransparency と TextTransparency の混合プロパティ。
GuiObject とその子孫がレンダリングされるかどうかを決定します。
GuiObject が他のものに対してレンダリングされる順序を決定します。
ピクセルで、GuiBase2d 要素の実際の画面位置を説明します。
GuiBase2d 要素の実際のスクリーン回転を度数で説明します。
ピクセルで、GuiBase2d 要素の実際の画面サイズを説明します。
true に設定すると、ローカライゼーションがこの GuiBase2d とその子孫に適用されます。
この LocalizationTable とその子孫に自動翻訳を適用するために使用する GuiBase2d の参照。
下方向のゲームパッド選択動作をカスタマイズします。
左方向でゲームパッドの選択動作をカスタマイズします。
右向きにゲームパッドの選択動作をカスタマイズします。
上向きのゲームパッド選択動作をカスタマイズします。
ゲームパッドの選択動作をカスタマイズできます。
方法
GuiObject から継承した 方法- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
スムーズにGUIを新しい UDim2 に移動します。
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
GUIを新しいサイズと位置にスムーズに移動します。
イベント
ボタンが有効になったときに発火します。
ユーザーのマウスが完全に GuiButton をクリックしたときに発火します。
ユーザーが GuiButton に左マウスボタンを押し下げると、発火します。
ユーザーが左マウスボタンを GuiButton から離したときに発火します。
ユーザーのマウスが完全に右クリックして GuiButton をクリックすると、発火します。
ユーザーが GuiButton に右マウスボタンを押し下げると、発火します。
ユーザーが GuiButton から右マウスボタンをリリースすると、発火します。
ユーザーが人間-コンピューターインターフェイス装置 (マウスボタンダウン、タッチ開始、キーボードボタンダウンなど) を介して交流を開始するときに発射されます。
ユーザーが人間-コンピューターインターフェイスデバイス (マウスボタンダウン、タッチ開始、キーボードボタンダウンなど) を介して対話する方法を変更したときに発射されます。
ユーザーが人間-コンピューターインターフェイス装置 (マウスボタンダウン、タッチ開始、キーボードボタンダウンなど) を介して交流を停止すると発射されます。
ユーザーがマウスをGUI 要素に移動させると発火します。
ユーザーがGUI 要素からマウスを移動すると発火します。
GUI 要素内にいる間、ユーザーがマウスを移動するたびに発火します。
ユーザーがマウスホイールを戻すときに、マウスがGUI 要素の上にあるときに発火します。
ユーザーがマウスホイールを前方にスクロールすると、マウスがGUI 要素の上にあるときに発火します。
ゲームパッドセレクターで GuiObject が焦点合致されているときに発火します。
ゲームパッドセレクターが GuiObject に焦点を合わせるのをやめたときに発火します。
プレイヤーが開始し、続行し、UI 要素を長押しし続けると、発火します。
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
プレイヤーがUI 要素に指を動かすと発火します。
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
UI 要素の 2 本の指を使用してピンチや引っ張りジェスチャーを実行すると、発火します。
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
UI 要素の 2 本の指を使用して回転ジェスチャーを実行すると、プレイヤーが炎上します。
プレイヤーがUI 要素にスワイプジェスチャーを実行すると発火します。
プレイヤーがUI 要素にタップジェスチャーを実行すると発火します。
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
ゲームパッドの選択が移動し、離れ、または接続された またはその子孫の中で変更されると、炎が発生します。
プロパティ
AutoButtonColor
このプロパティは、ユーザーの Mouse がホバーしたりクリックしたりすると、ボタンの色が自動的に変更されるかどうかを決定します。If true 、マウスがホバーしたりクリックしたりすると、ボタンの色が自動的に変更されます。If false であれば、ボタンは変更されません。
ユーザーのマウスがホバーしたりクリックしたときにボタンがどのように変更されるかをカスタマイズしたい場合は、ImageButton を使用して要素の HoverImage と PressedImage を変更することを検討してください。
このプロパティは、 プロパティが画像に設定されている場合、効果を持たないことに注意してください。さらに、このプロパティは、その HoverImage が nil ではないとき、またはその PressedImage が nil ではないとき、マウスホバーで ImageButton に影響しません。
方法
イベント
Activated
ボタンが有効になったときに発火します。このイベントはサーバーで発動しないので、LocalScript または Script で RunContext の Enum.RunContext.Client を使用するだけでよいでしょう。
パラメータ
MouseButton1Click
このイベントは、ユーザーのマウスが完全に左クリックして GuiButton をクリックすると発動します。
クリックに関しては、マウスが GuiButton の境界内にある必要があり、マウスボタンがこのイベントが発動する前に再度下押しおよび上押しされる必要があります。マウスが GuiButton の境界を離れてリリースされると、イベントが発動しない。この制限を避けたい場合は、MouseButton1Down と MouseButton1Up を使用できます;これらのイベントは似ていますが、ユーザーが左マウスボタンを下または上に押すときに発動します。
MouseButton1Down
このイベントは、ユーザーが GuiButton の左マウスボタンを押したときに発動します。
ユーザーが と を押して左マウスをリリースする必要があるイベントで、イベントが発火するには、GuiButton で MouseButton1Click を使用することを検討してください。
パラメータ
MouseButton1Up
このイベントは、ユーザーが GuiButton から左マウスボタンを解放すると発動します。
ユーザーが と を押して左マウスをリリースする必要があるイベントで、イベントが発火するには、GuiButton で MouseButton1Click を使用することを検討してください。
パラメータ
MouseButton2Click
このイベントは、ユーザーのマウスが完全に右クリックして GuiButton をクリックすると発動します。
クリックに関しては、マウスが GuiButton の境界内にある必要があり、マウスボタンがこのイベントが発動する前に再度下押しおよび上押しされる必要があります。マウスが GuiButton の境界を離れてリリースされると、イベントが発動しない。この制限を避けたい場合は、MouseButton2Down と MouseButton2Up を使用できます;これらのイベントは似ていますが、ユーザーがそれぞれ右または上のマウスボタンを押すときに発動します。
MouseButton2Down
このイベントは、ユーザーが GuiButton の右マウスボタンを押したときに発動します。
ユーザーが と を押して、イベントの発射のために右マウスを GuiButton にリリースする必要があるイベントの場合、MouseButton2Click を使用することを検討してください。
パラメータ
MouseButton2Up
このイベントは、ユーザーが GuiButton から右マウスボタンをリリースすると発動します。
ユーザーが と を押して、イベントの発射のために右マウスを GuiButton にリリースする必要があるイベントの場合、MouseButton2Click を使用することを検討してください。