GuiBase2d
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
GUIBase2d は、2D GUI オブジェクトに継承された抽象クラスです。
概要
プロパティ
UI 要素の実際の画面位置をピクセルで説明します。
UI 要素の実際のスクリーン回転を、度数で説明します。
UI 要素の実際の画面サイズをピクセル単位で説明します。
設定を「真」に設定すると、ローカライズはこの GuiBase2d とその子孫に適用されます。
この GuiBase2d とその後の子孫に自動的にローカライズを適用するために使用される LocalizationTable の参照。
下向きにゲームパッドの選択動作をカスタマイズします。
左側のゲームパッド選択動作をカスタマイズします。
右方向のゲームパッド選択動作をカスタマイズします。
ゲームパッドの選択動作を上向きにカスタマイズします。
ゲームパッドの選択動作をカスタマイズできます。
イベント
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
ゲームパッドの選択が移動すると、退出します。または、接続された GuiBase2d または任意の子 GuiObjects 内で変更されます。
プロパティ
AbsolutePosition
絶対ポジションは、UI 要素のピクセルの位置をピクセル単位で提供する読み取り専用プロパティです。これは、元のサイズと位置によって要素がレンダリングされる結果を表示するピクセルの位置を表します。<
たとえば、1920 x 1080の画面で、位置 0.5、0、0.5、0 の Frame は、相対位置 (960、540) を持つフレームを配置すると、その中の
コードサンプル
-- Place within a Frame, TextLabel, etc.
local guiObject = script.Parent
-- For this object to be rendered, it must be a descendant of a ScreenGui
local screenGui = guiObject:FindFirstAncestorOfClass("ScreenGui")
-- Create a copy
local copycat = Instance.new("Frame")
copycat.BackgroundTransparency = 0.5
copycat.BackgroundColor3 = Color3.new(0.5, 0.5, 1) -- Light blue
copycat.BorderColor3 = Color3.new(1, 1, 1) -- White
-- Orient the copy just as the original; do so "absolutely"
copycat.AnchorPoint = Vector2.new(0, 0)
copycat.Position = UDim2.new(0, guiObject.AbsolutePosition.X, 0, guiObject.AbsolutePosition.Y)
copycat.Size = UDim2.new(0, guiObject.AbsoluteSize.X, 0, guiObject.AbsoluteSize.Y)
copycat.Rotation = guiObject.AbsoluteRotation
-- Insert into ancestor ScreenGui
copycat.Parent = screenGui
AbsoluteRotation
絶対スクリーン回転は、UI 要素の実際のスクリーン回転を度数で表現します。このプロパティ、 GuiBase2d.AbsoluteSize および Class.
たとえば、フレームA が 40 度の回転を持っており、フレーム B がその中にある場合、フレーム B の絶対値の回転は GuiObject.Rotation で 50 度です。つまり、フレーム B の絶対値の回転は 90 度です。
コードサンプル
-- Place within a Frame, TextLabel, etc.
local guiObject = script.Parent
-- For this object to be rendered, it must be a descendant of a ScreenGui
local screenGui = guiObject:FindFirstAncestorOfClass("ScreenGui")
-- Create a copy
local copycat = Instance.new("Frame")
copycat.BackgroundTransparency = 0.5
copycat.BackgroundColor3 = Color3.new(0.5, 0.5, 1) -- Light blue
copycat.BorderColor3 = Color3.new(1, 1, 1) -- White
-- Orient the copy just as the original; do so "absolutely"
copycat.AnchorPoint = Vector2.new(0, 0)
copycat.Position = UDim2.new(0, guiObject.AbsolutePosition.X, 0, guiObject.AbsolutePosition.Y)
copycat.Size = UDim2.new(0, guiObject.AbsoluteSize.X, 0, guiObject.AbsoluteSize.Y)
copycat.Rotation = guiObject.AbsoluteRotation
-- Insert into ancestor ScreenGui
copycat.Parent = screenGui
AbsoluteSize
AbsoluteSize は、UI 要素のピクセルサイズを提供する読み取り専用プロパティです。これは、元のサイズによってレンダリングされる UI 要素の実際のピクセルサイズを表します。このプロパティ、 GuiBase2d.AbsolutePosition および GuiBase2d.AbsoluteRotation は、すべて
たとえば、1920 x 1080 の画面で、フレーム A が GuiObject.Size 内に存在
コードサンプル
-- Place within a Frame, TextLabel, etc.
local guiObject = script.Parent
-- For this object to be rendered, it must be a descendant of a ScreenGui
local screenGui = guiObject:FindFirstAncestorOfClass("ScreenGui")
-- Create a copy
local copycat = Instance.new("Frame")
copycat.BackgroundTransparency = 0.5
copycat.BackgroundColor3 = Color3.new(0.5, 0.5, 1) -- Light blue
copycat.BorderColor3 = Color3.new(1, 1, 1) -- White
-- Orient the copy just as the original; do so "absolutely"
copycat.AnchorPoint = Vector2.new(0, 0)
copycat.Position = UDim2.new(0, guiObject.AbsolutePosition.X, 0, guiObject.AbsolutePosition.Y)
copycat.Size = UDim2.new(0, guiObject.AbsoluteSize.X, 0, guiObject.AbsoluteSize.Y)
copycat.Rotation = guiObject.AbsoluteRotation
-- Insert into ancestor ScreenGui
copycat.Parent = screenGui
AutoLocalize
「GuiBase2d」とその子孫にローカライズが適用されます。LocalizationService:GetTableEntries() によって使用されるエントリは、GuiBase2d.AutoLocalize のエントリと同じセットのエントリです。2>Class.LocalizationService:GetTableCommands2> によって有効に
また、GuiBase2d.RootLocalizationTable を参照してください。
RootLocalizationTable
この GuiBase2d とその後の子孫に自動的にローカライズを適用するために使用される LocalizationTable の参照。
このオブジェクトとその親に GuiBase2d.AutoLocalize のプロパティが設定されている必要があります。これは、RootLocalizationTable を参
参照されたテーブルに翻訳がない場合は、そのテーブルの親に翻訳を検索し、それがローカライズテーブルである場合など、その親の下にある翻訳を検索します。
また、 LocalizationService:GetTableEntries() を参照して、 GuiBase2d.RootLocalizationTable が自動的にローカライズされる方法を説明しています。
SelectionGroup
Toggles SelectionGroup on for a GUI allows customization of how gamepad selection can move between buttons, which are descendants of the SelectionGroup, leaves the group, and selects other buttons. 設定 SelectionGroup to true exposes the SelectionBehaviorUp/Down/Left/ Right
方法
イベント
SelectionChanged
このイベントは、接続された GuiBase2d の下の任意の選択変更に対応するときに発生します。選択ハイライトが GuiObject に移動すると、その GuiObject からすべての親に通知されます。このイベントは、選択が変更された/入力された/終了された GuiBase2d のすべての親に通知されます。
パラメータ
コードサンプル
local backgroundWindow = script.Parent.BackgroundWindow
local function selectionChanged(isSelfSelected, previousSelection, newSelection)
if newSelection and newSelection:IsDescendantOf(backgroundWindow) then
backgroundWindow.BackgroundColor3 = Color3.new(0, 1, 0)
else
backgroundWindow.BackgroundColor3 = Color3.new(1, 0, 0)
end
end
backgroundWindow.SelectionChanged:Connect(selectionChanged)