Typy widżetów

Widżety są elementami UI, które można dodawać lub usuwać w UI.

W kolejnych sekcjach opisano wszystkie widżety, których możesz użyć do stworzenia własnego niestandardowego UI w Verse.

Kanwy

Kanwa jest widżetem kontenera. Inne widżety można pozycjonować w obrębie kanwy przy użyciu slotów kanwy, aby zaprojektować własny UI. Gdy widżet kanwy znajduje się na szczycie hierarchii UI, reprezentuje cały ekran.

Widżet kanwy można zagnieżdżać w innym widżecie kanwy, ale tylko główny widżet kanwy będzie obejmował cały ekran.

Przykładowe sposoby tworzenia widżetów kanwy i pozycjonowania widżetów na ekranie znajdziesz w sekcji Pozycjonowanie widżetów na ekranie.

Przycisk

Do UI możesz dodać trzy rodzaje widżetów przycisków. Różnica między poszczególnymi przyciskami jest jedynie kosmetyczna.

Informacje na temat tworzenia interakcji przycisków zawiera sekcja Tworzenie widżetów interaktywnych.

Kolorowy blok

Możesz utworzyć widżet, w którym zdefiniujesz kolor i przezroczystość przy użyciu widżetu color_block.

Widget := color_block:
    DefaultColor := NamedColors.CornflowerBlue
    DefaultOpacity := 1.0
    DefaultDesiredSize := vector2{X := 128.0, Y := 128.0}
Copy full snippet

Widget := color_block: DefaultColor := NamedColors.CornflowerBlue DefaultOpacity := 1.0 DefaultDesiredSize := vector2{X := 128.0, Y := 128.0}

Obraz

Obrazy możesz dodawać do UI za pomocą tekstury przypisanej do widżetu texture_block.

Widget := texture_block:
    DefaultImage := MyTexture
    DefaultDesiredSize := vector2{X := 128.0, Y := 128.0}
Copy full snippet

Widget := texture_block: DefaultImage := MyTexture DefaultDesiredSize := vector2{X := 128.0, Y := 128.0}

Informacje na temat uwidaczniania tekstur w UEFN w kodzie Verse zawiera sekcja Uwidacznianie zasobów w UEFN dla Verse.

Suwak

Możesz dodać suwaki, aby gracz mógł ustawiać wartości we wstępnie zdefiniowanym zakresie. Właściwość wielkości kroku określa, o ile wartość zostanie zmieniona w przypadku użycia kontrolera lub klawiatury, jednak nie wpływa na wielkość kroku, jeśli gracz użyje myszy do zmiany wartości.

Widget := slider_regular:
    DefaultValue := 5.0
    DefaultMinValue := 0.0
    DefaultMaxValue := 10.0
    DefaultStepSize := 0.5
Copy full snippet

Widget := slider_regular: DefaultValue := 5.0 DefaultMinValue := 0.0 DefaultMaxValue := 10.0 DefaultStepSize := 0.5

Informacje na temat tworzenia interakcji suwaków zawiera sekcja Tworzenie widżetów interaktywnych.

Tekst

Aby wyświetlić tekst w UI, użyj bloku tekstu.

TextForUI<localizes> : message = "To jest mój tekst!"
Widget := text_block{DefaultText := TextForUI}
Copy full snippet

TextForUI<localizes> : message = "To jest mój tekst!" Widget := text_block{DefaultText := TextForUI}

Nakładka

Widżety można układać w stos jeden na drugim za pomocą widżetu nakładki. Widżety są renderowane w kolejności, w jakiej zdefiniowane zostaną sloty nakładki

W poniższym przykładzie jako pierwszy renderowany jest kolorowy blok, a następnie na nim renderowany jest blok tekstowy. Jeśli zamienisz kolejność slotów nakładki (tak, że blok tekstowy będzie pierwszy), wówczas kolorowy blok będzie renderowany nad blokiem tekstowym, co spowoduje ukrycie tekstu.

TextForUI<localizes>(InText : string) : message = "{InText}"

Widget := overlay:
    Slots := array:
        overlay_slot:
            Widget := color_block:
                DefaultColor := NamedColors.MintCream
                DefaultOpacity := 1.0
                DefaultDesiredSize := vector2{X := 1024.0, Y := 128.0}                                
        overlay_slot:
            Widget := text_block:
                DefaultText := TextForUI("To jest mój blok tekstowy nałożony na kolorowy blok.")
Copy full snippet

TextForUI<localizes>(InText : string) : message = "{InText}" Widget := overlay: Slots := array: overlay_slot: Widget := color_block: DefaultColor := NamedColors.MintCream DefaultOpacity := 1.0 DefaultDesiredSize := vector2{X := 1024.0, Y := 128.0} overlay_slot: Widget := text_block: DefaultText := TextForUI("To jest mój blok tekstowy nałożony na kolorowy blok.")

Pole stosu

Widżety można układać w stosy pionowo lub poziomo za pomocą widżetu układania pól w stosy.