pub struct Svg {
pub base: ControlBase,
pub source: String,
pub color: Option<Color>,
pub fit: ImageFit,
pub highlight: String,
pub highlight_color: Option<Color>,
pub zoom_to: String,
/* private fields */
}Expand description
Imagem SVG desenhada como vetor (o TPath com um arquivo inteiro). source é o
arquivo no projeto (assets/images/logo.svg); color é o currentColor (sem ela,
a cor de texto do tema: ícones em SVG acompanham o tema claro e o escuro).
Para mapas: highlight pinta os elementos com esses id (separados por ;) com
highlight_color (sem ela, a cor de destaque do tema) e zoom_to mostra só a área do
elemento com esse id (o município dentro do mapa do estado).
Fields§
§base: ControlBase§source: String§color: Option<Color>§fit: ImageFit§highlight: String§highlight_color: Option<Color>§zoom_to: StringImplementations§
Trait Implementations§
Source§impl Component for Svg
impl Component for Svg
Source§fn class_name(&self) -> &'static str
fn class_name(&self) -> &'static str
Nome da classe (“Button”, “ClientDataSet”…). É o nome usado no registro de
classes, nos arquivos de layout e nos estilos do tema.
Source§fn control(&self) -> Option<&ControlBase>
fn control(&self) -> Option<&ControlBase>
Dados de controle visual. Componentes não visuais devolvem
None.fn control_mut(&mut self) -> Option<&mut ControlBase>
Source§fn props(&self) -> &'static [PropInfo]
fn props(&self) -> &'static [PropInfo]
Propriedades publicadas desta camada. As do componente base (
inner) e as do
ControlBase são incluídas automaticamente pelo Ui.Source§fn get_prop(&self, name: &str) -> Option<PropValue>
fn get_prop(&self, name: &str) -> Option<PropValue>
Lê uma propriedade desta camada;
None se não for dela.Source§fn set_prop(&mut self, name: &str, value: PropValue) -> Result<()>
fn set_prop(&mut self, name: &str, value: PropValue) -> Result<()>
Grava uma propriedade desta camada. Devolva
Error::UnknownProperty se não for
dela (o Ui então tenta a camada base).Source§fn paint(&self, canvas: &mut dyn Canvas, ctx: &PaintCtx<'_>)
fn paint(&self, canvas: &mut dyn Canvas, ctx: &PaintCtx<'_>)
Pinta o controle. O canvas já está na origem do controle;
ctx.rect é a área dele.Source§fn inner(&self) -> Option<&(dyn Component + 'static)>
fn inner(&self) -> Option<&(dyn Component + 'static)>
O componente “pai” na composição, se houver (o equivalente ao ancestral).
fn inner_mut(&mut self) -> Option<&mut (dyn Component + 'static)>
Source§fn class_chain(&self, out: &mut Vec<&'static str>)
fn class_chain(&self, out: &mut Vec<&'static str>)
Cadeia de classes, da mais derivada para a base. Usada pelo tema: um
GlowButton sem estilo próprio usa o estilo de Button.Source§fn default_event(&self) -> Option<&'static str>
fn default_event(&self) -> Option<&'static str>
O evento padrão: o duplo clique no designer cria o handler dele e abre o código
(como no Delphi).
None: a IDE escolhe pelo nome (o on_change da classe, o
on_timer… ou o on_click).Source§fn notification(&mut self, freed: ComponentId)
fn notification(&mut self, freed: ComponentId)
Avisa que um componente foi liberado (como
Notification(AComponent, opRemove)).
Quem guarda referências para outros componentes deve limpá-las aqui.Source§fn transparent_background(&self) -> bool
fn transparent_background(&self) -> bool
O controle não tem fundo (um texto, uma caixa de seleção, um medidor): com o
fill
próprio, o Ui pinta o fundo dele inteiro (como o Color do Delphi). Os que têm
fundo usam o fill no desenho deles.Source§fn opaque(&self, style: &ResolvedStyle) -> bool
fn opaque(&self, style: &ResolvedStyle) -> bool
O
paint deste estilo cobre o retângulo inteiro do controle com cor opaca (um painel
de fundo sólido sem cantos arredondados, um form). Com true, o que fica inteiro atrás
dele (um irmão pintado antes) não é pintado: um medidor animando embaixo de uma tela que
o cobre não pede quadros. Na dúvida, false (o padrão): só se perde a economia.Source§fn paint_after(&self, canvas: &mut dyn Canvas, ctx: &PaintCtx<'_>)
fn paint_after(&self, canvas: &mut dyn Canvas, ctx: &PaintCtx<'_>)
Pinta por cima dos filhos (bordas, anel de foco…).
Source§fn paint_is_pure(&self) -> bool
fn paint_is_pure(&self) -> bool
A pintura (
paint e paint_after) só lê: sem efeito colateral (nada de evento, de
cache que avança, de quadro de vídeo consumido) e o mesmo desenho para o mesmo estado,
estilo e propriedades. Com true, o Ui pode ensaiar o desenho fora do quadro e não
repintar o controle quando ele não mudou (o fundo de um contêiner quando o mouse entra
nele). Os contêineres simples dizem true; o padrão é false, mesmo com inner
(quem herda de um contêiner e pinta por cima precisa dizer de novo).Source§fn provided(&self) -> Option<Provided<'_>>
fn provided(&self) -> Option<Provided<'_>>
Um componente provedor (item 25): o que ele oferece aos componentes que o apontam pela
propriedade
provider (veja crate::providers). O padrão: nada.Source§fn resized(&mut self, ctx: &mut EventCtx<'_>)
fn resized(&mut self, ctx: &mut EventCtx<'_>)
O tamanho real (
bounds) mudou depois de um layout (como o Resize).Source§fn click(&mut self, ctx: &mut EventCtx<'_>)
fn click(&mut self, ctx: &mut EventCtx<'_>)
Clique (como
Click). O padrão dispara o evento on_click.fn pointer_down(&mut self, ctx: &mut EventCtx<'_>, event: &PointerEvent)
fn pointer_up(&mut self, ctx: &mut EventCtx<'_>, event: &PointerEvent)
fn pointer_move(&mut self, ctx: &mut EventCtx<'_>, event: &PointerEvent)
fn pointer_enter(&mut self, ctx: &mut EventCtx<'_>)
fn pointer_leave(&mut self, ctx: &mut EventCtx<'_>)
fn wheel(&mut self, ctx: &mut EventCtx<'_>, event: &WheelEvent)
Source§fn gesture(&mut self, ctx: &mut EventCtx<'_>, event: &GestureEvent)
fn gesture(&mut self, ctx: &mut EventCtx<'_>, event: &GestureEvent)
Pinça/giro de dois dedos. Marque como tratado (
ctx.set_handled()) para não subir
para os pais.fn key_down(&mut self, ctx: &mut EventCtx<'_>, event: &KeyEvent)
fn key_up(&mut self, ctx: &mut EventCtx<'_>, event: &KeyEvent)
Source§fn shortcut(&mut self, ctx: &mut EventCtx<'_>, event: &KeyEvent)
fn shortcut(&mut self, ctx: &mut EventCtx<'_>, event: &KeyEvent)
Tecla de atalho que ninguém tratou (como o
ShortCut de um item de menu): o Ui
oferece a todos os componentes do form. Marque como tratado
(EventCtx::set_handled) se for sua.Source§fn platform_hooks(&self) -> Option<&dyn PlatformHooks>
fn platform_hooks(&self) -> Option<&dyn PlatformHooks>
Os ganchos raros (barra de tarefas, bandeja, vista nativa, conector, arquivos soltos),
se este componente usa: devolva
Some(self) e implemente PlatformHooks.fn platform_hooks_mut(&mut self) -> Option<&mut dyn PlatformHooks>
Source§fn design_hooks(&self) -> Option<&dyn DesignHooks>
fn design_hooks(&self) -> Option<&dyn DesignHooks>
Os ganchos do designer (pontos que se arrastam dentro do controle), se este
componente usa: devolva
Some(self) e implemente DesignHooks.fn design_hooks_mut(&mut self) -> Option<&mut dyn DesignHooks>
Source§fn contains_point(&self, local: PointF, size: SizeF) -> bool
fn contains_point(&self, local: PointF, size: SizeF) -> bool
O ponto (coordenadas do controle, já sem a rotação) acerta o controle? Padrão: o
retângulo inteiro. As formas (círculo, estrela, linha…) respondem só na figura.
Source§fn hit_slop(&self) -> f32
fn hit_slop(&self) -> f32
Quanto o controle recebe o mouse além do próprio retângulo (as alças de uma moldura
desenhadas do lado de fora). Fora do retângulo, quem decide é o
contains_point (que recebe o ponto fora dele). Padrão: 0.Source§fn scroll_axes(&self) -> (bool, bool)
fn scroll_axes(&self) -> (bool, bool)
Em que eixos o conteúdo rola (horizontal, vertical): o
Ui::reveal
rola estes contêineres para mostrar um controle de dentro (o campo sob o teclado).Source§fn drag_item(&self, _ui: &Ui) -> Option<(String, String)>
fn drag_item(&self, _ui: &Ui) -> Option<(String, String)>
O componente edita texto. No celular, quando ele tem o foco a plataforma abre o
teclado virtual.
O que vai num arrasto que começa neste controle sem
drag_data nem handler: as listas
e as grades mandam o item (o texto, a chave do registro) e o rótulo. None: nada.Source§fn drag_visual(&self, _ui: &Ui, _source: ComponentId) -> Option<DragVisual>
fn drag_visual(&self, _ui: &Ui, _source: ComponentId) -> Option<DragVisual>
O que acompanha o cursor num arrasto, quando este componente é o
drag_image de um
controle (o DragImage); source é o controle arrastado. None: nada.Source§fn drop_accepts(&self, _ui: &Ui, _id: ComponentId, _data: &str) -> bool
fn drop_accepts(&self, _ui: &Ui, _id: ComponentId, _data: &str) -> bool
O próprio componente recebe este arrasto (sem
accepts_drops nem eventos): as abas
que passam de uma faixa para outra. Vale também quando ele é a origem (a aba que volta
para a faixa de onde saiu). Com true, recebe drop_hover,
drop_leave e drop_receive.Source§fn drop_hover(
&mut self,
_ctx: &mut EventCtx<'_>,
_data: &str,
_position: PointF,
)
fn drop_hover( &mut self, _ctx: &mut EventCtx<'_>, _data: &str, _position: PointF, )
O arrasto aceito por
drop_accepts está sobre o componente, no
ponto position (coordenadas dele); chamado a cada movimento.Source§fn drop_leave(&mut self, _ctx: &mut EventCtx<'_>)
fn drop_leave(&mut self, _ctx: &mut EventCtx<'_>)
O arrasto saiu de cima do componente (ou foi cancelado).
Source§fn drop_receive(
&mut self,
_ctx: &mut EventCtx<'_>,
_data: &str,
_position: PointF,
)
fn drop_receive( &mut self, _ctx: &mut EventCtx<'_>, _data: &str, _position: PointF, )
Soltou o arrasto aceito sobre o componente, em
position (coordenadas dele).Source§fn drag_ended(&mut self, _ctx: &mut EventCtx<'_>, _data: &str, _end: DragEnd)
fn drag_ended(&mut self, _ctx: &mut EventCtx<'_>, _data: &str, _end: DragEnd)
O arrasto que começou neste componente acabou (
on_drag_end também dispara).fn accepts_text(&self) -> bool
Source§fn captures_key(&self, event: &KeyEvent) -> bool
fn captures_key(&self, event: &KeyEvent) -> bool
O controle usa a tecla (o Enter de um Memo, as setas de uma lista): ela não vira o
Tab do form (
tab_keys).Source§fn mnemonic_text(&self) -> Option<&str>
fn mnemonic_text(&self) -> Option<&str>
A legenda com o
& da letra do atalho ("&Salvar": Alt+S), para os controles que
aceitam (botões, caixas de marcar, rótulos, grupos).Source§fn mnemonic_focuses_child(&self) -> bool
fn mnemonic_focuses_child(&self) -> bool
No Alt+letra, o foco vai para o primeiro filho (um grupo) em vez de clicar.
Source§fn text_input(&mut self, ctx: &mut EventCtx<'_>, text: &str)
fn text_input(&mut self, ctx: &mut EventCtx<'_>, text: &str)
Texto digitado (já com acentos e IME resolvidos pela plataforma).
fn focus_enter(&mut self, ctx: &mut EventCtx<'_>)
fn focus_exit(&mut self, ctx: &mut EventCtx<'_>)
Source§fn property_changed(&mut self, ctx: &mut EventCtx<'_>, name: &str)
fn property_changed(&mut self, ctx: &mut EventCtx<'_>, name: &str)
Uma propriedade publicada mudou por nome (
Ui::set_prop: JSON,
Object Inspector, protocolo). Como um setter do Delphi com efeitos colaterais: aqui
o componente tem o Ui (por exemplo, o TabControl mostra a aba nova).Source§fn checked_state(&self) -> Option<bool>
fn checked_state(&self) -> Option<bool>
A marca do controle agora (
checked), lida pelo núcleo na pintura: o tema reflete a
marca mesmo quando o campo muda direto, sem o set_prop (C02 do Tabernáculo).Source§fn change_args(&self, name: &str, value: &PropValue) -> Option<EventArgs>
fn change_args(&self, name: &str, value: &PropValue) -> Option<EventArgs>
Os argumentos do
on_change quando a propriedade de valor name muda pelo código
(Ui::set_prop: o acesso tipado, o protocolo), como na VCL;
value é o valor novo. O padrão é EventArgs::Value(value): o controle que dispara
outro argumento quando o usuário muda (o texto do item, numa ComboBox) devolve o mesmo
aqui, e None não dispara. Quais propriedades contam: is_value_property.Source§fn paint_only_property(&self, name: &str) -> bool
fn paint_only_property(&self, name: &str) -> bool
A propriedade
name só muda a pintura (o valor de um medidor, o giro de um 3D): o
set_prop dela repinta sem refazer o layout da tela. As do controle (cores, opacidade,
giro, deslocamento, cursor, dica) o Ui já conhece; aqui vão as do componente. Na
dúvida, false (refazer o layout nunca está errado, só custa).Source§fn timer_interval(&self) -> Option<f64>
fn timer_interval(&self) -> Option<f64>
Intervalo do timer deste componente, em segundos (
None = parado). O Ui dispara
on_timer a cada intervalo (como o TTimer); ver Ui::sync_timer.Source§fn timer_precision(&self) -> TimerPrecision
fn timer_precision(&self) -> TimerPrecision
Quanto o timer pode atrasar (
TimerPrecision).Source§fn timer_background(&self) -> bool
fn timer_background(&self) -> bool
O timer conta numa thread própria (não espera o laço da tela, que pode estar
ocupado); o
on_timer chega à tela pelo Poster.Source§fn timer_late(&mut self, late: f64)
fn timer_late(&mut self, late: f64)
Quanto o disparo que vem a seguir atrasou, em segundos (antes de
timer).Source§fn frame(&mut self, ctx: &mut EventCtx<'_>) -> bool
fn frame(&mut self, ctx: &mut EventCtx<'_>) -> bool
Um quadro vai ser pintado (pedido com
Ui::request_frames):
chamado antes da pintura, com o tempo do quadro em ctx.ui.time(), para um movimento
que acompanha o monitor (a rolagem com deslize). Devolve se quer o próximo quadro.Source§fn timer(&mut self, ctx: &mut EventCtx<'_>)
fn timer(&mut self, ctx: &mut EventCtx<'_>)
O timer venceu (ver
timer_interval). O padrão dispara o
evento on_timer.Source§fn arrange(&self, area: RectF, children: &[ArrangeItem]) -> Option<Vec<RectF>>
fn arrange(&self, area: RectF, children: &[ArrangeItem]) -> Option<Vec<RectF>>
Organiza os filhos com
align = None (grade, fluxo…): recebe a área livre (já
sem o padding e sem o que os filhos encaixados ocuparam) e o tamanho pedido e as
margens de cada filho; devolve o retângulo de cada um, na mesma ordem. None (o
padrão) = posição livre, como no FMX.Source§fn baseline(&self, ui: &Ui, id: ComponentId, height: f32) -> Option<f32>
fn baseline(&self, ui: &Ui, id: ComponentId, height: f32) -> Option<f32>
A linha de base do texto do controle, em pixels do topo dele, na altura
height (para
o FlowLayout com baseline alinhar os textos de uma fileira; L12 do Tabernáculo).
None (o padrão): o controle não tem texto, e fica pelo fundo.Source§fn dock_gap(&self) -> f32
fn dock_gap(&self) -> f32
O vão entre os filhos encaixados (Top, Left…), em pixels: o
gap do Layout e do
Panel (o gap do CSS; L05 do Tabernáculo). Padrão: 0.Source§fn auto_height(&self, ui: &Ui, id: ComponentId, width: f32) -> Option<f32>
fn auto_height(&self, ui: &Ui, id: ComponentId, width: f32) -> Option<f32>
A altura que o conteúdo pede na largura
width (o texto de um Label quebrado nela),
para o auto_size. None (o padrão): o controle não mede o conteúdo (um contêiner
com auto_size fica da altura dos filhos encaixados em cima e embaixo).Source§fn auto_width(&self, ui: &Ui, id: ComponentId) -> Option<f32>
fn auto_width(&self, ui: &Ui, id: ComponentId) -> Option<f32>
A largura que o conteúdo pede (o texto de um Label sem quebra), para o
auto_size de
quem não é esticado na largura (align left, right ou none). None (o padrão): a
largura fica a pedida.Source§fn closes_on_outside_press(&self) -> bool
fn closes_on_outside_press(&self) -> bool
Uma camada aberta por outro (a lista de um ComboBox, as sugestões de um campo), posta
direto no form: o mouse apertado fora dela e fora de quem a abriu (
dies_with) a
libera, mesmo que o clique caia onde não recebe foco (o fundo da tela, um rótulo). O
dono fica sabendo pelo notification. Padrão: false.Source§fn dismissed(&mut self, ctx: &mut EventCtx<'_>) -> bool
fn dismissed(&mut self, ctx: &mut EventCtx<'_>) -> bool
O clique fora fechou a camada (
closes_on_outside_press): true se ela mesma se
escondeu e deve continuar existindo (o Popover, desenhado no form com os filhos);
false (o padrão), o núcleo a libera.Source§fn dies_with(&self) -> Option<ComponentId>
fn dies_with(&self) -> Option<ComponentId>
Este componente só vive enquanto
dies_with existir: liberar aquele libera este
também. É o que a lista aberta de um ComboBox (uma camada sobre o form) usa: se o
ComboBox some (a tela foi refeita), a lista não fica órfã na tela.Source§fn access_items(&self, ui: &Ui, id: ComponentId) -> Vec<AccessItem>
fn access_items(&self, ui: &Ui, id: ComponentId) -> Vec<AccessItem>
Os itens que o controle desenha sozinho (abas, linhas, itens de menu, células), para
leitores de tela, automação e testes (
crate::automation). id é este controle.Source§fn access_action(
&mut self,
ctx: &mut EventCtx<'_>,
index: usize,
action: ItemAction,
) -> bool
fn access_action( &mut self, ctx: &mut EventCtx<'_>, index: usize, action: ItemAction, ) -> bool
Source§fn attach(&self) -> Option<(ComponentId, f32, f32)>
fn attach(&self) -> Option<(ComponentId, f32, f32)>
Prende o controle a um irmão (mesmo pai): devolve o alvo e o ponto dele onde o
centro deste controle fica (
0..1 na largura e na altura: (1, 0) é o canto de
cima à direita). É o que deixa um Badge no canto de um botão.Source§fn event_info(&self, event: &str) -> Vec<(&'static str, String)>
fn event_info(&self, event: &str) -> Vec<(&'static str, String)>
Dados extras de um evento que está sendo entregue (chave e texto), para quem recebe
os eventos fora do Rust: o protocolo os manda no
info do evento (o on_message do
WebView manda a URL de quem mandou).Source§fn message(&mut self, ctx: &mut EventCtx<'_>, message: &(dyn Any + 'static))
fn message(&mut self, ctx: &mut EventCtx<'_>, message: &(dyn Any + 'static))
Mensagem enviada por outro componente com
Ui::send_message
(como o Perform/mensagens do Delphi). O tipo da mensagem é livre: cada camada
(por exemplo a de dados) define as suas e o componente faz downcast_ref.Source§fn methods(&self) -> &'static [MethodInfo]
fn methods(&self) -> &'static [MethodInfo]
Os métodos que
invoke atende, com os tipos (o catálogo do
acesso tipado nas linguagens: frmPaint.pcDesenho.Undo).Source§fn invoke(
&mut self,
ctx: &mut EventCtx<'_>,
method: &str,
args: &[PropValue],
) -> Result<PropValue, String>
fn invoke( &mut self, ctx: &mut EventCtx<'_>, method: &str, args: &[PropValue], ) -> Result<PropValue, String>
Um método pelo nome (
Ui::invoke, o comando invoke do
protocolo): o que não é propriedade, como undo, clear ou save. Funciona igual
em Rust e nas outras linguagens (pelo protocolo). Devolve o resultado ou o erro.Auto Trait Implementations§
impl !Freeze for Svg
impl !RefUnwindSafe for Svg
impl !Send for Svg
impl !Sync for Svg
impl Forget for Svg
impl Move for Svg
impl Unpin for Svg
impl UnsafeUnpin for Svg
impl UnwindSafe for Svg
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more