SDK Multiplataforma en C logo

SDK Multiplataforma en C

Layout

❮ Anterior
Siguiente ❯

Funciones

Layout*layout_create (...)
Cell*layout_cell (...)
GuiControl*layout_control (...)
voidlayout_label (...)
voidlayout_button (...)
voidlayout_popup (...)
voidlayout_edit (...)
voidlayout_combo (...)
voidlayout_listbox (...)
voidlayout_updown (...)
voidlayout_slider (...)
voidlayout_progress (...)
voidlayout_view (...)
voidlayout_textview (...)
voidlayout_webview (...)
voidlayout_imageview (...)
voidlayout_tableview (...)
voidlayout_splitview (...)
voidlayout_panel (...)
voidlayout_panel_replace (...)
voidlayout_layout (...)
Label*layout_get_label (...)
Button*layout_get_button (...)
PopUp*layout_get_popup (...)
Edit*layout_get_edit (...)
Combo*layout_get_combo (...)
ListBox*layout_get_listbox (...)
UpDown*layout_get_updown (...)
Slider*layout_get_slider (...)
Progress*layout_get_progress (...)
View*layout_get_view (...)
TextView*layout_get_textview (...)
WebView*layout_get_webview (...)
ImageView*layout_get_imageview (...)
TableView*layout_get_tableview (...)
SplitView*layout_get_splitview (...)
Panel*layout_get_panel (...)
Layout*layout_get_layout (...)
uint32_tlayout_ncols (...)
uint32_tlayout_nrows (...)
voidlayout_insert_col (...)
voidlayout_insert_row (...)
voidlayout_remove_col (...)
voidlayout_remove_row (...)
voidlayout_taborder (...)
voidlayout_tabstop (...)
voidlayout_hsize (...)
voidlayout_vsize (...)
voidlayout_hmargin (...)
voidlayout_vmargin (...)
voidlayout_hexpand (...)
voidlayout_hexpand2 (...)
voidlayout_hexpand3 (...)
voidlayout_vexpand (...)
voidlayout_vexpand2 (...)
voidlayout_vexpand3 (...)
voidlayout_halign (...)
voidlayout_valign (...)
voidlayout_show_col (...)
voidlayout_show_row (...)
voidlayout_margin (...)
voidlayout_margin2 (...)
voidlayout_margin4 (...)
voidlayout_bgcolor (...)
voidlayout_skcolor (...)
voidlayout_update (...)
voidlayout_dbind (...)
voidlayout_dbind_obj (...)
voidlayout_dbind_update (...)

Un Layout es una rejilla virtual y transparente vinculada siempre con un Panel que sirve para ubicar los diferentes elementos de la interfaz (Figura 1). Sus celdas interiores tienen la capacidad de dimensionarse automáticamente en función de su contenido, con lo que se consigue una gran portabilidad debido a que no es necesario indicar coordenadas ni tamaños específicos para los controles. Para ilustrar el concepto, vamos a simplificar ligeramente el código de ¡Hola Edit y UpDown! (Listado 1), cuyo resultado podemos verlo en (Figura 2).


1. Dimensionado natural

El resultado de (Figura 2), si bien no es muy estético, es lo que denominamos dimensionado natural que es la maquetación por defecto aplicada en función del contenido de las celdas. En (Tabla 1) tienes las medidas por defecto de cada control. El ancho de columna se fija al del elemento más ancho y de igual forma se calcula la altura de las filas. El tamaño final del layout será la suma de las medidas tanto de columnas como de filas.

