Este é o site histórico da documentação 4D. As documentações estão sendo movidas progressivamente para developer.4d.com

Página Inicial

 
4D v19
Formulários Dinâmicos

Formulários Dinâmicos  


 

Formulários Dinâmicos são formulários cujas estruturas se definem em um arquivo .json ou em um objeto 4D. São regenerados cada vez que se executam e oferecem um nível superior de flexibilidade. Algumas vantagens notáveis incluem:

  • Usabilidade
    • atualizações simples
    • modificações dinâmicas do usuário
    • fácil reutilização
    • pesquisa mais rápida
  • Portabilidade
    • intercâmbio simplificado
    • pode ser armazenado em controle de fonte

Cada objeto definido em um formulário dinâmico, incluido o formulário em si, tem uma ou mais propriedades. Consulte Diretório de Página para ver rapidamente suas descrições.

O exemplo abaixo é um arquivo JSON simples ("HW.json", armazenado na pasta Resources) com texto, uma imagem e um botão:

{
    "windowTitle": "Hello World",
    "windowMinWidth": 220,
    "windowMinHeight": 80,
    "method": "HWexample",
    "pages": [
        null,
        {
            "objects": {
                "text": {
                "type": "text",
                "text": "Hello World!",
                "textAlign": "center",
                "left": 50,
                "top": 120,
                "width": 120,
                "height": 80
                },
                "image": {
                "type": "picture",
                "pictureFormat": "scaled",
                "picture": "/RESOURCES/Images/HW.png",
                "alignment":"center", 
                "left": 70,
                "top": 20, 
                "width":75, 
                "height":75        
                },
                "button": {
                "type": "button",
                "text": "OK",
                "action": "Cancel",
                "left": 60,
                "top": 160,
                "width": 100,
                "height": 20
                }
            }
        }
    ]
}

Este formulário pode ser carregado em um diálogo com o código 4D abaixo:

 Open form window("/RESOURCES/HW.json")
 DIALOG("/RESOURCES/HW.json")

O que exibe o formulário:

Quando criar formulários a partir de arquivos, eles devem:

  •   ser adequados com o schema  JSON . O formulário 4D JSON schema pode ser encontrado na pasta em: Resources/formsSchema.json. É sua responsabilidade verificar a validade do formato de arquivo .json. Veja o comando JSON Validate.
  • estar em arquivos com a extensão de arquivo ".json" .
  • ser armazenados dentro do pacote da aplicação, relativo ao arquivo de estrutura.

Notas:

  • Comentários dentro de arquivos .json devem ser contidos dentro da propriedades "comments". Caracteres de código comuns para comentários (ou seja., "//", "/*", "'", etc.) vão tornar o arquivo inválido.
  • Arrays em JSON atuam como coleções em 4D.

Todas as rotas de arquivos podem ser relativas ou absolutas. Devem utilizar '/' como delimitador de rota e são resolvidas da maneira abaixo:

  • Uma rota relativa não deve começar por '/'. Se resolve relativamente ao documento JSON onde foi encontrado a sstring de rota,
  • Uma rota absoluta começa com '/'. Por razões de segurança, só é aceita "/RESOURCES" como rota absoluta e se designa a pasta de recursos do banco de dados atual. Por exemplo, "/RESOURCES/templates/myfile.json" aponta ao arquivo "myfile.json" localizado na pasta de recursos do banco de dados atual.

 

Notas:

  • A resolução do nome é sensível a maiúsculas e minúsculas
  • 4D não resolve uma rota a um arquivo .json localizado na rede (a partir de "http/https").
  • Se a rota for incorreta ou o arquivo não for válido pelo esquema JSON, se gerará um erro.         

Formulários dinâmicos podem conter ponteiros JSON. Ponteiros JSON são automaticamente resolvidos quando chamar um comando 4D que aceite um formulário dinâmico como parâmetro (rota de arquivo .json ou objeto 4D):

Para saber mais sobre ponteiros JSON, veja a seção Definir Ponteiros JSON.

As propriedades listadas nesta seção são aquellas que oferecem o banco de dados e a estrutura de um formulário.

