Lista de propriedades JSON de objetos de formulário
Nesta página, encontrará uma lista completa de todas as propriedades de objectos ordenadas pelo seu nome JSON. Clique no nome de uma propriedade para aceder à sua descrição detalhada.
No capítulo "Propriedades do objeto de formulário", as propriedades são ordenadas de acordo com os nomes e temas da lista de propriedades.
a - b - c - d - e - f - g - h - i - k - l - m - n - p - r - s - t - u - v - w - z
| Propriedade | Descrição | Valores possíveis |
|---|---|---|
| a | ||
action | Ação típica a ser executada. | O nome de uma ação standard válida. |
allowFontColorPicker | Permite a exibição do seletor de fontes do sistema ou do seletor de cores para editar os atributos dos objetos | true, false (padrão) |
alternateFill | Permite definir uma cor de fundo diferente para linhas/colunas ímpares em uma caixa de listagem. | Qualquer valor CSS; "transparent"; "automatic"; "automaticAlternate" |
automaticInsertion | Habilita a adição automática de um valor a uma lista quando o usuário insere um valor que não está na lista de escolha associada ao objeto. | true, false |
| b | ||
booleanFormat | Especifica apenas dois valores possíveis. | true, false |
borderRadius | O valor do raio para rectângulos redondos. | mínimo: 0 |
borderStyle | Permite definir um estilo padrão para o contorno do objeto. | "system", "none", "solid", "dotted", "raised", "sunken", "double" |
bottom | Posiciona um objeto na parte inferior (centrado). | mínimo: 0 |
| c | ||
choiceList | Uma lista de escolhas associadas a um objeto | Uma lista de escolhas |
class | Uma lista de palavras separadas por espaços utilizadas como selectores de classe em ficheiros css. | Uma lista de nomes de classes |
columnCount | Número de colunas. | mínimo: 1 |
columns | Um conjunto de colunas list box | Coleção de objetos coluna com as propriedades de colunas definidas |
contextMenu | Dá ao usuário acesso a um menu contextual padrão na área selecionada. | "automatic", "none" |
continuousExecution | Designa se deve ou não ser executado o método de um objeto enquanto o usuário segue o controlo. | true, false |
controlType | Especifica como o valor deve ser apresentado numa célula do list box. | "automatic" ou "checkbox" para colunas numéricas, "popup" ou "checkbox" para colunas booleanas |
currentItemSource | O último item selecionado num list box. | Expressão de objecto |
currentItemPositionSource | A posição do último item selecionado num list box. | Expressão numérica |
customBackgroundPicture | Define a imagem que será desenhada no fundo, de um botão. | Caminho relativo na sintaxe POSIX. Deve ser utilizado em conjunto com a opção "Personalizado" da propriedade "Style". |
customBorderX | Define o tamanho (em píxeis) das margens horizontais internas de um objeto. Deve ser utilizado com a opção "Personalizado" da propriedade "Style". | mínimo: 0 |
customBorderY | Define o tamanho (em píxeis) das margens verticais internas de um objeto. Deve ser utilizado com a opção "Personalizado" da propriedade "Style". | mínimo: 0 |
customOffset | Define um valor de desvio personalizado em pixéis. Deve ser utilizado com a opção "Personalizado" da propriedade "Style". | mínimo: 0 |
customProperties | Propriedades avançadas (se existirem) | Cadeia JSON ou cadeia codificada em base64 |
| d | ||
| dataSource (objects) dataSource (subforms) dataSource (array list box) dataSource (Collection or entity selection list box) dataSource (list box column) dataSource (hierarchical list box) | Especifica a fonte dos dados. | Uma variável 4D, nome de campo ou uma expressão de linguagem complexa arbitrária. |
| dataSourceTypeHint (objects) dataSourceTypeHint (list box column, drop-down list) | Indica o tipo de variável. | "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined" |
dateFormat | Controla como as datas aparecem quando são apresentadas ou impressas. | Formatos incorporados: ("systemShort", "systemMedium", "systemLong", "iso8601", "rfc822", "short", "shortCentury", "abbreviated", "long", " blankIfNull") |
defaultButton | Modifica o aspeto de um botão para indicar ao usuário a escolha recomendada. | true, false |
defaultValue | Define um valor ou um carimbo a ser introduzido por defeito num objeto de entrada | Cadeia ou "#D", "#H", "#N" |
deletableInList | Especifica se o utilizador pode eliminar sub-registos num subformulário lista | true, false |
| detailForm (list box) detailForm (subform) | Associa um formulário detalhado a um subformulário listado. | Nome (string) da tabela ou formulário projeto, um caminho POSIX (string) para um arquivo .json descrevendo o formulário, ou um objeto descrevendo o formulário |
display | O objeto é desenhado ou não no formulário. | true, false |
displayFormulaAsSymbol | Exibe o texto fonte das fórmulas como símbolos. | true, false |
doubleClickInEmptyAreaAction | Ação a ser executada no caso de um clique duplo em uma linha vazia de um subformulário lista. | "addSubrecord" ou "" para não fazer nada |
| doubleClickInRowAction (list box) doubleClickInRowAction (subform) | Ação a executar no caso de um duplo clique num registo. | "editSubrecord", "displaySubrecord" |
dpi | Resolução do ecrã para o conteúdo da área 4D Write Pro. | 0=automatic, 72, 96 |
dragging | Ativa a função de arrastamento. | "none", "custom", "automatic" (exceto lista, list box) |
dropping | Habilita a função de soltar. | "none", "custom", "automatic" (exceto lista, list box) |
| e | ||
enterable | Indica se os usuários podem introduzir valores no objeto. | true, false |
enterableInList | Indica se os usuários podem modificar os dados do registo diretamente no subformulário lista. | true, false |
entryFilter | Associa um filtro de entrada ao objeto ou às células da coluna. Essa propriedade não estará acessível se a propriedade Enterable não estiver ativada. | Texto para restringir entradas |
events | Lista de todos os eventos selecionados para o objeto ou formulário | Coleção de nomes de eventos, por exemplo, ["onClick", "onDataChange"...]. |
excludedList | Permite definir uma lista cujos valores não podem ser introduzidos na coluna. | Uma lista de valores a excluir. |
| f | ||
fill | Define a cor de fundo de um objeto. | Qualquer valor CSS, "transparent", "automatic" |
focusable | Indica se o objeto pode ter o foco (e, pode ser ativado pelo teclado, por exemplo) | true, false |
fontFamily | Especifica o nome da família de fontes utilizada no objeto. | Nome da família de fontes CSS |
fontSize | Define o tamanho do tipo de letra em pontos quando não está selecionado nenhum tema de tipo de letra | mínimo: 0 |
fontStyle | Define o texto selecionado como ligeiramente inclinado para a direita. | "normal", "italic" |
fontTheme | Define o estilo automático | "normal", "main", "additional" |
fontWeight | Define o texto selecionado para aparecer mais escuro e mais pesado. | "normal", "bold" |
footerHeight | Utilizado para definir a altura da linha | positive decimal + px | em |
frameDelay | Enables cycling through the contents of the picture button at the specified speed (in seconds). | mínimo: 0 |
| g | ||
graduationStep | Medição do visor da escala. | mínimo: 0 |
| h | ||
header | Define o cabeçalho de uma coluna list box | Objeto com as propriedades "text", "name", "icon", "dataSource", "fontWeight", "fontStyle", "tooltip" |
headerHeight | Utilizado para definir a altura da linha | positive decimal + px | em |
height | Designa o tamanho vertical de um objeto | mínimo: 0 |
hideExtraBlankRows | Desactiva a visibilidade de linhas extra e vazias. | true, false |
hideFocusRing | Oculta o retângulo de seleção quando o objeto tem o foco. | true, false |
hideSystemHighlight | Utilizado para especificar a ocultação dos registos destacados no list box. | true, false |
highlightSet | Nome do conjunto. | string |
horizontalLineStroke | Define a cor das linhas horizontais num list box (cinzento por predefinição). | Qualquer valor CSS, "transparent", "automatic" |
| i | ||
icon | O nome do caminho da imagem utilizada para botões, caixas de verificação, botões rádio e cabeçalhos de list box. | Caminho relativo ou filesystem na sintaxe POSIX. |
iconFrames | Define o número exato de estados presentes na imagem. | mínimo: 1 |
iconPlacement | Designa a colocação de um ícone em relação ao objeto formulário. | "none", "left", "right" |
imageHugsTitle | Define se o título e a imagem do botão devem ser visualmente adjacentes. | true (padrão), false |
| k | ||
keyboardDialect | Para associar um esquema de teclado específico a uma entrada. | Uma cadeia de códigos de teclado, por exemplo, "ar-ma" |
| l | ||
labels | Uma lista de valores a utilizar como etiquetas de controlo de pestanas | ex: "a", "b, "c", ... |
| labelsPlacement (objects) labelsPlacement (tab control) | Especifica a localização do texto de um objeto. | "none", "top", "bottom", "left", "right" |
layoutMode | Modo de exibição do documento 4D Write Pro na área do formulário. | "page", "draft", "embedded" |
left | Posiciona um objeto à esquerda. | mínimo: 0 |
| list, see choiceList | Uma lista de escolhas associada a uma lista hierárquica | Uma lista de escolhas |
listboxType | A fonte de dados do list box. | "array", "currentSelection", "namedSelection", "collection" |
listForm | Formulário lista a utilizar no subformulário. | Nome (string) da tabela ou formulário projeto, um caminho POSIX (string) para um arquivo .json descrevendo o formulário, ou um objeto descrevendo o formulário |
lockedColumnCount | Número de colunas que devem ser permanentemente apresentadas na parte esquerda de um list box. | mínimo: 0 |
loopBackToFirstFrame | As imagens são apresentadas num ciclo contínuo. | true, false |
| m | ||
max | O valor máximo permitido. Para steppers numéricos, essas propriedades representam segundos quando o objeto está associado a um valor de tipo de hora sendo ignoradas quando ele está associado a um valor de tipo de data. | mínimo: 0 (para tipos de dados numéricos) |
maxWidth | Designa o maior tamanho permitido para as colunas do list box. | mínimo: 0 |
metaSource | Um objeto meta que contém definições de estilo e de seleção. | Uma expressão de objecto |
method | Um nome de método de projeto. | O nome de um método de projeto existente |
methodsAccessibility | Que métodos 4D podem ser chamados a partir de uma área Web | "none" (padrão), "all" |
min | O valor mínimo permitido. Para steppers numéricos, essas propriedades representam segundos quando o objeto está associado a um valor de tipo de hora sendo ignoradas quando ele está associado a um valor de tipo de data. | mínimo: 0 (para tipos de dados numéricos) |
minWidth | Designa o tamanho menor permitido para as colunas list box. | mínimo: 0 |
movableRows | Autoriza a deslocação de linhas durante a execução. | true, false |
multiline | Manipula conteúdo multilinha. | "yes", "no", "automatic" |
| n | ||
name | O nome do objecto formulário. (Facultativo para o formulário) | Qualquer nome que não pertença a um objeto já existente |
numberFormat | Controla como os campos alfanuméricos e as variáveis aparecem quando exibidos ou impressos. | Números (incluindo um ponto decimal ou sinal de menos, se necessário) |
| p | ||
picture | O nome do caminho da imagem para botões de imagem, menus pop-up de imagem ou imagens estáticas | Caminho relativo ou do sistema de arquivos na sintaxe POSIX, ou "var:<variableName>" para variável imagem. |
pictureFormat (entrada, coluna list box ou rodapé)pictureFormat (imagem estática) | Controla a aparência das imagens quando exibidas ou impressas. | "truncatedTopLeft", "scaled", "truncatedCenter", "tiled", "proportionalTopLeft" (excluindo imagens estáticas), "proportionalCenter" (excluindo imagens estáticas) |
placeholder | Acinzenta o texto quando o valor da fonte de dados está vazio. | Texto a ficar a cinzento. |
pluginAreaKind | Descreve o tipo de plug-in. | O tipo de plug-in. |
popupPlacement | Permite a exibição de um símbolo que aparece como um triângulo no botão, o que indica haver um menu pop-up anexado. | "None", Linked", "Separated" |
printFrame | Modo de impressão para objetos cujo tamanho pode variar de um registro para outro, dependendo de seu conteúdo | "fixed", "variable", (apenas subformulário) "fixedMultiple" |
progressSource | Um valor entre 0 e 100, que representa a porcentagem de conclusão do carregamento da página na área Web. Atualizado automaticamente por 4D, não pode ser modificado manualmente. | mínimo: 0 |
| r | ||
radioGroup | Permite que os botões de opção sejam usados em conjuntos coordenados: apenas um botão de cada vez pode ser selecionado no conjunto. | Nome do grupo rádio |
requiredList | Permite definir uma lista onde só podem ser inseridos determinados valores. | Uma lista de valores obrigatórios. |
resizable | Designa se o tamanho de um objeto pode ser modificado pelo usuário. | "true", "false" |
resizingMode | Especifica se uma coluna da caixa de listagem deve ser redimensionada automaticamente | "rightToLeft", "legacy" |
right | Posiciona um objeto à direita. | mínimo: 0 |
rowControlSource | Um array 4D que define as linhas do list box. | Array |
rowCount | Define o número de linhas. | mínimo: 1 |
| rowFillSource (array list box) rowFillSource (selection or collection list box) | O nome de um array ou expressão para aplicar uma cor de fundo personalizada a cada linha de um list box. | O nome de um array ou expressão. |
rowHeight | Define a altura das linhas do list box. | Valor CSS a unidade "em" ou "px" (por padrão). |
rowHeightAuto | boolean | "true", "false" |
rowHeightAutoMax | Designa a maior altura permitida para as linhas do list box. | Valor CSS a unidade "em" ou "px" (por padrão). mínimo: 0 |
rowHeightAutoMin | Designa a altura mais pequena permitida para as linhas da caixa do list box. | Valor CSS a unidade "em" ou "px" (por padrão). mínimo: 0 |
rowHeightSource | Um array que define diferentes alturas para as linhas de um list box. | Nome de uma variável array 4D. |
| rowStrokeSource (array list box) rowStrokeSource (selection or collection/entity selection list box) | Um arrray ou expressão para gerir estilos das linhas. | Nome do array ou expressão. |
| rowStyleSource (array list box) rowStyleSource (selection or collection/entity selection list box) | Um arrray ou expressão para gerir as cores das linhas. | Nome do array ou expressão. |
| s | ||
saveAs (columna list box)saveAs (lista suspensa) | O tipo de conteúdo a ser salvo no campo ou na variável associada ao objeto de formulário | "value", "reference" |
scrollbarHorizontal | Uma ferramenta que permite ao usuário mover a área de visualização para a esquerda ou para a direita. | "visible", "hidden", "automatic" |
scrollbarVertical | Uma ferramenta que permite ao usuário mover a área de visualização para cima ou para baixo. | "visible", "hidden", "automatic" |
selectedItemsSource | Coleção dos itens seleccionados num list box. | Expressão da colecção |
| selectionMode (hierarchical list) selectionMode (list box) selectionMode (subform) | Permite a seleção de vários registos/linhas. | "multiple", "single", "none" |
shortcutAccel | Designates the accelerator key (Ctrl Windows/Command macOS). | true, false |
shortcutAlt | Designa a tecla Alt | true, false |
shortcutCommand | Designa a tecla Comando (macOS) | true, false |
shortcutControl | Designa a tecla Control (Windows) | true, false |
shortcutKey | A letra ou o nome de uma chave de significado especial. | "a", "b",... ou "[F1]" -> "[F15]", "[Return]", "[Enter]", "[Backspace]", "[Tab]", "[Esc]", "[Del]", "[Home]", "[End]", "[Help]", "[Page up]", "[Page down]", "[left arrow]", "[right arrow]", "[up arrow]", "[down arrow]" |
shortcutShift | Designa a tecla Shift | true, false |
showBackground | Exibe ou oculta conteúdos de fundo. | true, false |
showEmptyImages | Exibe/oculta um retângulo preto para imagens vazias | true, false |
showFooters | Mostra ou oculta os rodapés das colunas. | true, false |
showGraduations | Apresenta/oculta as graduações junto às etiquetas. | true, false |
showHeaders | Mostra ou oculta os cabeçalhos das colunas. | true, false |
showHiddenChars | Mostra/oculta caracteres invisíveis. | true, false |
showHorizontalRuler | Mostra/oculta a régua horizontal quando a vista de documento está no modo de vista Página | true, false |
showHTMLWysiwyg | Ativa/desactiva a visualização HTML WYSIWYG | true, false |
showPageFrames | Exibe/oculta a moldura da página quando a visualização do documento está no modo Visualização de página | true, false |
showReferences | Apresenta todas as expressões 4D inseridas no documento 4D Write Pro como *referências * | true, false |
showSelection | Mantém a seleção visível no objeto depois que ele perde o foco | true, false |
showVerticalRuler | Exibe/oculta a régua vertical quando a visualização do documento está no modo de visualização Página | true, false |
singleClickEdit | Permite a passagem direta para o modo de edição. | true, false |
sizingX | Especifica se o tamanho horizontal de um objeto deve ser movido ou redimensionado quando um usuário redimensiona o formulário. | "grow", "move", "fixed" |
sizingY | Especifica se o tamanho vertical de um objeto deve ser movido ou redimensionado quando um usuário redimensiona o formulário. | "grow", "move", "fixed" |
sortable | Permite ordenar os dados das colunas clicando no cabeçalho. | true, false |
spellcheck | Ativa a verificação ortográfica do objeto | true, false |
splitterMode | Quando um objeto splitter tem essa propriedade, os outros objetos à sua direita (splitter vertical) ou abaixo dele (splitter horizontal) são empurrados ao mesmo tempo que o divisor, sem parada. | "grow", "move", "fixed" |
startPoint | Ponto de partida para desenhar um objeto de linha (disponível somente na gramática JSON). | "bottomLeft", topLeft" |
staticColumnCount | Número de colunas que não podem ser movidas durante a execução. | mínimo: 0 |
step | Intervalo mínimo aceite entre valores durante a utilização. Para steppers numéricos, Esta propriedade representa os segundos quando o objeto está associado com um valor de tipo hora e dias quando está associado a um valor de tipo data. | mínimo: 1 |
storeDefaultStyle | Armazenar as etiquetas de estilo com o texto, mesmo que nenhuma modificação tenha sido feita | true, false |
| stroke (text) stroke (lines) stroke (list box) | Especifica a cor do tipo de letra ou da linha utilizada no objeto. | Qualquer valor CSS, "transparent", "automatic" |
strokeDashArray | Descreve o tipo de linha pontilhada como uma sequência de pontos pretos e brancos | Arrays numéricos ou strings |
strokeWidth | Designa a espessura de uma linha. | Um número inteiro ou 0 para a largura mais pequena num formulário impresso |
style | Permite definir o aspeto geral do botão. Consulte Estilo do botão para obter mais informações. | "regular", "flat", "toolbar", "bevel", "roundedBevel", "gradientBevel", "texturedBevel", "office", "help", "circular", "disclosure", "roundedDisclosure", "custom" |
styledText | Permite a possibilidade de utilizar estilos específicos na área selecionada. | true, false |
switchBackWhenReleased | Exibe a primeira imagem o tempo todo, exceto quando o usuário clica no botão. Apresenta a segunda imagem até que o botão do rato seja libertado. | true, false |
switchContinuously | Permite ao usuário manter pressionado o botão do mouse para exibir as imagens continuamente (ou seja, como uma animação). | true, false |
switchWhenRollover | Modifica o conteúdo do botão de imagem quando o cursor do mouse passa sobre ele. A imagem inicial é exibida quando o cursor sai da área do botão. | true, false |
| t | ||
table | Tabela a que pertence o subformulário Lista (se existir). | Nome da tabela 4D, ou "" |
text | O título do objeto formulário | Qualquer texto |
textAlign | Localização horizontal do texto na área que o contém. | "automatic", "right", "center", "justify", "left" |
textAngle | Modifica a orientação (rotação) da área de texto. | 0, 90, 180, 270 |
textDecoration | Define o texto selecionado para ter uma linha por baixo. | "normal", "underline" |
textFormat | Controla como os campos alfanuméricos e as variáveis aparecem quando exibidos ou impressos. | "### ####", "(###) ### ####", "### ### ####", "### ## ####", "00000", formatos personalizados |
textPlacement | Localização relativa do título do botão em relação ao ícone associado. | "left", "top", "right", "bottom", "center" |
threeState | Permite que um objeto de caixa de verificação aceite um terceiro estado. | true, false |
timeFormat | Controla como as horas aparecem quando são apresentadas ou impressas. | Formatos incorporados: ("systemShort", "systemMedium", "systemLong", "iso8601", "hh_mm_ss", "hh_mm", "hh_mm_am", "mm_ss", "HH_MM_SS", "HH_MM", "MM_SS", "blankIfNull") |
truncateMode | Controla a exibição de valores quando as colunas da caixa de listagem são muito estreitas para mostrar todo o seu conteúdo. | "withEllipsis", "none" |
type | Obrigatório. Designa o tipo de dados do objeto do 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", "view" |
tooltip | Fornecer aos usuários informações adicionais sobre um campo. | Informações adicionais para ajudar um usuário |
top | Posiciona um objeto na parte superior (centrado). | mínimo: 0 |
| u | ||
urlSource | Designa a URL carregada ou sendo carregada pela área Web associada. | Um URL. |
useLastFrameAsDisabled | Habilita a configuração da última miniatura como a que será exibida quando o botão estiver desativado. | true, false |
userInterface | Interface de área 4D View Pro. | "none" (padrão), "ribbon", "toolbar" |
| v | ||
values | Lista de valores predefinidos para as colunas listbox de tipo array | ex: "A", "B", "42"... |
variableCalculation | Permite efetuar cálculos matemáticos. | "none", "minimum", "maximum", "sum", "count", "average", "standardDeviation", "variance", "sumSquares" |
verticalAlign | Localização vertical do texto na área que o contém. | "automatic", "top", "middle", "bottom" |
verticalLineStroke | Define a cor das linhas verticais num list box (cinzento por predefinição). | Qualquer valor CSS, "transparent", "automatic" |
visibility | Permite ocultar o objeto no ambiente da aplicação. | "visible", "hidden", "selectedRows", "unselectedRows" |
| w | ||
webEngine | Usado para escolher entre dois motores de renderização para a área Web, dependendo das especificações da aplicação. | "embedded", "system" |
width | Designa o tamanho horizontal de um objeto | mínimo: 0 |
withFormulaBar | Gerencia a exibição de uma barra de fórmula com a interface da barra de ferramentas na área 4D View Pro. | true, false |
wordwrap | Gerencia a exibição do conteúdo quando ele excede a largura do objeto. | "automatic" (exceto coluna e rodapé de list box), "normal", "nenhum" |
| z | ||
zoom | Percentagem de zoom para mostrar a área 4D Write Pro | número (mínimo=0) |