Tabla 1: Dimensionado natural de controles.
Control Anchura Altura
Label Ajustado al texto. Ajustado al texto considerando '\n'.
Button (push) Ajustado al texto + márgen. Según el tema del S.O.
Button (check/radio) Ajustado al texto + icono. Ajustado al icono.
Button (flat) Ajustado al icono + margen. Ajustado al icono + margen.
PopUp Ajustado al texto mas largo. Según el tema del S.O.
Edit 100 Unidades (px). Ajustado al texto + margen.
Combo 100 Unidades (px). Según el tema del S.O.
ListBox 128 px o listbox_size. 128 px o listbox_size.
UpDown Según el tema del S.O. Según el tema del S.O.
Slider (horizontal) 100 Unidades (px). Según el tema del S.O.
Slider (vertical) Según el tema del S.O. 100 Unidades (px).
Progress 100 Unidades (px). Según el tema del S.O.
View 128 px o view_size. 128 px o view_size.
TextView 256 px o textview_size. 144 px o textview_size.
WebView 256 px o webview_size. 144 px o webview_size.
ImageView 64 px o imageview_size. 64 px o imageview_size.
TableView 256 px o tableview_size. 128 px o tableview_size.
SplitView 128 px o splitview_size. 128 px o splitview_size.
Panel Dimensión natural. Dimensión natural.
Panel (con scroll) 256 px o panel_size. 256 px o panel_size.

Los márgenes y constantes aplicados a los controles son los necesarios para cumplir con las human guidelines de cada gestor de ventanas. Esto quiere decir que un PushButton con el texto "Hello" no tendrá las mismas dimensiones en WindowsXP que en macOS Mavericks o Ubuntu 16.

Las celdas vacías se dimensionarán con tamaño 0 y no afectarán a la composición.

2. Márgenes y formato

El dimensionado natural que acabamos de ver ajusta el panel al tamaño mínimo necesario para albergar correctamente todos los controles, pero no siempre resulta estético. Podemos darle forma añadiendo márgenes o forzando un tamaño determinado para filas y columnas (Listado 2) (Figura 3).


3. Alineación

Es habitual que la anchura un control sea inferior a la anchura de la columna que lo contiene, bien porque se ha forzado un ancho fijo o bien porque existan elementos más anchos en la misma columna. En estos casos, podemos indicar la alineación horizontal o vertical del control respecto a la celda (Figura 4). En (Tabla 2) tienes las alineaciones por defecto.


4. Sub-layouts

Consideremos ahora el panel de (Figura 5). No es difícil darse cuenta que esta disposición no encaja de ninguna manera en una rejilla rectangular, por lo que ha llegado el momento de utilizar sublayouts. Además de controles individuales, una celda admite también otro layout, por lo que podemos dividir el panel original en tantas partes como sean necesarias hasta conseguir la maquetación deseada. El layout principal irá dimensionando cada sublayout de forma recursiva e integrándolo en la composición final. En ¡Hola Sublayout! tienes el código que genera este ejemplo.

  • Utiliza layout_layout para asignar un layout completo a una celda de otro layout.
  • Ventana con diferentes controles organizados en bloques.
    Figura 5: Composición de panel compleja.

En este caso hemos aplicado la filosofía del divide y vencerás, hasta asegurar que cada parte encaje en una rejilla individual (Figura 6). Cada sublayout lo hemos codificado en una función independiente para darle mayor consistencia al código, aplicando márgenes y formato de forma individual dentro de cada una de ellas (Listado 3).

Esquema que muestra los límites de cada sub-layout.
Figura 6: Sublayouts necesarios para componer el panel de (Figura 5).
Listado 3: Integración de sublayouts (parcial).
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
static Layout *i_main_layout(void)
{
    Layout *layout1 = layout_create(1, 2);
    Layout *layout2 = i_top_layout();
    Layout *layout3 = i_bottom_layout();
    layout_layout(layout1, layout2, 0, 0);
    layout_layout(layout1, layout3, 0, 1);
    layout_margin(layout1, 5);
    layout_vmargin(layout1, 0, 5);
    return layout1;
}

5. Expansión de celdas