PropriedadeTipoDescriçãoPossíveis ValoresObjetos suportados
inheritedFormstringDesigna o formulário para herdar.Nome (string) da tabela ou formulário de projeto OU uma rota POSIX (string) para um arquivo .json descrevendo o formulário OU um objeto descrevendo o formulárioform
inheritedFormTabletableDesigna a tabele um formulário herdado vai usar.Um nome de tabela ou númeroform
memorizeGeometrybooleanSalva os parâmetros de formulário quando a janela de formulário estiver fechada. Ver Memorização da geometria das janelasTRUE / FALSEform
windowTitlestringUsado pelo comando Open form window para o título da janela.variesform
destinationcadenaForm type."detailScreen", "listScreen", "detailPrinter", "listPrinter"formulario
pagescolecciónColeção de páginas (cada página é um objeto)Objetos da páginaformulario
cssstring ou coleçãoArquivos CSS usados pelo formulárioRotas CSS fornecidas como uma string, coleção de strings, ou coleção de objetos com as propriedades  "path" e "media" formulário
entryOrdercolecciónColeção de nomes de objetos de formulário que definem a ordem de entrada (a ordem na qual os objetos de formulário são ressaltadas sequencialmente quando o usuário pressiona Tab ou Ctrl/Cmd+Tab. Esta propriedade só é criada quando for modificada a ordem de entrada predeterminada (baseada na orden de definição de objeto para a página).Nomes de objeto de formulárioPágina de formulário

 


Os marcadores especificam locals precisos na régua vertical do formulário. Usados principalmente em formulários de saída, controlam a informação listada e estabelecem áreas de cabeçalho, ruptura, detalhe e rodapé de um formulário.

PropriedadeTipoDescriçãoValores possíveisObjetos suportados
markerBodyinteiroA área entre a linha de controle 1 do cabeçalho do formulário e a linha de ruptura do formuláriomínimo: 0formulário
markerBreakinteiro/array inteiro Designa áreas para mostrar informação que não forma parte dos registros, ou linhas/elementos gráficos que concluem a visualização da tela. mínimo: 0formulário
markerFooterinteiroA área entre Form Break 1 line e a linha Form Footer minimum: 0formulário
markerHeaderenter/array enteroA área sobre a linha 1 do cabeçalho do formulário.mínimo inteiro: 0; mínimo array inteiro: 0formulário
Objetos  

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
memorizeValueboolean Salva o valor do objeto atual quando memorizeGeometry for ativado para o formulário atual.TRUE / FALSEinput, tab, checkbox, radio, popup, splitter, list box 
namestring O nome do objeto formulário. (Opcional para o formulário)Qualquer nome que não pertence a um objeto que já existaform, list box column, list box header, list box footer
textstring O título do objeto formuláriovariestext, groupBox, button, checkbox, radio, list box header
typestringMandatório. Designa o tipo de dados do objeto formulário."text", "rectangle", "groupBox", "tab", "line", "button", "checkbox", "radio", "dropdown", "combo", "webArea", "write", "subform", "plugin", "splitter", "buttonGrid", "progress", "ruler", "spinner", "stepper", "list", "pictureButton", "picturePopup", "listbox", "input" text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write pro, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input, view pro
variableCalculationstringPermite que cálculos matemáticos sejam feitos."none", "minimum", "maximum", "sum", "count", "average", "standardDeviation", "variance", "sumSquare"list box footer
displaybooleanoFalse para especificar um objeto invisível mas ativoTRUE / FALSEbotão, menu suspenso
classstringCSS name]Uma lista de palavras separadas por espaço usada como seletores de classe em arquivos csstexto, retângulo, groupBox, tab, linha, botão, checkbox, radio, dropdown, combo, webArea, Write Pro, subformulário, plugin, splitter, buttonGrid, progress, régua, spinner (Barra de progresso assíncrona), stepper, lista, pictureButton, picturePopup, list box, input, View Pro

Um subformulario é um formulário incluído em outro formulário.


PropertyTypeDescriptionPossible ValuesObjects Supported
deletableInListbooleanSpecifies if the user can delete subrecords in a list subform.TRUE / FALSE  subform
detailFormstringName of an existing detail form. Name (string) of table or project form OR a POSIX path (string) to a .json file describing the form OR an object describing the formsubform, list box
doubleClickInEmptyAreaActionstringAction to perform in case of a double-click on an empty line of a subform."addSubrecord"subform
doubleClickInRowActionstringAction to perform in case of a double-click on a subform record."editSubrecord", "displaySubrecord"subform, list box
enterableInListbooleanSpecifies if the user can modify record data directly in the list, without having to use the associated detail formTRUE / FALSE  subform
listFormstringAn existing list subform where you can enter, view, and modify data in other tables.Name (string) of table or project form OR a POSIX path (string) to a .json file describing the form OR an object describing the formsubform
selectionModestringDesignates the options for allowing users to select records."multiple", "single", "none"subform, list box 

Ação  

Propriedades de ação oferecem instruções para atividades a serem realizadas.

Eventos  

Para chamar um evento, digite o nome do evento ou valor na propriedade "events" em camel case (palavras escritas sem espaço e iniciadas com maiúsculas), entre colchetes, entre aspas, e com a primeira letra da primeira palavra em minúsculas (example, "events": ["onLoad"] ou [1]).


