sgcEditors Matriz de recursos
Tudo o que o sgcEditors faz, agrupado por tarefa, com um link para o tópico de ajuda de cada recurso. Cada controle existe para VCL, FireMonkey, WinForms, WPF e Avalonia com as mesmas propriedades e eventos.
Tudo o que o sgcEditors faz, agrupado por tarefa, com um link para o tópico de ajuda de cada recurso. Cada controle existe para VCL, FireMonkey, WinForms, WPF e Avalonia com as mesmas propriedades e eventos.
17 recursos
9 recursos
5 recursos
2 recursos
6 pacotes NuGet
Ajuda online e manuais em PDF
Registrada marca os recursos que estão nas edições Registrada e de Avaliação e não na edição Community gratuita. ~ marca um recurso que a Community tem em parte, com a diferença descrita abaixo.
Cada linha leva ao seu tópico de ajuda. A coluna Community mostra o que a edição .NET Community gratuita inclui; tudo está na Registrada e na Avaliação.
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Calendário mensal | Data única ou intervalo, MinDate e MaxDate, datas e dias da semana desabilitados, números de semana ISO 8601 e visões de mês, ano e década. | Ajuda | |
| Seletor de data | Entrada de data com calendário suspenso e um analisador tolerante que entende nomes de meses. | Ajuda | |
| Seletor de hora | Entrada de hora em um campo de edição nativo. | Ajuda | |
| Seletor de data e hora | Data e hora em um único controle. | Ajuda | |
| Controle deslizante de intervalo | Selecione um valor ou um intervalo em um controle deslizante. O segundo marcador está na edição Registrada. | ~Um cursor é desenhado e editado; EndValue é mantido, mas não é exibido. | Ajuda |
| Seletor de cor | Escolha uma cor. O quadrado HSV e a barra alfa estão na edição Registrada. | ~Somente amostras e hexadecimal; o quadrado HSV e a barra de alfa não são desenhados e o alfa é sempre $FF. | Ajuda |
| Edição de tokens | Chips para tags e destinatários. A lista de preenchimento automático está na edição Registrada. | ~Os chips, a validação e os limites funcionam; a lista de autocompletar nunca abre. | Ajuda |
| Avaliação | Entrada de avaliação por estrelas. | Ajuda | |
| Spin edit | Entrada numérica com roda do mouse e repetição automática. | Ajuda | |
| Edit com botões | Um edit nativo com botões de procurar, lista suspensa, pesquisa, limpar, mais, menos, texto ou desenhados pelo proprietário nos dois lados, cada um com um atalho. Os leitores de tela listam e acionam cada botão. | Ajuda | |
| Edit de pesquisa | OnSearch após uma pausa na digitação ou na hora com Enter, botões de pesquisa e de limpar e um histórico suspenso das pesquisas anteriores. | Ajuda | |
| Edit com máscara | Máscaras de entrada na sintaxe EditMask do Delphi ou MaskedTextBox do .NET, escolhida por MaskSyntax, então uma mesma máscara funciona igual no Delphi e no .NET. Um valor incompleto é informado ao validador. | Ajuda | |
| Edit de moeda | Um valor Currency exato (decimal no .NET) com o formato de moeda da localidade, símbolo ou código ISO, limites e agrupamento durante a digitação. | Ajuda | |
| Edit de lookup | Uma lista suspensa de várias colunas com uma linha de cabeçalho opcional, filtro durante a digitação, uma coluna de chave e uma coluna de exibição. Linhas de Items, OnGetItems ou, no .NET, ItemsSource. | Ajuda | |
| Memo | Um editor de várias linhas com tema, com texto de dica, um contador de caracteres com limite opcional e uma altura que acompanha as linhas. | Ajuda | |
| Interruptor | TsgcVCLToggleSwitch e TsgcFMXToggleSwitch (TsgcWinFormsToggleSwitch, TsgcWpfToggleSwitch e TsgcAvaloniaToggleSwitch no .NET) são interruptores liga/desliga para configurações: uma trilha arredondada com um botão redondo que desliza para o novo estado em cerca de 150 ms, um texto à direita ou à esquerda (CaptionPosition), o texto On e Off dentro da trilha (ShowText), ReadOnly, e cores da trilha e do botão que seguem o tema por padrão. OnChanging cancela uma alteração do usuário, OnChange é disparado após cada alteração e Toggle muda o estado como o usuário faria. Clique, arrasto do botão, Espaço, Esquerda e Direita, direita para a esquerda e uma caixa de seleção com o padrão Toggle para leitores de tela. Checked tem vínculo bidirecional no WPF e no Avalonia. | Ajuda | |
| Edit de endereço IP | TsgcVCLIPAddressEdit e TsgcFMXIPAddressEdit (TsgcWinFormsIPAddressEdit, TsgcWpfIPAddressEdit e TsgcAvaloniaIPAddressEdit no .NET) aceitam um endereço IPv4 ou IPv6 (Mode). O IPv4 mostra quatro campos de octeto que avançam enquanto se digita, limitam um valor acima de 255 e preenchem os campos vazios com 0 quando o foco sai; o IPv6 é um campo de texto validado e gravado na forma canônica da RFC 5952 quando o foco sai. Address, Octets, IsValid, Required com a moldura de erro do tema, ReadOnly, Clear e OnChange. Colar um endereço completo, da direita para a esquerda e um edit com o padrão Value para leitores de tela. Address tem vínculo bidirecional no WPF e no Avalonia. | Ajuda | |
| Edit de duração | TsgcVCLTimeSpanEdit e TsgcFMXTimeSpanEdit (TsgcWinFormsTimeSpanEdit, TsgcWpfTimeSpanEdit e TsgcAvaloniaTimeSpanEdit no .NET) editam uma duração em segmentos de dias a milissegundos (Segments), como relógio ou com unidades (DisplayFormat). Value em milissegundos (um TimeSpan no .NET), MinValue, MaxValue, AllowNegative, Increment, ShowButtons para os botões de incremento e ReadOnly. Digitar, seta para cima e para baixo, Page Up e Page Down, a roda e os botões de incremento alteram o segmento com foco com transbordo para o seguinte. Um spinner com o padrão RangeValue para leitores de tela. Value tem vínculo bidirecional no WPF e no Avalonia. | Ajuda | |
| Seletor de fonte | TsgcVCLFontPicker e TsgcFMXFontPicker (TsgcWinFormsFontPicker, TsgcWpfFontPicker e TsgcAvaloniaFontPicker no .NET) escolhem uma família de fonte em uma lista suspensa que desenha cada nome na sua própria fonte (ShowPreview, PreviewText), filtrada enquanto se digita. FontName, Fonts preenchida pela plataforma até o aplicativo preenchê-la, RefreshFonts, as famílias escolhidas recentemente primeiro (RecentCount, RecentFonts) e um filtro de largura fixa (FontFilter). As fontes da visualização do Delphi são desenhadas no Windows. FontName tem vínculo bidirecional no WPF e no Avalonia. | Ajuda | |
| Lista com caixas de seleção | TsgcVCLCheckListBox e TsgcFMXCheckListBox (TsgcWinFormsCheckListBox, TsgcWpfCheckListBox e TsgcAvaloniaCheckListBox no .NET) listam Items com uma caixa de seleção por linha: Checked, State com um estado acinzentado (AllowGrayed) e ItemEnabled por item. Uma linha Selecionar tudo de três estados (ShowCheckAll), uma caixa de filtro que nunca altera um estado (ShowFilter), CheckAll, UncheckAll, CheckedCount e OnClickCheck antes de OnChange. Apenas as linhas visíveis são desenhadas, de modo que 10000 itens continuam rápidos. Espaço, Ctrl+A, digitar uma letra para saltar e itens de lista com o padrão Toggle para leitores de tela. | Ajuda | |
| Lista dupla | TsgcVCLDualListBox e TsgcFMXDualListBox (TsgcWinFormsDualListBox, TsgcWpfDualListBox e TsgcAvaloniaDualListBox no .NET) movem itens entre AvailableItems e SelectedItems com os botões entre as listas, com um clique duplo ou arrastando e soltando, e reordenam SelectedItems com Subir e Descer (ShowReorderButtons). SortAvailable, ShowFilter, ShowCaptions, ReadOnly, os métodos MoveToSelected, MoveAllToSelected, MoveToAvailable, MoveAllToAvailable, MoveUp e MoveDown, OnMoving para manter um item e um OnChange por operação. Seleção múltipla, movimentos pelo teclado e da direita para a esquerda. SelectedItems tem vínculo bidirecional no WPF e no Avalonia. | Ajuda | |
| NumPad para painéis touch | O TsgcVCLNumPad é um teclado numérico na tela fixado no formulário, e o TsgcVCLNumPadPopup abre o mesmo pad em uma lista suspensa sob o seu destino (TsgcFMXNumPad e TsgcFMXNumPadPopup no FireMonkey, e um NumPad no .NET). Ele digita no spin edit, no edit de moeda, nos gauges de botão giratório e de controle deslizante do sgcGauges e em um edit padrão, definido com Associate ou tomado do controle com foco. O pad lê a faixa e as casas decimais do destino e grava o valor como uma alteração do usuário, com teclas grandes o bastante para um dedo ou uma luva. | Ajuda | |
| Teclado na tela | O TsgcVCLKeyboard é um teclado completo na tela fixado no formulário, e o TsgcVCLKeyboardPopup o abre em uma lista suspensa sob o edit que recebe o foco, com AutoPopup, AutoPopupAll, PopupPosition e CloseOnEnter (TsgcFMXKeyboard e TsgcFMXKeyboardPopup no FireMonkey, e TsgcWinFormsKeyboard, TsgcWpfKeyboard e TsgcAvaloniaKeyboard com suas listas suspensas no .NET). Ele digita no controle que tem o foco ou em Associate e nunca toma o foco. Páginas de letras, de símbolos e numérica, Shift, Caps Lock, AltGr e teclas mortas, dez layouts integrados (en-US, en-GB, es-ES, fr-FR, de-DE, it-IT, pt-BR, nl-NL, pl-PL e tr-TR), layouts próprios com sgcKeyboardRegisterLayout, uma tecla de layout que percorre Layouts, temas, direita para a esquerda e acessibilidade. O OnKeyText altera ou cancela o texto digitado e o OnEnterKey roda depois do Enter. | Ajuda | |
| Controle de layout | TsgcVCLLayoutControl e TsgcFMXLayoutControl (no .NET TsgcWinFormsLayoutControl, TsgcWpfLayoutControl e TsgcAvaloniaLayoutControl) organizam qualquer controle, do sgcEditors e padrão, em grupos, grupos com abas e colunas, com os rótulos alinhados a uma só largura, divisores que o usuário pode arrastar, itens que o usuário pode ocultar e layouts da direita para a esquerda. Os leitores de tela veem os grupos e as abas. Em todas as edições; o Delphi Community não tem pacote de design para o sgcEditors, então nele o controle de layout é criado em código. | Ajuda |
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Editores data-aware | Seletor de data, seletor de hora, spin edit, avaliação, controle deslizante de intervalo, edit com botões, edit com máscara, edit de moeda, memo e edit de lookup se vinculam a DataSource e DataField; o controle deslizante de intervalo também se vincula a EndDataField, e o edit de lookup preenche a sua lista a partir de um segundo dataset por ListSource, KeyField e ListField. Campos nulos aparecem vazios. Delphi e C++ Builder. | Registrada | Ajuda |
| Data binding do WinForms | Os seletores de data e hora, o spin edit, a avaliação, o controle deslizante de intervalo e os edits com botões, com máscara, de moeda, de lookup e o memo do WinForms vinculam um campo por DataSource, DataMember e DataField: um BindingSource, um DataTable, um DataView ou uma List. | Registrada | Ajuda |
| Listas de lookup a partir de qualquer coleção | ItemsSource, DisplayMember e ValueMember preenchem o edit de lookup no WinForms, WPF e Avalonia; SelectedValue e SelectedItem devolvem os objetos tipados. | Ajuda | |
| Validação | O validador do sgcUICore verifica os controles do sgcEditors e os padrão contra regras de obrigatório, intervalo, tamanho, expressão regular, e-mail, comparação e personalizadas, com uma moldura, um ícone, uma lista de resumo e mensagens acessíveis, no VCL, FireMonkey, WinForms, WPF e Avalonia. No .NET ele também mostra os erros de IDataErrorInfo e INotifyDataErrorInfo. | Ajuda | |
| Smart Paste | O calendário mensal, os seletores de data, hora e data e hora, o spin edit, a avaliação, o editor de token, o seletor de cor, os edits com botões, com máscara, de moeda e de lookup e o memo participam do Smart Paste. TsgcVCLSmartPaste e TsgcFMXSmartPaste (no .NET TsgcWinFormsSmartPaste, TsgcWpfSmartPaste e TsgcAvaloniaSmartPaste) transformam um texto colado, como um e-mail ou um bloco de endereço, em valores para os controles de um formulário, tanto do sgcEditors quanto edits, combos, caixas de seleção e controles de data padrão, com Desfazer e um botão Smart Paste. Só o texto colado e as descrições dos campos são enviados ao provedor de IA, e sem provedor um parser local lê linhas como Nome: valor. | Ajuda | |
| Gerador de formulário de dados | TsgcVCLDataForm e TsgcFMXDataForm montam um formulário de edição completo sobre o controle de layout a partir de um TDataSet, com um controle do sgcEditors por campo escolhido pelo seu tipo, ou a partir das propriedades published de uma classe por RTTI com BindObject. No .NET, TsgcWinFormsDataForm, TsgcWpfDataForm e TsgcAvaloniaDataForm aceitam um DataTable, um DataView, uma lista ou um único objeto. Fields define o título, o tipo, o grupo, a aba e a ordem de cada campo, e um navegador acrescenta primeiro, anterior, próximo, último, novo, editar, excluir, gravar e cancelar. Delphi, C++ Builder e .NET. | Registrada | Ajuda |
| Validação do formulário de dados | Cada campo vira regras do validador do sgcUICore: obrigatório, intervalo, tamanho, expressão regular e e-mail, além de OnValidateField para as suas próprias verificações. O Post valida o registro primeiro, um resumo lista os erros, e um campo inválido em uma aba que não está visível seleciona essa aba. | Registrada | Ajuda |
| Smart Paste do formulário de dados | SmartPaste, SmartPasteAsync e SmartPasteFromClipboard, também um botão do navegador, preenchem todos os campos do registro a partir de um texto colado, pela camada de IA que os editores usam no seu próprio Smart Paste. Os campos que ele preencheu mostram um selo de IA, e SmartPasteUndo devolve os valores antigos. Sem provedor, um parser local lê linhas como Nome: valor. | Registrada | Ajuda |
| Layouts salvos como JSON | SaveLayout e LoadLayout guardam a ordem, o pai, os tamanhos e a visibilidade de cada item, a aba ativa de cada grupo com abas e os itens que o usuário ocultou, como JSON, em uma string, um stream ou um arquivo. Um layout salvo por uma versão mais antiga carrega em uma mais nova. | Ajuda |
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Entrada de texto real | Os campos de data, hora, número e hexadecimal são edições nativas, de modo que IME, área de transferência, desfazer e leitores de tela funcionam. | Ajuda | |
| Localização | Cada controle tem o seu próprio idioma: nomes de dias e meses, formatos, primeiro dia da semana e FormatSettings por controle. | Ajuda | |
| Teclado | F4 ou Alt+Seta para baixo para listas suspensas, setas e PageUp e PageDown no calendário, roda do mouse e repetição automática no spin edit, um atalho para cada botão do edit, anel de foco. | Ajuda | |
| DPI por monitor | Layout em pixels lógicos a 96 DPI, dimensionado por monitor, com a lista suspensa desenhada no DPI do seu monitor. | Ajuda | |
| Da direita para a esquerda (árabe e hebraico) | Os botões de incremento, de lista suspensa e de limpar passam para o outro lado, e a direção do slider e da avaliação, a ordem dos dias da semana no calendário, as setas e o fluxo de tokens ficam espelhados, e o campo de edição interno recebe a mesma direção. | Ajuda | |
| Leitores de tela e alto contraste | Todo editor expõe o seu papel, nome e valor à UI Automation, junto com as partes dos editores compostos (partes da data, tokens, estrelas da avaliação, cor, botões do edit, a lista do lookup) e as suas janelas pop-up enquanto estão abertas, e um campo inválido informa o seu estado e a sua mensagem de erro. O anel de foco está sempre visível e o alto contraste do Windows é respeitado. Ativado por padrão no VCL (Delphi 7 a 13), no FireMonkey no Windows, no WinForms, no WPF e no Avalonia. | Ajuda |
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Temas | Temas claro e escuro com uma única propriedade, além de AccentColor, TextStyle e uma cor de erro para a validação. | Ajuda | |
| Renderização headless | SaveToPNG e SaveToSVG em todos os controles e nos modelos headless, também no Linux64. Os edits com botões, de pesquisa, com máscara, de moeda e de lookup e o memo mantêm o texto do valor em PNG, SVG e nas páginas impressas ou em pré-visualização. | Ajuda |
| Tarefa | Controles Delphi padrão | sgcEditors |
|---|---|---|
| Escolha uma data ou um horário em uma lista suspensa | TDateTimePicker | TsgcVCLDatePicker, TsgcVCLTimePicker |
| Data e hora em um só controle | TDateTimePicker | TsgcVCLDateTimePicker |
| Selecione um intervalo de dias com um comprimento máximo | TMonthCalendar | esmRange, MaxRangeDays |
| Bloqueie datas isoladas e dias da semana | TMonthCalendar | DisabledDates, DisabledWeekDays, OnIsDateDisabled |
| Um locale por controle | TDateTimePicker | FormatSettings |
| Entrada com máscara na sintaxe Delphi ou .NET | TMaskEdit | TsgcVCLMaskEdit, MaskSyntax |
| Escolha uma linha de uma lista de várias colunas | TDBLookupComboBox | TsgcVCLLookupEdit, TsgcVCLDBLookupEdit |
| Um edit com botões | TButtonedEdit | TsgcVCLButtonEdit |
| Digite um número em um painel touch | TTouchKeyboard | TsgcVCLNumPad, TsgcVCLNumPadPopup |
| Digite texto em uma tela touch | TTouchKeyboard | TsgcVCLKeyboard, TsgcVCLKeyboardPopup |
| Um interruptor liga/desliga para configurações | TToggleSwitch | TsgcVCLToggleSwitch |
| Editar um endereço IPv4 ou IPv6 | TMaskEdit | TsgcVCLIPAddressEdit |
| Digitar uma duração como um timeout | TSpinEdit | TsgcVCLTimeSpanEdit |
| Escolher uma família de fonte com visualização | TComboBox com Screen.Fonts, TFontDialog | TsgcVCLFontPicker |
| Uma lista de opções com caixas de seleção | TCheckListBox | TsgcVCLCheckListBox |
| Mover itens entre duas listas | Dois controles TListBox e botões | TsgcVCLDualListBox |
Apenas capacidades, conforme documentado na ajuda. Sem alegações de desempenho.
Os editores .NET são um port em C# com os mesmos nomes e eventos, para WinForms, WPF e Avalonia. No WPF as propriedades de valor são propriedades de dependência que se vinculam nos dois sentidos. O edit de lookup aceita ItemsSource, DisplayMember e ValueMember em todos os hosts, e na edição Registrada os editores WinForms vinculam um campo por DataSource, DataMember e DataField.
| Pacote | Edição | Conteúdo |
|---|---|---|
esegece.sgcEditors.Community | Community (gratuita) | Biblioteca principal |
esegece.sgcEditors.WinForms.Community | Community (gratuita) | Controles Windows Forms |
esegece.sgcEditors.Wpf.Community | Community (gratuita) | Controles WPF |
esegece.sgcEditors.Avalonia.Community | Community (gratuita) | Controles Avalonia |
esegece.sgcEditors.Rendering.Community | Community (gratuita) | Renderização headless |
esegece.sgcEditors | Registrada | Biblioteca principal |
esegece.sgcEditors.WinForms | Registrada | Controles Windows Forms |
esegece.sgcEditors.Wpf | Registrada | Controles WPF |
esegece.sgcEditors.Avalonia | Registrada | Controles Avalonia |
esegece.sgcEditors.Rendering | Registrada | Renderização headless |
Todos os recursos do sgcEditors estão documentados na ajuda do sgcUI, com uma versão para cada ambiente de desenvolvimento.
Comece pela introdução do sgcEditors e siga com o início rápido e os tópicos de recursos.
Delphi →A ajuda completa do sgcUI em PDF, para ler offline ou imprimir.
Delphi (PDF) →