En ciertas ocasiones, el tamaño de un layout viene forzado por condiciones externas. Esto ocurre cuando tenemos un sublayout en una celda con alineación ekJUSTIFY (expansión interna) o cuando el usuario cambia el tamaño de una ventana re-dimensionable (expansión externa). Esto producirá un "exceso de píxeles" entre el dimensionado natural y el tamaño real de la celda (Figura 7). Esta situación se resuelve repartiendo el sobrante por igual entre todas las columnas del sublayout, que a su vez, se irán expandiendo de forma recursiva hasta llegar a una celda vacía o un control individual. Podemos cambiar este reparto equitativo mediante estas funciones:

  • Utiliza layout_hexpand para expandir una única celda y dejar el resto con su tamaño por defecto.
  • Utiliza layout_hexpand2 para expandir dos celdas indicando la proporción de crecimiento de cada una.
  • Utiliza layout_hexpand3 para expandir tres celdas.
  • Comportamiento de un sublayout cuando su tamaño se expande para ajustarse a una celda.
    Figura 7: Cuando el tamaño del sublayout viene dado por condiciones externas, se reparte por igual el exceso de píxeles entre las columnas (expansión horizontal) y filas (expansión vertical).
La expansión vertical funciona exactamente igual, repartiendo el espacio sobrante entre las filas del layout.

6. Interfaces dinámicas

En la mayoría de ocasiones, sobre todo en aplicaciones sencillas, la interfaz de usuario permanecerá inalterada durante toda la ejecución, al margen posibles re-dimensionados. Es decir, se genera un layout, se ubican en él los controles necesarios y se vinculan con la ventana principal mediante un panel. En aplicaciones más complejas es posible que parte de la interfaz deba cambiar en tiempo de ejecución, asegurando que dichos cambios mantengan la coherencia del diseño inicial en cuanto a tamaños, márgenes y ubicación de los elementos. NAppGUI proporciona tres mecanismos para implementar cambios en tiempo de ejecución.

Es importante recordar que, tras cada cambio, deberemos actualizar la ventana para que el compositor recompute y actualice la vista. Esto se lleva a cabo mediante las funciones: layout_update, panel_update o window_update. Las tres llamadas son equivalentes.

6.1. Reemplazo de paneles

Esta funcionalidad nos permite sustituir un panel existente, y posiblemente visible, por otro generado en tiempo de ejecución. El cambio tendrá asociada una re-composición de la ventana que se realizará de forma automática y transparente para el programador. Esto precisamente es lo que hace la aplicación ¡Hola GUI! a medida que seleccionamos elementos del ListBox lateral (Listado 4) (Figura 8).

Listado 4: Creación y cambio de un panel en tiempo de ejecución.
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
static void i_set_panel(App *app, const uint32_t index)
{
    Panel *panel = NULL;
    switch (index) {
    /* ... */
    case 5:
        panel = listboxes();
        break;
    case 6:
        panel = form_basic();
        break;
    /* ... */
    }

    layout_panel_replace(app->layout, panel, 1, 0);
}
Representación de una ventana donde se ha sustituido uno de sus paneles descendiente.
Figura 8: Efecto de reemplazar un panel.
Solo es posible reemplazar un panel por otro. No es posible hacerlo con otro tipo de controles.
El panel existente y sus elementos internos serán totalmente destruidos, no siendo posible recuperarlos de nuevo.

6.2. Layouts dinámicos

Por layout dinámico entendemos la posibilidad de añadir o eliminar filas y columnas a un layout ya existente y vinculado con un panel. Al igual que ocurre con el reemplazo de paneles, modificar un layout implica re-computar la interfaz y actualizar el contenido de la ventana. En ¡Hola Layouts dinámicos! tienes un ejemplo de uso. Al insertar una fila o columna se crearán una serie de celdas vacías de tamaño cero, lo que no producirá ningún impacto visual en la ventana (nada cambiará aparentemente). Será en el momento de añadir controles o sublayouts a dichas celdas cuando se perciba el cambio en la ventana. Por otro lado, eliminar una fila o columna implicará la destrucción de todo el contenido de las celdas, tanto controles como sublayouts, no siendo posible recuperarlos de nuevo.

Representación de una ventana donde se están añadiendo y eliminado filas y columnas con controles de interfaz.
Figura 9: Añadir/eliminar filas/columnas en un layout. Animación en https://nappgui.com/img/gui/dynamic_layout.gif.
No es posible eliminar todas las filas o todas las columnas. Como mínimo se requiere 1x1 celdas.
Al eliminar una fila o columna todos los elementos de las celdas serán destruidos y no se podrán recuperar.

