Skip to main content

Svg

Struct Svg 

Source
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. 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

O arquivo SVG no projeto (assets/images/logo.svg).

§color: Option<Color>

A cor do currentColor do SVG; sem cor, a cor de texto do tema.

§fit: ImageFit

Como a imagem ocupa o controle: caber inteira, cobrir, esticar…

§highlight: String

Os id dos elementos pintados com highlight_color, separados por ;; vazio: nenhum.

§highlight_color: Option<Color>

A cor dos elementos do highlight; sem cor, a cor de destaque do tema.

§zoom_to: String

O id do elemento cuja área é mostrada (o município dentro do mapa); vazio: o SVG inteiro.

Implementations§

Source§

impl Svg

Source

pub fn new(source: impl Into<String>) -> Self

Source

pub fn set_svg(&mut self, text: &str) -> Result<(), String>

Usa um SVG dado pelo código (texto), no lugar de source.

Trait Implementations§

Source§

impl Component for Svg

Source§

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>

Dados de controle visual. Componentes não visuais devolvem None.
Source§

fn control_mut(&mut self) -> Option<&mut ControlBase>

Source§

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>

Lê uma propriedade desta camada; None se não for dela.
Source§

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<'_>)

Pinta o controle. O canvas já está na origem do controle; ctx.rect é a área dele.
Source§

fn inner(&self) -> Option<&(dyn Component + 'static)>

O componente “pai” na composição, se houver (o equivalente ao ancestral).
Source§

fn inner_mut(&mut self) -> Option<&mut (dyn Component + 'static)>

Source§

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>

O evento padrão: o duplo clique no designer cria o handler dele e abre o código. 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)

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

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. Os que têm fundo usam o fill no desenho deles.
Source§

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<'_>)

Pinta por cima dos filhos (bordas, anel de foco…).
Source§

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<'_>>

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<'_>)

O tamanho real (bounds) mudou depois de um layout (como o Resize).
Source§

fn click(&mut self, ctx: &mut EventCtx<'_>)

Clique (como Click). O padrão dispara o evento on_click.
Source§

fn pointer_down(&mut self, ctx: &mut EventCtx<'_>, event: &PointerEvent)

Source§

fn pointer_up(&mut self, ctx: &mut EventCtx<'_>, event: &PointerEvent)

Source§

fn pointer_move(&mut self, ctx: &mut EventCtx<'_>, event: &PointerEvent)

Source§

fn pointer_enter(&mut self, ctx: &mut EventCtx<'_>)

Source§

fn pointer_leave(&mut self, ctx: &mut EventCtx<'_>)

Source§

fn wheel(&mut self, ctx: &mut EventCtx<'_>, event: &WheelEvent)

Source§

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.
Source§

fn swipe(&mut self, ctx: &mut EventCtx<'_>, event: &SwipeEvent)

Um deslizar do dedo (o Carousel troca de item, o TabControl de página). Marque como tratado (ctx.set_handled()) para não subir para os pais.
Source§

fn touch_end(&mut self, ctx: &mut EventCtx<'_>)

O dedo que arrastava (rolando) saiu da tela: quem segue o arrasto por dentro (a linha da lista deslizada para mostrar as ações) fecha ou fica aberto. Vai ao controle tocado e a todos os pais.
Source§

fn edge_swipe(&mut self, ctx: &mut EventCtx<'_>, event: &SwipeEvent) -> bool

Um deslizar que começou na borda do form (event.start nas coordenadas do form) e que ninguém tratou: a NavigationDrawer abre. true se tratou.
Source§

fn context_menu( &mut self, ctx: &mut EventCtx<'_>, at: PointF, touch: bool, ) -> bool

O menu de contexto próprio do controle (o de texto do Edit e do Memo: Recortar, Copiar, Colar, Selecionar tudo). O Ui chama no botão direito e no toque longo (touch), subindo do controle tocado pelos pais, só quando nem ele nem um pai tem popup_menu (o menu do app vence). at é o ponto local. true se abriu um menu.
Source§

fn key_down(&mut self, ctx: &mut EventCtx<'_>, event: &KeyEvent)

Source§

fn key_up(&mut self, ctx: &mut EventCtx<'_>, event: &KeyEvent)

Source§

fn shortcut(&mut self, ctx: &mut EventCtx<'_>, event: &KeyEvent)

Tecla de atalho que ninguém tratou (como o atalho 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>

Os ganchos raros (barra de tarefas, bandeja, vista nativa, conector, arquivos soltos), se este componente usa: devolva Some(self) e implemente PlatformHooks.
Source§

fn platform_hooks_mut(&mut self) -> Option<&mut dyn PlatformHooks>

Source§

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.
Source§

fn design_hooks_mut(&mut self) -> Option<&mut dyn DesignHooks>

Source§

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

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)

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)>

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>

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

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, )

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<'_>)

O arrasto saiu de cima do componente (ou foi cancelado).
Source§

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)

O arrasto que começou neste componente acabou (on_drag_end também dispara).
Source§

fn accepts_text(&self) -> bool

Source§

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>

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

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)

Texto digitado (já com acentos e IME resolvidos pela plataforma).
Source§

fn focus_enter(&mut self, ctx: &mut EventCtx<'_>)

Source§

fn focus_exit(&mut self, ctx: &mut EventCtx<'_>)

Source§

fn property_changed(&mut self, ctx: &mut EventCtx<'_>, name: &str)

Uma propriedade publicada mudou por nome (Ui::set_prop: JSON, Object Inspector, protocolo). É o lugar dos efeitos colaterais da mudança: aqui o componente tem o Ui (por exemplo, o TabControl mostra a aba nova).
Source§

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>

Os argumentos do on_change quando a propriedade de valor name muda pelo código (Ui::set_prop: o acesso tipado, o protocolo); 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

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>

Intervalo do timer deste componente, em segundos (None = parado). O Ui dispara on_timer a cada intervalo; ver Ui::sync_timer.
Source§

fn timer_precision(&self) -> TimerPrecision

Quanto o timer pode atrasar (TimerPrecision).
Source§

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)

Quanto o disparo que vem a seguir atrasou, em segundos (antes de timer).
Source§

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<'_>)

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>>

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.
Source§

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

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>

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>

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

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

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>

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>

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

Clica ou seleciona o item index de access_items. Devolve false se não fez nada.
Source§

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)>

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))

Mensagem enviada por outro componente com Ui::send_message. 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]

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>

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.
Source§

impl Default for Svg

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

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> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.