pub struct ControlBase { /* private fields */ }Expand description
Dados comuns de todo controle visual.
left, top, width e height são os valores pedidos. A posição e o tamanho
reais, calculados pelo layout (Align/Anchors), ficam em bounds.
Implementations§
Source§impl ControlBase
impl ControlBase
pub fn new(width: f32, height: f32) -> Self
pub fn left(&self) -> f32
pub fn top(&self) -> f32
pub fn width(&self) -> f32
pub fn height(&self) -> f32
pub fn position(&self) -> PointF
pub fn size(&self) -> SizeF
Sourcepub fn margins(&self) -> Bounds
pub fn margins(&self) -> Bounds
As margens que valem no layout (com a escala de espaços da vista ativa; a propriedade guarda a do desenho).
pub fn align(&self) -> Align
pub fn anchors(&self) -> Anchors
pub fn visible(&self) -> bool
Sourcepub fn design_only(&self) -> bool
pub fn design_only(&self) -> bool
Só aparece no designer (em execução não é pintado nem recebe o mouse).
Sourcepub fn colors(&self) -> ColorOverride
pub fn colors(&self) -> ColorOverride
As cores próprias.
pub fn set_colors(&mut self, colors: ColorOverride) -> &mut Self
pub fn set_design_only(&mut self, on: bool) -> &mut Self
Sourcepub fn keep_left_to_right(&self) -> bool
pub fn keep_left_to_right(&self) -> bool
Fica da esquerda para a direita (ele e os filhos) com a interface espelhada.
pub fn set_keep_left_to_right(&mut self, on: bool) -> &mut Self
pub fn enabled(&self) -> bool
pub fn hit_test(&self) -> bool
pub fn translatable(&self) -> bool
pub fn set_translatable(&mut self, v: bool) -> &mut Self
pub fn inherit_state(&self) -> bool
pub fn set_inherit_state(&mut self, v: bool) -> &mut Self
pub fn clip_children(&self) -> bool
pub fn captures_wheel(&self) -> bool
pub fn captures_gesture(&self) -> bool
Sourcepub fn draggable(&self) -> bool
pub fn draggable(&self) -> bool
Pode receber o foco do teclado (como CanFocus).
Arrastável: passar de alguns pontos com o
botão pressionado dispara on_drag_start, e o handler começa o arrasto com
Ui::begin_drag.
pub fn set_draggable(&mut self, v: bool) -> &mut Self
Sourcepub fn accepts_drops(&self) -> bool
pub fn accepts_drops(&self) -> bool
Recebe o que é arrastado: on_drag_over ao entrar (o handler recusa com
Ui::reject_drop) e on_drag_drop ao soltar.
pub fn set_accepts_drops(&mut self, v: bool) -> &mut Self
Sourcepub fn drag_data(&self) -> &str
pub fn drag_data(&self) -> &str
O que vai no arrasto declarado (vazio: só com o on_drag_start).
pub fn drag_label(&self) -> &str
Sourcepub fn drag_image(&self) -> Option<ComponentId>
pub fn drag_image(&self) -> Option<ComponentId>
O DragImage do arrasto (a imagem que acompanha o cursor).
Sourcepub fn drop_types(&self) -> &str
pub fn drop_types(&self) -> &str
Os tipos aceitos ao soltar (vazio: decide o on_drag_over).
pub fn can_focus(&self) -> bool
Menu de contexto do controle.
Sourcepub fn pan_on_touch(&self) -> bool
pub fn pan_on_touch(&self) -> bool
Ver set_pan_on_touch.
Sourcepub fn hover_within(&self) -> bool
pub fn hover_within(&self) -> bool
Ver set_hover_within.
Sourcepub fn set_hover_within(&mut self, v: bool) -> &mut Self
pub fn set_hover_within(&mut self, v: bool) -> &mut Self
A pintura depende do mouse estar no controle ou num filho dele (o :hover do CSS, que
vale com o mouse num filho): o núcleo repinta o controle quando o mouse entra ou sai de
qualquer um dos de dentro, e Ui::hover_within diz se está.
Sourcepub fn cursor(&self) -> CursorShape
pub fn cursor(&self) -> CursorShape
Cursor do mouse sobre o controle. Default herda o do pai.
pub fn opacity(&self) -> f32
Sourcepub fn blend_mode(&self) -> BlendMode
pub fn blend_mode(&self) -> BlendMode
Como o controle se junta ao que está por baixo (veja o campo).
pub fn set_blend_mode(&mut self, mode: BlendMode) -> &mut Self
Sourcepub fn cache_layer(&self) -> bool
pub fn cache_layer(&self) -> bool
O desenho guardado numa imagem (veja o campo).
pub fn set_cache_layer(&mut self, on: bool) -> &mut Self
Sourcepub fn rotation(&self) -> f32
pub fn rotation(&self) -> f32
Giro em graus, em torno do centro. Só a pintura gira; o clique usa o retângulo sem giro.
Sourcepub fn inner_size(&self) -> SizeF
pub fn inner_size(&self) -> SizeF
O tamanho do espaço de dentro: o do retângulo dividido pela escala. É nele que o
controle se desenha (PaintCtx::rect) e que os filhos são arrumados.
pub fn shadow(&self) -> Option<Shadow>
Sourcepub fn aspect_ratio(&self) -> f32
pub fn aspect_ratio(&self) -> f32
Proporção fixa (largura ÷ altura); 0 = livre. No layout, a altura sai da largura (Top, Bottom, Horizontal, None), a largura sai da altura (Left, Right, Vertical) ou o controle cabe na área mantendo a proporção (Client, Center).
pub fn set_aspect_ratio(&mut self, ratio: f32) -> &mut Self
Sourcepub fn max_width(&self) -> f32
pub fn max_width(&self) -> f32
Largura máxima (0 = sem limite). O controle não passa dela; alinhado em cima, embaixo ou no cliente, fica no meio da área (o conteúdo de uma página que não se espalha numa tela larga). No form, é a largura máxima da janela.
pub fn set_max_width(&mut self, width: f32) -> &mut Self
Sourcepub fn min_width(&self) -> f32
pub fn min_width(&self) -> f32
Largura mínima (0 = sem limite). O layout não deixa o controle mais estreito que ela,
mesmo alinhado (top, client…): o que passar da área do pai fica cortado (ou rola,
num ScrollBox), e um texto com wrap para de quebrar nessa largura. No form, é a
largura mínima da janela.
pub fn set_min_width(&mut self, width: f32) -> &mut Self
Sourcepub fn min_height(&self) -> f32
pub fn min_height(&self) -> f32
Altura mínima (0 = sem limite), como a min_width.
pub fn set_min_height(&mut self, height: f32) -> &mut Self
Sourcepub fn max_height(&self) -> f32
pub fn max_height(&self) -> f32
Altura máxima (0 = sem limite). No form, é a altura máxima da janela.
pub fn set_max_height(&mut self, height: f32) -> &mut Self
Sourcepub fn clamp_width(&self, available: f32) -> f32
pub fn clamp_width(&self, available: f32) -> f32
A largura que o controle ocupa numa faixa de available (com a max_width e a
min_width; a mínima vence).
Sourcepub fn clamp_height(&self, height: f32) -> f32
pub fn clamp_height(&self, height: f32) -> f32
A altura dentro da min_height e da max_height (a mínima vence).
Sourcepub fn self_align(&self) -> SelfAlign
pub fn self_align(&self) -> SelfAlign
Encaixado, estica na faixa (stretch) ou fica com o próprio tamanho no começo, no
meio ou no fim: veja SelfAlign.
pub fn set_self_align(&mut self, align: SelfAlign) -> &mut Self
Sourcepub fn band_width(&self, available: f32) -> f32
pub fn band_width(&self, available: f32) -> f32
A largura numa faixa horizontal de available (encaixado em cima ou embaixo): a faixa
toda ou, com self_align, a própria width; com self_align e max_width, a faixa até
a máxima (o width: 100%; max-width do CSS). Sempre dentro dos limites.
Sourcepub fn band_height(&self, available: f32) -> f32
pub fn band_height(&self, available: f32) -> f32
A altura numa faixa vertical de available (encaixado à esquerda ou à direita), como a
band_width.
Sourcepub fn band_offset(&self, available: f32, size: f32) -> f32
pub fn band_offset(&self, available: f32, size: f32) -> f32
Onde começa um tamanho size numa faixa de available: no começo, no meio (o
stretch com a largura máxima sobrando) ou no fim. Passando da faixa, no começo.
Sourcepub fn auto_size(&self) -> bool
pub fn auto_size(&self) -> bool
A altura sai do conteúdo, na largura que o controle tem:
um Label com wrap fica da altura do texto quebrado; um contêiner, da
altura dos filhos encaixados em cima e embaixo (mais o padding). Vale com align
top, bottom ou none.
pub fn set_auto_size(&mut self, on: bool) -> &mut Self
Sourcepub fn column_span(&self) -> u32
pub fn column_span(&self) -> u32
Quantas colunas ocupa num GridLayout (pelo menos 1; numa grade com menos colunas,
ocupa a linha inteira).
Sourcepub fn grid_cell(&self) -> Option<(u32, u32)>
pub fn grid_cell(&self) -> Option<(u32, u32)>
O lugar fixo na grade: (linha, coluna), ou None (segue a ordem dos filhos).
pub fn set_grid_cell(&mut self, cell: Option<(u32, u32)>) -> &mut Self
pub fn set_row_span(&mut self, span: u32) -> &mut Self
pub fn grow(&self) -> f32
pub fn set_grow(&mut self, grow: f32) -> &mut Self
pub fn set_column_span(&mut self, span: u32) -> &mut Self
Sourcepub fn text_scale(&self) -> f32
pub fn text_scale(&self) -> f32
A escala de fonte da vista ativa do form (1 sem vista).
Sourcepub fn spacing_scale(&self) -> f32
pub fn spacing_scale(&self) -> f32
A escala de espaços da vista ativa do form (1 sem vista).
pub fn tag(&self) -> i64
Sourcepub fn accessible_name(&self) -> &str
pub fn accessible_name(&self) -> &str
O nome que o leitor de tela fala (o aria-label), no lugar do texto do controle: um
botão só com ícone, um campo sem rótulo. O relatório do Tabernáculo, C29.
pub fn set_accessible_name(&mut self, v: &str) -> &mut Self
pub fn tag_string(&self) -> &str
Sourcepub fn style(&self) -> &str
pub fn style(&self) -> &str
Variante de estilo do tema (“primary”, “danger”, “flat”…). Vazio = estilo da classe.
Sourcepub fn theme_name(&self) -> &str
pub fn theme_name(&self) -> &str
Tema próprio do controle (e dos filhos), pelo nome. Vazio = o do pai.
pub fn set_theme_name(&mut self, v: impl Into<String>) -> &mut Self
Sourcepub fn hint(&self) -> &str
pub fn hint(&self) -> &str
Dica (balão) mostrada com o mouse parado sobre o controle. Vazio = a do pai.
pub fn set_hint(&mut self, v: impl Into<String>) -> &mut Self
pub fn state(&self) -> ControlState
Sourcepub fn bounds(&self) -> RectF
pub fn bounds(&self) -> RectF
Posição e tamanho reais, relativos ao pai, calculados pelo layout.
Sourcepub fn scroll_offset(&self) -> PointF
pub fn scroll_offset(&self) -> PointF
Quanto o conteúdo está rolado: os filhos são deslocados por este valor.
Sourcepub fn laid_out_scroll(&self) -> PointF
pub fn laid_out_scroll(&self) -> PointF
A rolagem com que o último layout pôs os filhos (scroll_offset
muda na hora; esta, no layout): somada à posição de um filho, dá onde ele está no conteúdo.
Sourcepub fn set_scroll_offset(&mut self, offset: PointF) -> &mut Self
pub fn set_scroll_offset(&mut self, offset: PointF) -> &mut Self
Rola o conteúdo. Chame invalidate (ou mude por ui.control_mut) para refazer o
layout.
Sourcepub fn content_size(&self) -> SizeF
pub fn content_size(&self) -> SizeF
Tamanho ocupado pelos filhos visíveis (com margens e padding), calculado no layout. Serve para saber até onde rolar.
pub fn set_left(&mut self, v: f32) -> &mut Self
pub fn set_top(&mut self, v: f32) -> &mut Self
pub fn set_position(&mut self, left: f32, top: f32) -> &mut Self
pub fn set_width(&mut self, v: f32) -> &mut Self
pub fn set_height(&mut self, v: f32) -> &mut Self
pub fn set_size(&mut self, width: f32, height: f32) -> &mut Self
Sourcepub fn set_rect(
&mut self,
left: f32,
top: f32,
width: f32,
height: f32,
) -> &mut Self
pub fn set_rect( &mut self, left: f32, top: f32, width: f32, height: f32, ) -> &mut Self
Define posição e tamanho de uma vez.
pub fn set_margins(&mut self, v: impl Into<Bounds>) -> &mut Self
pub fn set_padding(&mut self, v: impl Into<Bounds>) -> &mut Self
pub fn set_align(&mut self, v: Align) -> &mut Self
pub fn set_anchors(&mut self, v: Anchors) -> &mut Self
pub fn set_visible(&mut self, v: bool) -> &mut Self
pub fn set_enabled(&mut self, v: bool) -> &mut Self
pub fn set_hit_test(&mut self, v: bool) -> &mut Self
pub fn set_clip_children(&mut self, v: bool) -> &mut Self
pub fn set_captures_wheel(&mut self, v: bool) -> &mut Self
pub fn set_captures_gesture(&mut self, v: bool) -> &mut Self
pub fn set_can_focus(&mut self, v: bool) -> &mut Self
Sourcepub fn set_pan_on_touch(&mut self, v: bool) -> &mut Self
pub fn set_pan_on_touch(&mut self, v: bool) -> &mut Self
Arrastar o dedo sobre o controle rola o conteúdo (vira roda para o ScrollBox ou o DataGrid de baixo). Ligado por padrão; controles que precisam do arrasto em si (um Splitter, um designer) desligam.
pub fn set_tab_stop(&mut self, v: bool) -> &mut Self
pub fn set_cursor(&mut self, v: CursorShape) -> &mut Self
pub fn set_opacity(&mut self, v: f32) -> &mut Self
pub fn set_translate(&mut self, offset: PointF) -> &mut Self
Sourcepub fn set_scale(&mut self, scale: f32) -> &mut Self
pub fn set_scale(&mut self, scale: f32) -> &mut Self
A escala dele e dos filhos (1 = normal; de 0,05 a 20).
pub fn set_rotation(&mut self, degrees: f32) -> &mut Self
pub fn set_shadow(&mut self, shadow: Option<Shadow>) -> &mut Self
pub fn set_tag(&mut self, v: i64) -> &mut Self
pub fn set_tag_string(&mut self, v: &str) -> &mut Self
pub fn set_style(&mut self, v: impl Into<String>) -> &mut Self
Sourcepub fn state_mut(&mut self) -> &mut ControlState
pub fn state_mut(&mut self) -> &mut ControlState
Estado visual (hover, pressed…). Normalmente quem altera é o despacho de eventos;
controles como CheckBox alteram checked.
pub fn get_prop(&self, name: &str) -> Option<PropValue>
pub fn set_prop(&mut self, name: &str, value: PropValue) -> Result<()>
Source§impl ControlBase
impl ControlBase
Sourcepub fn font(&self) -> &FontOverride
pub fn font(&self) -> &FontOverride
A fonte própria do controle (sem a herdada).