PropriedadeTipoDescriçãoValores possíveisObjetos compatíveis
eventsArray de String ou número arrayOs eventos a escutar para ativar a ação.onActivate, onAfterEdit, onAfterKeystroke, onAfterSort, onAlternateClick, onBeforeDataEntry, onBeforeKeystroke, onBeginDragOver, onBeginURLLoading, onBoundVariableChange, onClick, onCloseBox, onCloseDetail, onCollapse, onColumnMove, onColumnResize, onDataChange, onDeactivate, onDeleteAction, onDisplayDetail, onDoubleClick, onDragOver, onDrop, onEndURLLoading, onExpand, onFooterClick, onGettingFocus, onHeader, onHeaderClick, onLoad, onLoadRecord, onLongClick, onLosingFocus, onMenuSelect, onMouseEnter, onMouseLeave, onMouseMove, onMouseUp, onOpenDetail, onOpenExternalLink, onOutsideCall, onPagechange, onPluginArea, onPrintingBreak, onPrintingDetail, onPrintingFooter, onResize, onRowMove, onScroll, onSelectionChange, onTimer, onUnload, onURLFiltering, onURLLoadingError, onURLResourceLoading, onValidate, onVPReady, onWindowOpeningDeniedtab, input, button, checkbox, radio, dropDown, combo, web area, write, subform, plugin, splitter, buttonGrid, progress, ruler spinner, stepper, list, pictureButton, picturePopup, list box, list box column
Ação  