7. Tabstops

Normalmente utilizaremos la tecla [TAB] y la combinación [SHIFT]+[TAB] para navegar por los diferentes controles de una ventana o formulario. Términos como taborder o tabstop hacen referencia tanto al orden de navegación como a la pertenencia (o no) de un elemento a dicha lista. Si bien es posible organizar los elementos de una tab-list aleatoriamente, los layouts proporcionan un orden natural coherente basado en la ubicación de los controles. Por defecto, cada layout crea una tab-list recorriendo todas sus celdas por filas (Figura 10), pero podemos cambiarlo:

  • Utiliza layout_taborder para organizar la tab-list por filas o columnas.
  • Utiliza layout_tabstop para añadir o quitar controles de la tab-list.
  • Animación que muestra la navegación con la tecla [TAB] tabstops. Organización de los controles de la tablist.
    Figura 10: Taborder por filas en layouts y sublayouts. Animación en https://nappgui.com/img/gui/tabstops.gif.

No todas las celdas de un layout tienen porqué ser un tabstop, ya que no tiene sentido que controles estáticos como Label reciban el foco del teclado. En (Tabla 3) tienes los controles que se incluyen por defecto en dicha lista. Con layout_tabstop podrás añadir o quitar controles de la tab-list.

Tabla 3: Controles incluidos por defecto en el tab-list.
Control Incluido
Label NO
Button
PopUp
Edit
Combo
ListBox
UpDown NO
Slider
Progress NO
View NO
TextView NO
WebView NO
ImageView NO
TableView
SplitView SÍ (hijos)
Layout (sublayout)
Panel SÍ (hijos)
Cuando el taborder entra en un sublayout, seguirá el orden local de este último. Cuando salga del sublayout continuará con el orden principal.
❮ Anterior
Siguiente ❯

layout_create ()

Crea un nuevo layout especificando el número de columnas y filas.

Layout*
layout_create(const uint32_t ncols,
              const uint32_t nrows);
ncols

El número de columnas.

nrows

El número de filas.

Retorna

El nuevo layout.


layout_cell ()

Obtiene una celda del layout.

