TabContainer
Hereda: Container < Control < CanvasItem < Node < Object
Un contenedor que crea una pestaña para cada control hijo, mostrando solo el control de la pestaña activa.
Descripción
Organiza los controles hijos en una vista de pestañas, creando una pestaña para cada uno. El control correspondiente a la pestaña activa se hace visible, mientras que todos los demás controles hijos se ocultan. Ignora los hijos que no son controles.
Nota: El dibujo de las pestañas clickables es manejado por este nodo; no se necesita TabBar.
Tutoriales
Propiedades
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Métodos
get_current_tab_control() const |
|
get_popup() const |
|
get_previous_tab() const |
|
get_tab_bar() const |
|
get_tab_button_icon(tab_idx: int) const |
|
get_tab_control(tab_idx: int) const |
|
get_tab_count() const |
|
get_tab_icon(tab_idx: int) const |
|
get_tab_icon_max_width(tab_idx: int) const |
|
get_tab_idx_at_point(point: Vector2) const |
|
get_tab_idx_from_control(control: Control) const |
|
get_tab_metadata(tab_idx: int) const |
|
get_tab_title(tab_idx: int) const |
|
get_tab_tooltip(tab_idx: int) const |
|
is_tab_disabled(tab_idx: int) const |
|
is_tab_hidden(tab_idx: int) const |
|
void |
|
void |
set_tab_button_icon(tab_idx: int, icon: Texture2D) |
void |
set_tab_disabled(tab_idx: int, disabled: bool) |
void |
set_tab_hidden(tab_idx: int, hidden: bool) |
void |
set_tab_icon(tab_idx: int, icon: Texture2D) |
void |
set_tab_icon_max_width(tab_idx: int, width: int) |
void |
set_tab_metadata(tab_idx: int, metadata: Variant) |
void |
set_tab_title(tab_idx: int, title: String) |
void |
set_tab_tooltip(tab_idx: int, tooltip: String) |
Propiedades del Tema
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
Señales
active_tab_rearranged(idx_to: int) 🔗
Emitida cuando la pestaña activa se reorganiza mediante el arrastre del ratón. Véase drag_to_rearrange_enabled.
pre_popup_pressed() 🔗
Emitida cuando se hace clic en el botón Popup del TabContainer. Consulta set_popup() para obtener más detalles.
tab_button_pressed(tab: int) 🔗
Emitida cuando el usuario hace clic en el icono del botón en esta pestaña.
Emitida cuando se cambia a otra pestaña.
Emitida cuando se hace clic con el botón derecho del ratón en una pestaña.
Emitida cuando una pestaña tiene encima el cursor del ratón.
Emitida cuando una pestaña es seleccionada mediante un clic, entrada direccional o script, incluso si es la pestaña actual.
Enumeraciones
enum TabPosition: 🔗
TabPosition POSITION_TOP = 0
Coloca la barra de pestañas en la parte superior.
TabPosition POSITION_BOTTOM = 1
Coloca la barra de pestañas en la parte inferior. El StyleBox de la barra de pestañas se volteará verticalmente.
TabPosition POSITION_MAX = 2
Representa el tamaño del enum TabPosition.
Descripciones de Propiedades
bool all_tabs_in_front = false 🔗
Si es true, todas las pestañas se dibujan delante del panel. Si es false, las pestañas inactivas se dibujan detrás del panel.
Si es true, las pestañas que se desborden del ancho de este nodo se ocultarán, mostrando dos botones de navegación en su lugar. De lo contrario, el tamaño mínimo de este nodo se actualiza para que todas las pestañas sean visibles.
El índice de la pestaña actual. Cuando se establece, la propiedad visible del nodo Control de este índice se establece en true y todas las demás se establecen en false.
Un valor de -1 significa que no hay ninguna pestaña seleccionada.
bool deselect_enabled = false 🔗
Si es true, se pueden deseleccionar todas las pestañas para que no haya ninguna pestaña seleccionada. Haz clic en la current_tab para deseleccionarla.
Solo se mostrará la cabecera de pestañas si no hay ninguna pestaña seleccionada.
bool drag_to_rearrange_enabled = false 🔗
Si es true, las pestañas se pueden reorganizar con el arrastre del ratón.
AlignmentMode tab_alignment = 0 🔗
void set_tab_alignment(value: AlignmentMode)
AlignmentMode get_tab_alignment()
La posición en la que se colocarán las pestañas.
FocusMode tab_focus_mode = 2 🔗
The focus access mode for the internal TabBar node.
TabPosition tabs_position = 0 🔗
void set_tabs_position(value: TabPosition)
TabPosition get_tabs_position()
La posición de la barra de pestañas.
int tabs_rearrange_group = -1 🔗
Los TabContainers con el mismo ID de grupo de reorganización permitirán arrastrar las pestañas entre ellos. Habilita el arrastre con drag_to_rearrange_enabled.
Establecer esto a -1 deshabilitará la reorganización entre TabContainers.
Si es true, las pestañas son visibles. Si es false, el contenido y los títulos de las pestañas están ocultos.
Si es true, los nodos hijos Control que están ocultos tienen su tamaño mínimo en cuenta en el total, en lugar de sólo el actualmente visible.
Descripciones de Métodos
Control get_current_tab_control() const 🔗
Devuelve el nodo hijo Control situado en el pestaña activa.
Returns the Popup node instance if one has been set already with set_popup().
Warning: This is a required internal node, removing and freeing it may cause a crash. If you wish to hide it or any of its children, use their Window.visible property.
int get_previous_tab() const 🔗
Devuelve la pestaña anteriormente activa.
Returns the TabBar contained in this container.
Warning: This is a required internal node, removing and freeing it or editing its tabs may cause a crash. If you wish to edit the tabs, use the methods provided in TabContainer.
Texture2D get_tab_button_icon(tab_idx: int) const 🔗
Returns the button icon from the tab at index tab_idx.
Control get_tab_control(tab_idx: int) const 🔗
Returns the Control node from the tab at index tab_idx.
Devuelve el número de pestañas.
Texture2D get_tab_icon(tab_idx: int) const 🔗
Returns the Texture2D for the tab at index tab_idx or null if the tab has no Texture2D.
int get_tab_icon_max_width(tab_idx: int) const 🔗
Devuelve el ancho máximo permitido del icono para la pestaña en el índice tab_idx.
int get_tab_idx_at_point(point: Vector2) const 🔗
Devuelve el índice de la pestaña en las coordenadas locales point. Devuelve -1 si el punto está fuera de los límites del control o si no hay ninguna pestaña en la posición consultada.
int get_tab_idx_from_control(control: Control) const 🔗
Returns the index of the tab tied to the given control. The control must be a child of the TabContainer.
Variant get_tab_metadata(tab_idx: int) const 🔗
Devuelve el valor de los metadatos establecidos en la pestaña en el índice tab_idx utilizando set_tab_metadata(). Si no se han establecido metadatos previamente, devuelve null por defecto.
String get_tab_title(tab_idx: int) const 🔗
Returns the title of the tab at index tab_idx. Tab titles default to the name of the indexed child node, but this can be overridden with set_tab_title().
String get_tab_tooltip(tab_idx: int) const 🔗
Devuelve el texto de la información sobre herramientas de la pestaña en el índice tab_idx.
bool is_tab_disabled(tab_idx: int) const 🔗
Devuelve true si la pestaña en el índice tab_idx está desactivada.
Devuelve true si la pestaña en el índice tab_idx está oculta.
bool select_next_available() 🔗
Selecciona la primera pestaña disponible con un índice mayor que la actualmente seleccionada. Devuelve true si la selección de la pestaña cambió.
bool select_previous_available() 🔗
Selecciona la primera pestaña disponible con un índice menor que la actualmente seleccionada. Devuelve true si la selección de la pestaña cambió.
If set on a Popup node instance, a popup menu icon appears in the top-right corner of the TabContainer (setting it to null will make it go away). Clicking it will expand the Popup node.
void set_tab_button_icon(tab_idx: int, icon: Texture2D) 🔗
Establece el icono del botón de la pestaña en el índice tab_idx.
void set_tab_disabled(tab_idx: int, disabled: bool) 🔗
Si disabled es true, desactiva la pestaña en el índice tab_idx, haciéndola no interactiva.
Si hidden es true, oculta la pestaña en el índice tab_idx, haciéndola desaparecer del área de pestañas.
void set_tab_icon(tab_idx: int, icon: Texture2D) 🔗
Establece un icono para la pestaña en el índice tab_idx.
void set_tab_icon_max_width(tab_idx: int, width: int) 🔗
Establece el ancho máximo permitido del icono para la pestaña en el índice tab_idx. Este límite se aplica sobre el tamaño predeterminado del icono y sobre icon_max_width. La altura se ajusta según la relación del icono.
void set_tab_metadata(tab_idx: int, metadata: Variant) 🔗
Establece el valor de los metadatos para la pestaña en el índice tab_idx, que se puede recuperar más tarde utilizando get_tab_metadata().
void set_tab_title(tab_idx: int, title: String) 🔗
Establece un título personalizado para la pestaña en el índice tab_idx (los títulos de las pestañas por defecto son el nombre del nodo hijo indexado). Vuelve a establecerlo con el nombre del hijo para que la pestaña vuelva a usarlo por defecto.
void set_tab_tooltip(tab_idx: int, tooltip: String) 🔗
Sets a custom tooltip text for tab at index tab_idx.
Note: By default, if the tooltip is empty and the tab text is truncated (not all characters fit into the tab), the title will be displayed as a tooltip. To hide the tooltip, assign " " as the tooltip text.
Descripciones de las propiedades del tema
Color drop_mark_color = Color(1, 1, 1, 1) 🔗
Color de modulación para el icono drop_mark.
Color font_disabled_color = Color(0.875, 0.875, 0.875, 0.5) 🔗
El color de la fuente de las pestañas desactivadas.
Color font_hovered_color = Color(0.95, 0.95, 0.95, 1) 🔗
Font color of the currently hovered tab.
Color font_outline_color = Color(0, 0, 0, 1) 🔗
El tinte del contorno del texto del nombre de la pestaña.
Color font_selected_color = Color(0.95, 0.95, 0.95, 1) 🔗
Color de la fuente de la pestaña actualmente seleccionada.
Color font_unselected_color = Color(0.7, 0.7, 0.7, 1) 🔗
Color de la fuente de las otras pestañas no seleccionadas.
El ancho máximo permitido para el icono de la pestaña. Este límite se aplica sobre el tamaño por defecto del icono, pero antes del valor establecido con TabBar.set_tab_icon_max_width(). La altura se ajusta según la relación de aspecto del icono.
Espacio entre el nombre de la pestaña y su icono.
El tamaño del contorno del texto de la pestaña.
Nota: Si utilizas una fuente con FontFile.multichannel_signed_distance_field activado, su FontFile.msdf_pixel_range debe establecerse al menos al doble del valor de outline_size para que el renderizado del contorno se vea correctamente. De lo contrario, el contorno puede aparecer recortado antes de lo previsto.
El espacio en los bordes izquierdo o derecho de la barra de pestañas, de acuerdo con el tab_alignment actual.
El margen se ignora con TabBar.ALIGNMENT_RIGHT si las pestañas se recortan (véase clip_tabs) o si se ha establecido un popup (ver set_popup()). El margen siempre se ignora con TabBar.ALIGNMENT_CENTER.
The space between tabs in the tab bar.
La fuente usada para dibujar los nombres de las pestañas.
Tamaño de fuente de los nombres de las pestañas.
Icono para el botón de la flecha izquierda que aparece cuando hay demasiadas pestañas que no caben en el ancho del contenedor. Cuando el botón está desactivado (es decir, la primera pestaña es visible), aparece semi-transparente.
Texture2D decrement_highlight 🔗
Icono para el botón de la flecha izquierda que aparece cuando hay demasiadas pestañas que no caben en el ancho del contenedor. Se utiliza cuando el cursor se mantiene encima del botón.
Icono que se muestra para indicar dónde se va a soltar una pestaña arrastrada (véase drag_to_rearrange_enabled).
Icono para el botón de la flecha derecha que aparece cuando hay demasiadas pestañas que no caben en el ancho del contenedor. Cuando el botón está desactivado (es decir, la última pestaña es visible) aparece semi-transparente.
Texture2D increment_highlight 🔗
Icono para el botón de la flecha derecha que aparece cuando hay demasiadas pestañas que no caben en el ancho del contenedor. Se utiliza cuando el cursor esta encima del botón.
El icono para el botón de menú (véase set_popup()).
El icono del botón de menú (véase set_popup()) cuando se pasa el cursor por encima de él.
El estilo para el relleno de fondo.
El estilo de las pestañas desactivadas.
StyleBox que se usa cuando el TabBar tiene el foco. El StyleBox de tab_focus se muestra sobre el StyleBox base de la pestaña seleccionada, por lo que se debe usar un StyleBox parcialmente transparente para garantizar que el StyleBox base permanezca visible. Un StyleBox que representa un contorno o un subrayado funciona bien para este propósito. Para deshabilitar el efecto visual de foco, asigna un recurso StyleBoxEmpty. Ten en cuenta que deshabilitar el efecto visual de foco perjudicará la usabilidad de la navegación por teclado/controlador, por lo que no se recomienda por razones de accesibilidad.
The style of the currently hovered tab.
Note: This style will be drawn with the same width as tab_unselected at minimum.
El estilo de la pestaña actualmente seleccionada.
El estilo de las otras pestañas no seleccionadas.
El estilo para el relleno de fondo del área de TabBar.