Propriedade#tab/]TipoDescriçãoPossíveis ValoresObjetos Compatíveis
actionstringAtividades típicas a serem realizadas.O nome da ação padrão válida. Ver Ações padrões.button, checkbox, radio, pictureButton, dropdown, picturePopup, buttonGrid, tab, list box
continuousExecutionbooleanDesigna se vai executar o método de um objeto enquanto o usuário estiver tracking o controle.TRUE / FALSEprogress, ruler, stepper
draggingstringAtiva a função dragging ."none", "custom", "automatic" (excluding list, list box)plugin, input, list, write, list box
droppingstringAtiva função dropping."none", "custom", "automatic" (excluding list, list box)plugin, input, list, write, list box
methodstringUm nome de método de projeto.O nome de um método de projeto existentetab, input, button, checkbox, radio, dropdown, combo, webarea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, form, listbox, view, listbox column
movableRowsbooleanAutoriza o movimento de filas durante execução.TRUE / FALSElist box
sortablebooleanPermite a ordenação de dados de coluna ao clicar no cabeçalho. TRUE / FALSElist box

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Suportados
borderRadiusinteger[#tab/O valor radius para retângulos arredondados.minimum:0rectangle
bottomintegerPosiciona um objeto no fundo (centrado).minimum: 0text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
heightintegerDesigna o tamanho vertical do objectominimum: 0text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
leftintegerPosiciona um objeto à esquerda.minimum: 0text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
maxWidthintegerDesigna o maior tamanho permitido para as colunas list boxes.minimum: 0list box columns
minWidthintegerDesigna o menor tamanho permitido para as colunas list box.minimum: 0list box columns
rightintegerPosiciona um objeto à direita.minimum: 0text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
rowHeightstringestabelece a altura das filas de box rows.css value unit "em" or "px" (default)list box
rowHeightAutobooleanAtiva ou desativa redimensionamento automático para altura de fila de list box.TRUE / FALSElist box
rowHeightAutoMaxstringDesigna a maior altura permitida para filas de list box.css value unit "em" or "px" (default). minimum: 0list box
rowHeightAutoMinstringDesigna a altura mínima permitida para filas de list box.css value unit "em" or "px" (default). minimum: 0list box
rowHeightSourcevariesUm array define alturas diferentes para as filas em um list box.Nome de uma variável array 4D list box
startPointstringDesigna onde uma linha começa."topLeft", "bottomLeft"line
topintegerPosiciona um objeto no topo (centrado).minimum: 0text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
widthintegerDesigna um objeto tamanho horizontalminimum: 0form, text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Suportados
bottomMarginintegerValores Margem vertical  (em pixels).minimum: 0form
formSizeAnchorstringTamanho do formulário necessário para exibir todos os objetos.min length: 1Name of a 4D objectform
rightMarginenteroValor de margem horizontal (em píxels).mínimo: 0formulário
windowMaxHeightintegerDesigna a altura máxima permitida.minimum: 0form
windowMaxWidthintegerDesigna a largura máxima permitida.minimum: 0 form
windowMinHeightintegerDesigna a menor altura permitida.minimum: 0 form
windowMinWidthintegerDesigna a largura mínima permitida.minimum: 0 form
windowSizingXstringEspecifica se o usuário pode redimensionar o formulário verticalmente."fixed", "variable"form
windowSizingYstringEspecifia se o usuário pode redimensionar o formulário horizontalmente."fixed", "variable"form

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
resizablebooleanDesigna se o tamanho de um objeto pode ser modificado pelo usuário.TRUE / FALSElist box columns
sizingXstringEspecifica se o tamanho horizontal do objeto deve ser movido ou redimensionado  quando um usuário redimensionar o formulário."move","grow","fixed"form, text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
sizingYstringEspecifica se o tamanho vertical do objeto deve ser movido ou redimensionado quando um usuário redimensionar o formulário."move","grow","fixed"form, text, rectangle, groupBox, tab, line, button, checkbox, radio, dropdown, combo, webArea, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box, input
splitterModestringQuando um objeto splitter tiver essa propriedade, outros objetos à sua direita (splitter vertical) ou abaixo (splitter horizontal) são empurrados ao mesmo tempo que o splitter, sem parada. "resize", "move"splitter 

Valor  

PropriedadeTipoDescriçãoPossíveis valoresObjetos Compatíveis
automaticInsertionbooleanAtiva automaticamente a adição de um valor a uma lista armazenada em memória quando um usuário entrar um valor não encontrado na lista de escolhas associada com o objeto. TRUE / FALSEcombo, list box column
choiceListlistAssocia uma lista de escolhas com uma coluna de uma list box. variesinput, dropdown, combo, list box column
currentItemSourcestringO último item selecionado.Expressão Objetolist box
currentItemPositionSourcestringA posição do último item selecionado.Expressão Númerolist box
dataSourcestring, ou string array para coluna hierárquica listboxUma variável 4D , nome de campo ou uma expressão de linguagem arbitrariamente complexa.variestab, input, button, checkbox, radio, dropdown, combo, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box column, list box header, list box footer, list box, view
dataSourceTypeHintstringUsado como dica para digitar uma variável associada automática quando dataSource não for especificado ou para escolher a exibição apropriada para formato de propriedade (textFormat, numberFormat, timeFormat, dateFormat, pictureFormat, booleanFormat)."integer", "number", "boolean", "picture", "text", date", "time", "arrayText", "object", "undefined"tab, input, button, checkbox, radio, dropdown, combo, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner, stepper, list, list box, list box column, listbox footer
labelslistAssocia valores padrão ou uma lista de escolha com uma coluna ou uma list box.variestab
listlistLista associada a um objeto de formulário de lista hierárquica.varieslist
listboxTypestringDesignao comportamento (tipo)  listbox."array", "currentSelection", "namedSelection", "collection"(*)list box
selectionNamestringOs conteúdos da list box serão baseados na seleção especificada.seelction namelist box
saveAsstringEspecifica se o valor do item ou referência deve ser recuperado quando o item for selecionado em uma lista."value"; "reference"dropdown, list box column
tablestring/integerUsado para especificar a fonte de dados para um subformulário ou list box. Nomes de tabelas existentes (sem "[" "]" ou ID de tabela (integer minimum: 0)subform, list box
selectedItemsSourcestringOs itens de coleção selecionados.Expressão coleçãolist box
selectionNamestringOs conteúdos da list box serão baseados na seleção especificada.Nome de seleçãolist box
tablestring/integerUsado para especificar a data source para um subformulário ou list box. Nomes de tabela existentes (sem "[" "]" ou tabela ID (inteiro mínimo: 0)subformulário, list box

    (*) "coleção" atribui uma list box baseada em uma coleção ou uma seleção de entidades.

Display  

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
booleanFormatstringEspecifica apenas dois valores possíveis."TRUE"; "FALSE"input, list box column
controlTypestringEspecifica como o valor deve ser renderizado em uma célula list box."input", "checkbox" (for boolean / numeric columns), "automatic", "popup" (only for boolean columns)list box column
dateFormatstringControla a maneira em que as datas aparecem quando exibidas ou impressas. Devem ser selecionados entre os formatos  4D internos ."systemShort", "systemMedium", "systemLong", "iso8601", "rfc822", "short", "shortCentury", "abbreviated", "long", "blankIfNull" (podem ser combinados com os outros valores possíveis) input,  list box column, dropdown, combo, list box footer
numberFormatstringControla a maneira que os números aparecem quando exibidos ou impressos.Números (inclui um ponto decimal ou um sinal de menos se necessário)input, dropdown, combo, ruler, progress, list box column, list box footer
pictureFormatstring Controla como as imagens aparecem quando exibidas ou impressas. "truncatedTopLeft", "scaled", "truncatedCenter", "tiled" (pictures only), "proportionalTopLeft" (excluindo imagens), "proportionalCenter"(excluindo imagens)picture, input, list box, list box footer
textFormatstringControla a maneira que campos alfanuméricos e variáveis aparecem quando exibidos ou impressos."### ####", "(###) ### ####", "### ### ####", "### ## ####", "00000", custom formatsinput, combo, dropdown, list box column, list box footer
timeFormatstringControla a maneira que horas aparecem quando exibidos ou impressos. Devem ser selecionados apenas entre os formatos internos de  4D."systemShort", "systemMedium", "systemLong", "iso8601", "hh_mm_ss", "hh_mm", "hh_mm_am", "mm_ss", "HH_MM_SS", "HH_MM", "MM_SS", "blankIfNull" (podem ser combinados com outros valores possíveis) input, dropdown, list box column, list box footer
truncateModestringControla a exibição de valores quando colunas list boxs são muito estreitas para mostrar o conteúdo todo"withEllipsis"; "none"list box column, list box footer
visibilitystringPermite esconder o objeto no ambiente Aplicação."visible", "hidden", "selectedRows", "unselectedRows"common, list box column 
Entry  

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
contextMenustringOferece acesso ao usuário a um menu de contexto padrão na área selecionada."automatic", "none"input, webArea, Write, list box column
enterablebooleanAutoriza entrada.TRUE / FALSEinput, lis tbox column, list, stepper, ruler, progress, write
entryFilterstringAssocia um filtro de entrada com os objetos ou células de colunas. Essa propriedade não é acessível se a propriedade Enterable não for ativada.variesinput, combo, list, list box column
focusablebooleanAtiva o objeto para ter o foco (e pode ser ativado via teclado).TRUE / FALSEinput, button, checkbox, radio, dropdown, write, subform, plugin, ruler, list, list box
keyboardDialectstringAssocia um layout de teclado específico a um campo ou a um objeto enterable usando identificadores de linguagem RFC 3066 Bis.variesinput, write
multilinestringFaz com que se o texto for muito longo para ser exibido, ele será truncado (com ou sem retornos de linha)."automatic", "yes", "no"input
placeholderstringTexto a ser exibido (cinzento) quando o valor para dataSource é vazio.variesinput, combo
shortcutAccelbooleanEspecifica o sistema a usar,  Windows ou Mac.TRUE / FALSEcheckbox, radio, pictureButton
shortcutAltbooleanDesigna a tecla AltTRUE / FALSEcheckbox, radio, pictureButton
shortcutCommandbooleanDesigna a tecla Command (Mac)TRUE / FALSEcheckbox, radio, pictureButton
shortcutControlbooleanDesigna a tecla Control (Windows)TRUE / FALSEcheckbox, radio, pictureButton
shortcutKeystringA letra ou nome da tecla de significado especial."[F1]" -> "[F15]", "[Return]", "[Enter]", "[Backspace]", "[Tab]", "[Esc]", "[Del]", "[Home]", "[End]", "[Help]", "[Page up]", "[Page down]", "[left arrow]", "[right arrow]", "[up arrow]", "[down arrow]"checkbox, radio, pictureButton
shortcutShiftbooleanDesigna a tecla ShiftTRUE / FALSEcheckbox, radio, pictureButton
showSelectionbooleanMantém a seleção visível dentro do objeto depois de ter perdido o foco. TRUE / FALSEinput, write
singleClickEditbooleanAtiva a passagem direta ao modo editar.TRUE / FALSElist box
spellcheckbooleanEspecifica se a ortografia será automaticamente verificada ou não.TRUE / FALSEinput, write

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
excludedListlistPermite estabelecer uma lista cujos valores não podem ser digitados na coluna. Se um valor excluído for digitado, não é aceito e uma mensagem de erro é exibida. variesinput, combo, list box column
maxstring / number O valor máximo permitido. Para steppers numéricos, essas propriedades representam segundos quando o objeto for associado com um valor tipo hora e são ignorados quando for associado com um valor do tipo data.variesinput, progress, ruler, stepper
minstring / numberValor mínimo permitido. Para steppers numéricos, essas propriedades representam segundos quanod o objeto for associado com um valor tipo hora e são ignorados quando for associado com um valor tipo data.variesinput, progress, ruler, stepper
requiredListlistPermite estabelecer uma lista onde apenas esses valores podem ser inseridos. Quando uma lista exigida for definida, a entrada por teclado não é mais possível.variesinput, listbox column

Look  

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
defaultButtonbooleanSimilar ao botão padrão exceto que tem uma aparência modificada, com o objetivo de indicar a escolha recomendada ao usuário.TRUE / FALSEbutton
dpistringEstabelece a resolução de tela para os conteúdos da área 4D Write Pro area.0, 72, 96write
hideFocusRingbooleanDurante a execução, um campo ou qualquer objeto editável é destacado por um retângulo de seleção quando tiver o foco. Pode esconder esse retângulo com essa opção. TRUE / FALSEinput, write pro, subform, list, list box
hideSystemHighlightbooleanEsta propriedade é adicionada apenas para list boxes do tipo seleção. É usada para especificar registros ocultos na list box.TRUE / FALSElist box
labelsPlacementstringEspecifica o local do texto exibido de um objeto."none", "top", "bottom", "left", "right"tab, progress indicators, ruler
layoutModestringEstabelece o modo para exibir o documento  4D Write Pro na área de formulário.  "embedded, "draft", "page"write pro
scrollbarHorizontalstringUma ferramenta que permite ao usuário mover a área de exibição para a esquerda ou direita."visible", "hidden", "automatic"input, write, subform, list, listbox
scrollbarVerticalstringUma ferramenta que permite ao usuário mover a área de exibição para cima ou para baixo."visible", "hidden", "automatic"input, write pro, subform, list, listbox
showBackgroundbooleanExibe ou esconde as imagens de fundo e a cor de fundo (normalmente exibidas).TRUE / FALSEwrite pro
showHeadersbooleanAtiva ou desativa a visibilidade do documento ou cabeçalhos de colunas list box.TRUE / FALSEwrite pro, list box
showHiddenCharsbooleanExibe/oculta caracteres invisíveis (normalmente escondidos).TRUE / FALSEwrite pro
showHorizontalRulerbooleanExibe/oculta a régua (normalmente exibida). TRUE / FALSEwrite pro
showVerticalRulerbooleanoExibe/oculta a régua vertical (normalmente exibida).TRUE / FALSEWrite Pro
showHTMLWysiwygbooleanAtiva/desativa a visão HTML WYSIWYG , no qual qualquer atributos avançados 4D Write Pro que não sejam compatíveis com todos os browsers são removidos (normalmente desativado). TRUE / FALSEwrite pro
showFootersbooleanAtiva ou desativa a visibilidade do documento ou rodapés de colunas list box.TRUE / FALSEwrite pro, list box
showPageFramesbooleanExibe/oculta o frame da página quanod modo Page view estiver em "Page". Normalmente está escondido.TRUE / FALSEwrite pro
showReferencesbooleanExibe todas as expressões inseridas 4D no documento como referências.TRUE / FALSEwrite pro
userInterfacestringExibe/esconde a interface de usuário 4D View Pro."toolbar", "none" (valor padrão)View Pro
withFormulaBarbooleanExibe/esconde a barra de fórmula 4D View Pro.TRUE / FALSE (valor padrão)View Pro
zoomstring Estabelece a porcentagem de zoom para exibir os conteúdos de área 4D Write Pro. Normalmente é 100%.25, 50, 75, 100, 125, 150, 175, 200, 300, 400write Pro

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
alternateFillcolorPermite estabelecer uma cor de fundo diferente para filas/colunas ímpares na list box. any css value; "transparent"; "automatic"list box, list box column
borderStylestringPermite estabelecer um estilo padrão para as bordas do objeto. "system", "none", "solid", "dotted", "raised", "sunken", "double"text, input, web area, write, subform, plugin, splitter, buttonGrid, progress, ruler, spinner (barra de progresso assíncrona), stepper, list, pictureButton, picturePopup, list box
fillcolorDefine a cor de fundo de um objeto.any css value; "transparent"; "automatic"texto, retângulo, oval, input, list, list box
hideExtraBlankRowsbooleanDesativa a visibilidade de filas extras, vazias.TRUE / FALSElist box
rowFillSourcevariableO nome de um array ou expressão a aplicar uma cor de fundo personalizada para cada fila do list box. RGB color valueslist box, list box column
strokeDashArraynúmero array ou stringDefine valores para cada linha de um objeto. Ex. "6 1" ou [6,1]varieslinha, retângulo, oval
strokeWidthintegerDesigna a espessura da linha.inteiro ou 0 para largura mínima em formulário impressolinha, retângulo, oval

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Suportados
printFramestringManeja o modo de impressão para objetos cujo tamanho pode variar de um registro para outro dependendo dos conteúdos. "fixed", "fixedMultiple", "variable"subform, input, write

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
allowFontColorPickerbooleanPermite que o usuário modifique a fonte ou cor do objeto da sessão atual.TRUE / FALSEinput, list box
customBackgroundPicturepictureEstabelece a imagem que será desenhada no fundo do botão.sandboxed absolute or relative path. Must be used in conjunction with the style property with the "custom" option.button, checkbox, radio
customBorderXintegerEstabelece o tamanho (em pixels) da margem interna horizontal de um objeto. Deve ser usado com a propriedade estilo com a opção "custom".variesbutton, checkbox, radio
customBorderYintegerEstabelece o tamanho (em pixels) das margens verticais internas de um objeto. Deve ser usado com a propriedade estilo com a opção "custom".variesbutton, checkbox, radio
customOffsetintegerEstabelece um valor de offset - deslocamento personalizado em pixels. Deve ser usado com a propriedade style da opção "custom".variesbutton, checkbox, radio
fontFamilystringNome de fonte usada no objeto.variestext, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
fontSize integerTamanho de fonte em pontos.minimum: 0text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
fontStylestringFaz com que o texto selecionado fique levemente inclinado para a direita."normal", "italic"text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
fontThemestringAtribui um estilo para o texto do objeto."normal", "main", "additional"text, input
fontWeightstringFaz com que o texto selecionado pareça mais escuro e pesado."normal", "bold"text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
rowStrokeSourcestringNome de array ou expressão para manejar cores de linha.varieslist box, list box column
rowStyleSourcestringNome do array ou expressão para manejar estilos.varieslist box, list box column
storeDefaultStylebooleanArmazena as tags de estilo do texto. Deve ser usada com a propriedade multistyle.TRUE / FALSEinput
strokecolorCor de Fonte usada no objeto.any css value, "transparent", "automatic"text, rectangle, oval, input, button, checkbox, radio, list, list box, list box column, lis tbox header, list box footer
styledTextbooleanApplies custom styles to dynamic text areas (fields or variables) in the Application environment. TRUE / FALSEinput
textAlignstringLocal Horizontal do texto dentro da área que o contém."automatic", "right", "center", "justify", "left"text, groupBox, input, list box
textAnglestringModifica a orientação (rotação) da área de texto.0, 90, 180, 270 text, input
textDecorationstringEstabelece o texto selecionado para que tenha um alinha por debaixo dele."normal", "underline"text, groupBox, tab, input, button, checkbox, radio, dropdown, combo, progress, ruler, list, list box
verticalAlignstringLocal vertical do texto dentro da área que o contém."automatic", "top", "middle", "bottom"list box, list box columns, list box header, list box footer
wordwrapstringGerencia a exibição de conteúdos quando exceder a largura do objeto."automatic" (excluding list box), "normal", "none"input, list box column, list box footer

As propriedades listadas a seguir são especificas aos objetos designados

PropriedadeTipoDescriçãoPossíveis ValoresObjets Suportados
frameDelayintegerAtiva a circulação pelos conteúdos do botão imagem na velocidade especidifcada (em ticks). minimum: 0pictureButton
loopBackToFirstFramebooleanImagens são exibidas em um loop contínuo. TRUE / FALSEpictureButton
switchBackWhenReleasedbooleanExibe a primeira imagem o tempo todo exceto quando o usuário clica o botão. Exibe a segunda imagem até o botão do mouse ser liberado.TRUE / FALSEpictureButton
switchContinuouslybooleanPermite que o usuário mantenha pressionado o botão do mouse para exibir as imagens continuamente (iou seja, como uma animação). TRUE / FALSEpictureButton
switchWhenRolloverbooleanModifica os conteúdos do botão imagem quando o cursor do mouse passe sobre ele. A imagem inicial é exibida quando o cursor sai da área do botão. TRUE / FALSEpictureButton
useLastFrameAsDisabledbooleanDeixa a última thumbnail como uma para exibir quando o botão for desativado.TRUE / FALSEpictureButton

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Suportados
columnCountintegerEstabelece o número de colunas em uma tabela de miniaturas.minimum: 1buttonGrid, pictureButton, picturePopup
popupPlacementstringPermite exibir um símbolo que aparece como um triângulo no botão que indica que há um menu pop-up anexado. "none", "linked", "separated"button
radioGroupstringAtiva botões radio a serem usados em conjuntos coordenados: só um botão por vez pode ser selecionado no conjunto. Radio group nameradio
rowCountintegerEstabelece o número de filas em uma tabela de miniaturas thumbnails.minimum: 1buttonGrid, pictureButton, picturePopup
stylestringPermite estabelecer a aparência geral do botão. Ver Estilo de botão para mais informação."regular", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom"button, checkbox, radio
textPlacementstringPermite modificar o local relativo do título em relação ao objeto associado. Nenhum efeito se o objeto contém só um título (nenhuma imagem associada). "left", "right", "top", "bottom", "center"button, ckeckbox, radio
threeStatebooleanPermite um objeto check box para aceitar um terceiro estado.TRUE / FALSEcheckbox

PropriedadeTipoDescriçãoValores possíveisObjetos Suportados
graduationStepintegerMedida de display da Scale .variesindicadores de progresso, réguas
stepintegerIntervalo mínimo aceito entre valores durante uso. Para  numeric steppers, essa propriedade representa segundos quando o objeto for associado com um tipo tempo e dias quando for associado com um valor tipo data.variesindicadores de progresso, régua, stepper
showGraduationsbooleanExibe/Esconde a graduação ao lado das etiquetas.TRUE / FALSEindicador de progresso, régua
Ajuda  

  

PropriedadeTipoDescriçãoPossíveis valoresObjetos Suportados
tooltipstringOferece a usuários com informação adicional sobre um campo.variestab, input, button, checkbox, radio, dropdown, combo, splitter, buttonGrid, progress, ruler, spinner, stepper, list, pictureButton, picturePopup, list box header, list box footer 

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Suportados
columnscolumn array Contém os atributos para as colunas list box. varieslist box
highlightSetstringUsado para especificar o conjunto a ser usado para gerenciar registros destacados na list box (quando o Arrays data source for selecionado, um array Booleano com o mesmo nome que a list box usada).varieslist box
lockedColumnCountintegerNúmero de colunas que devem ser exibidas permanentemente na parte esquerda da  list box, mesmo quando o usuário passa através das colunas horizontalmente.minimum: 0list box
staticColumnCountintegerNúmero de colunas que não podem ser movidas durante a execução.minimum: 0list box

PropriedadesTipoDescriçãoPossiveis ValoresObjetos Suportados
horizontalLineStrokecolorDefine a cor das linhas horizontais em uma list box (normal é cinza). qualquer valor css , "'transparent", "automatic"list box
verticalLineStrokecolorDefine a cor das linhas verticais em uma box (normal é cinza).qualquer valor css, "'transparent", "automatic"list box

PropriedadesTipoDescriçãoPossíveis ValoresObjetos Suportados
footerobjectDesigna um objeto para estar no fundo e separado do corpo principal da list box.varieslist box column
footerHeightstringUsado para estabelecer uma altura de linha para um cabeçalho ou rodapé de list box. Pode estabelecer a unidade (linhas ou píxels) para o valor da altura.pattern ^(\\d+)(px|em)?$ (positive decimal + px/em )list box
headerobjectDesigna um objeto para estar no topo e separado do corpo principal da list box.varieslist box column
headerHeightstringUsado para estabelecer a altura de linha para um cabeçalo ou rodapé de  list box. Pode estabelecer as unidades (linhas ou pixels) para o valor altura.pattern ^(\\d+)(px|em)?$ (positive decimal + px/em )list box
showFootersboolean / objectUsado para exibir ou esconder os rodapés de coluna. Essa propriedade é boolena para list boxes e é um objeto para colunas list boxes.TRUE / FALSEwrite, list box
showHeadersbooleanUsado para exibir ou esconder cabeçalhos de coluna. Essa propriedade é boolena para list boxes e um objeto para colunas list box.TRUE / FALSEwrite, list box
Imagem  

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
iconpictureO nome, número ou  a rota da imagem.sandboxed rota absoluta ou relativalist box header, button, checkbox
iconFramesintegerEstabelece o número exato de estados presentes na imagem.minimo: 1button, checkbox, radio
iconPlacementstringDesigna a posição do ícone em relação ao objeto formulário."none", "left", "right"list box header
Plugin  

PropiedadTipoDescripciónValores posiblesObjetos soportados
pluginAreaKindstringDescreve o tipo de plug-in.varianplug-in 
customPropertiesstring/objetoPropriedades específicas de plug-in, passadas ao plugin como uma string JSON se é um objeto, ou como um búfer binário se for uma string codificada de base64varianplug-in

PropriedadeTipoDescriçãoPossíveis ValoresObjetos Compatíveis
methodsAccessibilitystringInstancia um objeto especial JavaScript ($4d) para gerenciar chamadas ao método 4D project. Deve ser usado com a propriedade webEngine ."all", "none"web area
progressSourcestringUm valor entre 0 e 100, representando a porcentagem de finalização da pagína tna Web area. Automaticamente atualiza por 4D, não pode ser modificada manualmente variesweb area
urlSourcestringDesigna a URL sendo carregada pela área Web associativa.variesweb area
webEnginestringUsado para escolher entre dois motores de renderização para a área Web, dependendo das especificidades da aplicação."embedded", "system"web area

Estas propriedades armazenam a informação de configuração de formulário.

PropriedadeTipoDescriçãoValores possíveisObjetos compatíveis
paperNamestringNome de formato de documento"A4", "US Letter"...formulário
paperWidthstringUtilizado se um documento chamado paperName não for encontrado. Requer um sufixo de unidade: pt, in, mm, cm.ex: "210mm"formulário
paperHeightstringUtilizado se um documento chamado paperName não for encontrado. Requer um sufixo de unidade: pt, in, mm, cm.ex: "297mm"formulário
orientationstringOrientação de documento"landscape" (normal é  "portrait")formulário
scalenúmero Porcentagem de escala de página (100 significa sem escala)minimo: 0formulário



Ver também 

Visão Geral

 
PROPRIEDADES 

Produto: 4D
Tema: Criar formulários

 
CONTEÚDO DA PÁGINA 
 
HISTÓRIA 

Criado por: 4D v16 R6

 
ARTICLE USAGE

Manual de Desenho 4D ( 4D v19)