Cell*
layout_cell(Layout *layout,
            const uint32_t col,
            const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

La celda.


layout_control ()

Obtiene el control asignado a una celda del layout.

GuiControl*
layout_control(Layout *layout,
               const uint32_t col,
               const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El control o NULL, si la celda está vacía o contiene un sublayout.


layout_label ()

Inserta un control Label en un layout.

void
layout_label(Layout *layout,
             Label *label,
             const uint32_t col,
             const uint32_t row);
layout

El layout.

label

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_button ()

Inserta un control Button en un layout.

void
layout_button(Layout *layout,
              Button *button,
              const uint32_t col,
              const uint32_t row);
layout

El layout.

button

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_popup ()

Inserta un control PopUp en un layout.

void
layout_popup(Layout *layout,
             PopUp *popup,
             const uint32_t col,
             const uint32_t row);
layout

El layout.

popup

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_edit ()

Inserta un control Edit en un layout.

void
layout_edit(Layout *layout,
            Edit *edit,
            const uint32_t col,
            const uint32_t row);
layout

El layout.

edit

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_combo ()

Inserta un control Combo en un layout.

void
layout_combo(Layout *layout,
             Combo *combo,
             const uint32_t col,
             const uint32_t row);
layout

El layout.

combo

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_listbox ()

Inserta un control ListBox en un layout.

void
layout_listbox(Layout *layout,
               ListBox *list,
               const uint32_t col,
               const uint32_t row);
layout

El layout.

list

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_updown ()

Inserta un control UpDown en un layout.

void
layout_updown(Layout *layout,
              UpDown *updown,
              const uint32_t col,
              const uint32_t row);
layout

El layout.

updown

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_slider ()

Inserta un control Slider en un layout.

void
layout_slider(Layout *layout,
              Slider *slider,
              const uint32_t col,
              const uint32_t row);
layout

El layout.

slider

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_progress ()

Inserta un control Progress en un layout.

void
layout_progress(Layout *layout,
                Progress *progress,
                const uint32_t col,
                const uint32_t row);
layout

El layout.

progress

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_view ()

Inserta una vista View en un layout.

void
layout_view(Layout *layout,
            View *view,
            const uint32_t col,
            const uint32_t row);
layout

El layout.

view

La vista a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_textview ()

Inserta un control TextView en un layout.

void
layout_textview(Layout *layout,
                TextView *view,
                const uint32_t col,
                const uint32_t row);
layout

El layout.

view

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_webview ()

Inserta un control WebView en un layout.

void
layout_webview(Layout *layout,
               WebView *view,
               const uint32_t col,
               const uint32_t row);
layout

El layout.

view

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_imageview ()

Inserta un control ImageView en un layout.

void
layout_imageview(Layout *layout,
                 ImageView *view,
                 const uint32_t col,
                 const uint32_t row);
layout

El layout.

view

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_tableview ()

Inserta un control TableView en un layout.

void
layout_tableview(Layout *layout,
                 TableView *view,
                 const uint32_t col,
                 const uint32_t row);
layout

El layout.

view

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_splitview ()

Inserta un control SplitView en un layout.

void
layout_splitview(Layout *layout,
                 SplitView *view,
                 const uint32_t col,
                 const uint32_t row);
layout

El layout.

view

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_panel ()

Inserta un control Panel en un layout.

void
layout_panel(Layout *layout,
             Panel *panel,
             const uint32_t col,
             const uint32_t row);
layout

El layout.

panel

El control a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_panel_replace ()

Reemplaza un Panel en un layout por otro.

void
layout_panel_replace(Layout *layout,
                     Panel *panel,
                     const uint32_t col,
                     const uint32_t row);
layout

El layout.

panel

El nuevo panel.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Observaciones

En la celda (col,row) debe existir previamente un panel que será destruido, sin posibilidad de recuperarlo. Ver Reemplazo de paneles.


layout_layout ()

Inserta un layout en una celda de otro layout.

void
layout_layout(Layout *layout,
              Layout *sublayout,
              const uint32_t col,
              const uint32_t row);
layout

El layout principal.

sublayout

El layout a insertar.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.


layout_get_label ()

Obtiene el Label de una celda.

Label*
layout_get_label(const Layout *layout,
                 const uint32_t col,
                 const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El label o NULL, si la celda está vacía o contiene otra cosa.


layout_get_button ()

Obtiene el Button de una celda.

Button*
layout_get_button(const Layout *layout,
                  const uint32_t col,
                  const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El button o NULL, si la celda está vacía o contiene otra cosa.


layout_get_popup ()

Obtiene el PopUp de una celda.

PopUp*
layout_get_popup(const Layout *layout,
                 const uint32_t col,
                 const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El popup o NULL, si la celda está vacía o contiene otra cosa.


layout_get_edit ()

Obtiene el Edit de una celda.

Edit*
layout_get_edit(const Layout *layout,
                const uint32_t col,
                const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El edit o NULL, si la celda está vacía o contiene otra cosa.


layout_get_combo ()

Obtiene el Combo de una celda.

Combo*
layout_get_combo(const Layout *layout,
                 const uint32_t col,
                 const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El combo o NULL, si la celda está vacía o contiene otra cosa.


layout_get_listbox ()

Obtiene el ListBox de una celda.

ListBox*
layout_get_listbox(const Layout *layout,
                   const uint32_t col,
                   const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El listbox o NULL, si la celda está vacía o contiene otra cosa.


layout_get_updown ()

Obtiene el UpDown de una celda.

UpDown*
layout_get_updown(const Layout *layout,
                  const uint32_t col,
                  const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El updown o NULL, si la celda está vacía o contiene otra cosa.


layout_get_slider ()

Obtiene el Slider de una celda.

Slider*
layout_get_slider(const Layout *layout,
                  const uint32_t col,
                  const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El slider o NULL, si la celda está vacía o contiene otra cosa.


layout_get_progress ()

Obtiene el Progress de una celda.

Progress*
layout_get_progress(const Layout *layout,
                    const uint32_t col,
                    const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El progress o NULL, si la celda está vacía o contiene otra cosa.


layout_get_view ()

Obtiene el View de una celda.

View*
layout_get_view(const Layout *layout,
                const uint32_t col,
                const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El view o NULL, si la celda está vacía o contiene otra cosa.


layout_get_textview ()

Obtiene el TextView de una celda.

TextView*
layout_get_textview(const Layout *layout,
                    const uint32_t col,
                    const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El textview o NULL, si la celda está vacía o contiene otra cosa.


layout_get_webview ()

Obtiene el WebView de una celda.

WebView*
layout_get_webview(const Layout *layout,
                   const uint32_t col,
                   const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El webview o NULL, si la celda está vacía o contiene otra cosa.


layout_get_imageview ()

Obtiene el ImageView de una celda.

ImageView*
layout_get_imageview(const Layout *layout,
                     const uint32_t col,
                     const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El imageview o NULL, si la celda está vacía o contiene otra cosa.


layout_get_tableview ()

Obtiene el TableView de una celda.

TableView*
layout_get_tableview(const Layout *layout,
                     const uint32_t col,
                     const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El tableview o NULL, si la celda está vacía o contiene otra cosa.


layout_get_splitview ()

Obtiene el SplitView de una celda.

SplitView*
layout_get_splitview(const Layout *layout,
                     const uint32_t col,
                     const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El splitview o NULL, si la celda está vacía o contiene otra cosa.


layout_get_panel ()

Obtiene el Panel de una celda.

Panel*
layout_get_panel(const Layout *layout,
                 const uint32_t col,
                 const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El panel o NULL, si la celda está vacía o contiene otra cosa.


layout_get_layout ()

Obtiene el Layout de una celda.

Layout*
layout_get_layout(const Layout *layout,
                  const uint32_t col,
                  const uint32_t row);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

Retorna

El sublayout o NULL, si la celda está vacía o contiene otra cosa.


layout_ncols ()

Obtiene el número de columnas del layout.

uint32_t
layout_ncols(const Layout *layout);
layout

El layout.

Retorna

Número de columnas.

Observaciones

Ver Layouts dinámicos.


layout_nrows ()

Obtiene el número de filas del layout.

uint32_t
layout_nrows(const Layout *layout);
layout

El layout.

Retorna

Número de filas.

Observaciones

Ver Layouts dinámicos.


layout_insert_col ()

Inserta una nueva columna en el layout.

void
layout_insert_col(Layout *layout,
                  const uint32_t col);
layout

El layout.

col

Posición de la nueva columna (0,ncols).

Observaciones

Se insertan celdas vacías que no afectarán a la composición de la ventana. Ver Layouts dinámicos.


layout_insert_row ()

Inserta una nueva fila en el layout.

void
layout_insert_row(Layout *layout,
                  const uint32_t row);
layout

El layout.

row

Posición de la nueva fila (0,nrows).

Observaciones

Se insertan celdas vacías que no afectarán a la composición de la ventana. Ver Layouts dinámicos.


layout_remove_col ()

Elimina una columna existente en el layout.

void
layout_remove_col(Layout *layout,
                  const uint32_t col);
layout

El layout.

col

Posición de la columna a eliminar (0,ncols-1).

Observaciones

Se eliminará todo el contenido de las celdas (controles/sublayouts) de forma irreversible. Ver Layouts dinámicos.


layout_remove_row ()

Elimina una filas existente en el layout.

void
layout_remove_row(Layout *layout,
                  const uint32_t row);
layout

El layout.

row

Posición de la fila a eliminar (0,nrows-1).

Observaciones

Se eliminará todo el contenido de las celdas (controles/sublayouts) de forma irreversible. Ver Layouts dinámicos.


layout_taborder ()

Establece como se moverá el foco del teclado al pulsar [TAB].

void
layout_taborder(Layout *layout,
                const gui_orient_t order);
layout

El layout.

order

Recorrido por filas o columnas.

Observaciones

Ver Tabstops.


layout_tabstop ()

Establece si una celda del layout recibirá o no el foco del teclado al navegar con [TAB]-[SHIFT][TAB].

void
layout_tabstop(Layout *layout,
               const uint32_t col,
               const uint32_t row,
               const bool_t tabstop);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

tabstop

Habilitar o deshabilitar el punto de parada en la celda.

Observaciones

Ver Tabstops.


layout_hsize ()

Establece un ancho fijo para la columna de un layout.

void
layout_hsize(Layout *layout,
             const uint32_t col,
             const real32_t width);
layout

El layout.

col

Índice de la columna.

width

Anchura.


layout_vsize ()

Fuerza un alto fijo para la fila de un layout.

void
layout_vsize(Layout *layout,
             const uint32_t row,
             const real32_t height);
layout

El layout.

row

Índice de la fila.

height

Altura.


layout_hmargin ()

Establece un margen inter-columna dentro del layout. Es la separación entre dos columnas consecutivas.

void
layout_hmargin(Layout *layout,
               const uint32_t col,
               const real32_t margin);
layout

El layout.

col

Índice de la columna. El índice 0 se refiere a la separación entre la columna 0 y la columna 1. ncols-2 es el máximo valor aceptado.

margin

Margen.


layout_vmargin ()

Establece un margen inter-fila dentro del layout. Es la separación entre dos filas consecutivas.

void
layout_vmargin(Layout *layout,
               const uint32_t row,
               const real32_t margin);
layout

El layout.

row

Índice de la fila. El índice 0 se refiere a la separación entre la fila 0 y la fila 1. nrows-2 es el máximo valor aceptado.

margin

Margen.


layout_hexpand ()

Establece la columna que se expandirá horizontalmente.

void
layout_hexpand(Layout *layout,
               const uint32_t col);
layout

El layout.

col

Índice de la columna.

Observaciones

Ver Expansión de celdas.


layout_hexpand2 ()

Establece las dos columnas que se expandirán horizontalmente.

void
layout_hexpand2(Layout *layout,
                const uint32_t col1,
                const uint32_t col2,
                const real32_t exp);
layout

El layout.

col1

Índice de la columna 1.

col2

Índice de la columna 2.

exp

Expansión de col1 entre 0 y 1.

Observaciones

La expansión de col2 = 1 - exp. Ver Expansión de celdas.


layout_hexpand3 ()

Establece las tres columnas que se expandirán horizontalmente.

void
layout_hexpand3(Layout *layout,
                const uint32_t col1,
                const uint32_t col2,
                const uint32_t col3,
                const real32_t exp1,
                const real32_t exp2);
layout

El layout.

col1

Índice de la columna 1.

col2

Índice de la columna 2.

col3

Índice de la columna 3.

exp1

Expansión de col1 entre 0 y 1.

exp2

Expansión de col2 entre 0 y 1.

Observaciones

exp1 + exp2 < = 1. La expansión de col3 = 1 - exp1 - exp2. Ver Expansión de celdas.


layout_vexpand ()

Establece la fila que se expandirá verticalmente.

void
layout_vexpand(Layout *layout,
               const uint32_t row);
layout

El layout.

row

Índice de la fila.

Observaciones

Ver Expansión de celdas.


layout_vexpand2 ()

Establece las dos filas que se expandirán verticalmente.

void
layout_vexpand2(Layout *layout,
                const uint32_t row1,
                const uint32_t row2,
                const real32_t exp);
layout

El layout.

row1

Índice de la fila 1.

row2

Índice de la fila 2.

exp

Expansión de row1 entre 0 y 1.

Observaciones

La expansión de row2 = 1 - exp. Ver Expansión de celdas.


layout_vexpand3 ()

Establece las tres filas que se expandirán verticalmente.

void
layout_vexpand3(Layout *layout,
                const uint32_t row1,
                const uint32_t row2,
                const uint32_t row3,
                const real32_t exp1,
                const real32_t exp2);
layout

El layout.

row1

Índice de la fila 1.

row2

Índice de la fila 2.

row3

Índice de la fila 3.

exp1

Expansión de row1 entre 0 y 1.

exp2

Expansión de row2 entre 0 y 1.

Observaciones

exp1 + exp2 < = 1. La expansión de row3 = 1 - exp1 - exp2. Ver Expansión de celdas.


layout_halign ()

Establece la alineación horizontal de una celda. Tendrá efecto cuando la columna sea más ancha que la celda.

void
layout_halign(Layout *layout,
              const uint32_t col,
              const uint32_t row,
              const align_t align);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

align

Alineación horizontal.


layout_valign ()

Establece la alineación vertical de una celda. Tendrá efecto cuando la fila sea más alta que la celda.

void
layout_valign(Layout *layout,
              const uint32_t col,
              const uint32_t row,
              const align_t align);
layout

El layout.

col

Columna, coordenada x de la celda.

row

Fila, coordenada y de la celda.

align

Alineación vertical.


layout_show_col ()

Muestra u oculta una columna del layout.

void
layout_show_col(Layout *layout,
                const uint32_t col,
                const bool_t visible);
layout

El layout.

col

Índice de columna.

visible

Visible u oculta.


layout_show_row ()

Muestra u oculta una fila del layout.

void
layout_show_row(Layout *layout,
                const uint32_t row,
                const bool_t visible);
layout

El layout.

row

Índice de fila.

visible

Visible u oculta.


layout_margin ()

Establece un margen uniforme para el borde del layout.

void
layout_margin(Layout *layout,
              const real32_t mall);
layout

El layout.

mall

Margen para los cuatro lados (izquierda, derecha, arriba y abajo).


layout_margin2 ()

Establece un margen horizontal y vertical para el borde del layout.

void
layout_margin2(Layout *layout,
               const real32_t mtb,
               const real32_t mlr);
layout

El layout.

mtb

Margen superior e inferior.

mlr

Margen izquierdo y derecho.


layout_margin4 ()

Establece márgenes para el borde del layout.

void
layout_margin4(Layout *layout,
               const real32_t mt,
               const real32_t mr,
               const real32_t mb,
               const real32_t ml);
layout

El layout.

mt

Margen del borde superior.

mr

Margen del borde derecho.

mb

Margen del borde inferior.

ml

Margen del borde izquierdo.


layout_bgcolor ()

Asigna un color de fondo al layout.

void
layout_bgcolor(Layout *layout,
               const color_t color);
layout

El layout.

color

El color. Pasando ekCOLOR_TRANSPARENT se restablece el color por defecto.


layout_skcolor ()

Asigna un color al borde del layout.

void
layout_skcolor(Layout *layout,
               const color_t color);
layout

El layout.

color

El color. Pasando ekCOLOR_TRANSPARENT se restablece el color por defecto.


layout_update ()

Actualiza la ventana asociada con el layout.

void
layout_update(Layout *layout);
layout

El layout.

Observaciones

Es equivalente a llamar a window_update.


layout_dbind ()

Asocia un tipo struct con un layout.

void
layout_dbind(Layout *layout,
             Listener *listener,
             type);
layout

El layout.

listener

Notificará a través de este listener cada vez que el objeto cambie. Puede ser NULL.

type

El tipo de struct.

Observaciones

Ver GUI Data binding.


layout_dbind_obj ()

Asocia un objeto con un layout para visualizarlo y editarlo.

void
layout_dbind_obj(Layout *layout,
                 type *obj,
                 type);
layout

El layout.

obj

El objeto a editar.

type

El tipo del objeto.

Observaciones

Ver GUI Data binding.


layout_dbind_update ()

Actualiza la interfaz del objeto asociado al layout.

void
layout_dbind_update(Layout *layout,
                    type,
                    mtype,
                    mname);
layout

El layout.

type

El tipo de objeto.

mtype

El tipo del campo a actualizar.

mname

El nombre del campo a actualizar.

Observaciones

Ver GUI Data binding.

❮ Anterior
Siguiente ❯