4D v17

Usando ações padrão

Página Inicial

 
4D v17
Usando ações padrão

Usando ações padrão    


 

A interface de usuário de áreas 4D Write Pro pode ser manejada através de um amplo conjunto de ações padrão. As ações padrão podem ser atribuidas a:

  • comandos de menu, disponíveis através da barra de menu ou do comando Dynamic pop up menu
  • list items, listas pop up ou drop down, menus pop up hierárquicos
  • botões, check boxes
  • ou executados pelo comando INVOKE ACTION.

Quando são atribuidos aos objetos de interface, as ações padrão manejam a ativação/desativação de objeto em função de contexto. Para mais informação, consulte a seção Ações padrões.

Dois tipos de ações estão disponíveis para áreas 4D Write Pro:

  • As ações específicas 4D Write Pro, que só podem ser utilizadas com áreas 4D Write Pro,
  • Outras ações, incluido as fontes, expressões, corretor ortográfico e ações de edição, que podem ser utilizadas com as áreas 4D Write Pro e as outras áreas 4D (ver Ações padrões).

As ações padrão abaixo estão disponíveis com áreas  4D Write Pro.

Notas:

    as ações 4D Write Pro não têm constantes correspondentes.
    as ações 4D Write Pro podem ser associadas aos comandos de menu ou aos botões. As ações que mostram um submenu podem ser associadas aos comandos de menus unicamente (ver *).
    Check boxes e 3D check boxes devem ser associadas com ações de estado, tais como  "section/differentFirstPage" ou "visibleHorizontalRuler". Três opções de estado são suportadas com check boxes padrão apenas.
    um status de ação de seção é sempre igual ao status atual de seção selecionada (estado herdado se o atributo for herdado da seção pai ou de um atributo padrão) já que deve refletir o status de seção selecionada (o status que é aplicado atualmente para a seção). Entretanto, modificar o atributo de seção com uma ação padrão vai sobrepujar o atributo de seção selecionado.(*) Submenu: Quando usado sem parâmetros e associados ao comando menu, um pop-up/lista drop down ou um objeto de menu hierárquico pop-up, essas ações exibem um submenu/lista automática. Por exemplo, se atribuir a ação "backgroundColor"  a um comando de menu, selecionando este comando de menu na execução vai exibir os itens de submenu de Cor de Fundo. Se atribuir a ação  "zoom" a um menu hierárquico  pop-up menu, vai conter automaticamente conter uma lista de valores pré-definidos de zoom. Note que essas ações não podem ser atribuídas aos botões.

(**) showDialog: Adicionar a string  "/showDialog" ao nome de ação permite a exibição da caixa de diálogo padrão associada para a ação. Por exemplo, pode ser usado "paragraph/styleSheet/showDialog" para abrir o diálogo de input que permite a entrada de um novo nome de folha de estilo.

Nome da açãoSintaxe (se for específicada)Submenu(*)showDialog(**)Descrição

[#table]Action

DocumentParagraphImageSectionHeaderFooterSubmenu(*)showDialog(**)
anchorHorizontalAlignXX
anchorLayoutXX
anchorOriginXX
anchorPageXX
anchorSectionXX
anchorVerticalAlignXX
avoidPageBreakInsideEnabledX
backgroundXXXXXXX
backgroundColorXXXXXXXX
backgroundClipXXXXXXX
backgroundImageXXXXXXXX
backgroundOriginXXXXXXX
backgroundPositionHXXXXXXX
backgroundPositionVXXXXXXX
backgroundRepeatXXXXXXX
backgroundSizeHXXXXXXX
backgroundSizeVXXXXXXX
bookmarkX
borderCollapseX
borderColorXXXXXXXX
borderRadiusXXXXXXX
bordersXXXXXXX
borderStyleXXXXXXX
borderWidthXXXXXXX
deleteStyleSheetXXX
directionXX
docXX
dpiX
fontStyleWriteX
fontSubscriptX
fontSuperscriptX
footerX
footer/removeX
headerX
header/removeX
htmlWYSIWIGEnabledX
imageXX
image/heightXX
image/verticalAlignXX
insertImageX
insertPageBreakX
insertSectionBreakX
lineHeightXX
listStartNumberX
listStyleImageX
listStyleTypeXX
marginXXXXXXX
mergeX
minHeightXXX
minWidthXXX
moveToFrontX
moveToBackX
newLineStyleSheetXX
paddingXXXXXXX
pageModeX
pageOrientationXX
pageSizeX
paragraphXX
printX
refreshImagesX
sectionXX
section/differentFirstPageX
section/differentLeftRightPagesX
section/name/showDialogXX
section/resetX
splitX
styleSheetXXXX
styleSheetsXXX
textAlignX
textIndentX
textLinethroughX
textLinethroughColorXX
textLinethroughStyleX
textShadowX
textShadowColorXX
textShadowOffsetX
textTransformX
textUnderlineX
textUnderlineColorXX
textUnderlineStyleX
updateStyleSheetXXX
userUnitX
verticalAlignXX
visibleBackgroundXXXXXX
viewX
visibleFootersX
visibleHeadersX
visibleHiddenCharsX
visibleHorizontalRulerX
visiblePageFramesX
widowAndOrphanControlEnabledX
widthXXX
zoomXX


(*) Submenu: quando forem usadas sem  parâmetros e forem associadas a um comando de menu, lista pop-up ou um objeto de menu pop-up hierárquico, estas ações mostram um submenu automático. Por exemplo, se atribuir a ação "backgroundColor" a um comando de menu, ao selecionar este comando de menu em tempo de execução são mostrados os elementos de submenu backgroundColor. Se atribuir a ação "zoom" a um menu emergente hierárquico, conterá automaticamente uma lista de valores de zoom predefinidos.

(**) showDialog: adicionar a string /showDialog ao nome da ação permite mostrar o quadro de diálogo padrão associado para a ação. Por exemplo, pode utilizar "paragraph/styleSheet/showDialog" para abrir o diálogo de entrada que permite introduzir um novo nome de folha de estilo.

Syntax: anchorHorizontalAlign?value={left | center | right}

Define o alinhamento horizontal da imagem, relativo ao anchorOrgin de imagens na página, ou ao  layout box de imagens em modo embebido. Essa ação reseta o deslocamento horizontal para 0. (não ativado para imagens inline).

Syntax: anchorLayout?value={inline | front | behind}

Define o tipo de âncora de layout para uma imagem. Pode ser usada para mover uma imagem inline em frente ou atrás do texto ou o reverso. Nota: se uma imagem for movida de frente/atrás do texto para inline, a imagem é inserida no começo do texto selecionado atualmente.

Syntax: anchorOrigin?value={paper-box | header-box | footer-box}

Define a área relativa a posição absoluta da imagem ancorada. Essa ação vai resetar os deslocamentos (offset) horizontal e vertical para 0. Se uma imagem for relativa a caixa de cabeçalho/caixa de rodapé que não é visível na página, a imagem não é exibida. Essa ação vai resetar offsets horizontal e vertical para 0.
Só em Modo página, não ativado para imagens inline.

Syntax: anchorPage?value={all | current | currentSubSection}

Define as páginas em que a imagem selecionada for exibida (não ativado para imagens inline).
Modo página apenas.

Syntax: anchorSection?value={all | current}

Define as seções nas quais a imagem selecionada é exibida (não ativada para imagens inline)
Só modo Página.

Syntax: anchorVerticalAlign?value={top | center | bottom}

Define o alinhamento vertical da imagem, relativao a anchorOrgin para imagens na página, ou a caixa layout para imagens em modo embebido. Essa ação reseta o deslocamento vertical para 0 (não ativado para imagens inline).

Syntax: avoidPageBreakInsideEnabled

Permite ou desativa quebras de página dentro dos parágrafos.

Syntax: {doc | paragraph | image | section | header | footer}/background

Só para comandos de menu. Submenus pré-determinados para todos os atributos de fundo.

Sintaxis: {doc | paragraph | image | section | header | footer}/backgroundClip?value={paper-box | border-box | padding-box | content-box}

Muda o quadro de recorte de fundo do objetivo (o objetivo pré-determinado é o parágrafo). Paper-box só se enfoca em documentos e seções.

Sintaxis: {doc | paragraph | image | section | header | footer}/backgroundColor?value={<Css_color> | transparent}

Muda o fundo objetivo.

Sintaxis: {doc | paragraph | image | section | header | footer}/backgroundImage?value=none

Apaga a imagem de fundo objetivo. (o objetivo pre-determinado é o parágrafo)

Sintaxis: {doc | paragraph | image | section | header | footer}/backgroundOrigin?value={paper-box | border-box | padding-box | content-box}

Muda o quadro de origem da imagem de fundo de destino (o objetivo pré-determinado é o parágrafo). Paper-box só se enfoca em documentos e seções.

Sintaxis: {doc | paragraph | image | section | header | footer}/backgroundPositionH?value={left | right | center}

Muda o alinhamento horizontal da imagem de fundo objetivo (o objetivo pré-determinado é o parágrafo).
Ex: paragraph/backgroundPositionH?value=left

Sintaxis: {doc | paragraph | image | section | header | footer}/backgroundPositionV?value={top | bottom | center}

Muda o alinhamento vertical da imagem de fundo objetivo (o objetivo pré-determinado é o parágrafo).
Ex: paragraph/backgroundPositionV?value=top

Sintaxis: {doc | paragraph | image | section | header | footer}/backgroundRepeat?value={no-repeat | repeat | repeat-x | repeat-y}

Muda o modo de repetição da imagem de fundo objetivo. (o objetivo pré-determinado é o parágrafo)

Sintaxis: {doc | paragraph | image | section | header | footer}/backgroundSizeH?value={<Css_length> | <Css_percentage> | auto | cover | contain}

Muda a largura da imagem de  fundo objetivo (o objetivo pré-determinado é o parágrafo).
Ex: paragraph/backgroundSizeH?value=100%. section/backgroundSizeH?value=cover

Sintaxis: {doc | paragraph | image | section | header | footer}/backgroundSizeV?value={<Css_length> | <Css_percentage> | auto}

Muda a altura da imagem de fundo objetivo (o objetivo pré-determinado é o parágrafo).
Ex: paragraph/backgroundSizeV?value=50%. Ex: section/backgroundSizeV?value=40pt

Sintaxis: bookmark?index=<number>

Seleciona o enésimo marcador.
Ex: bookmark?index=2 // seleciona o segundo marcador

Sintaxis: borderCollapse

Contrai as bordas de parágrafo selecionadas e as margens interiores.

Sintaxis: {doc | paragraph | image | section | header | footer/}{inside | outside/}{borderColor | borderColorLeft | borderColorRight | borderColorTop | borderColorBottom | borderColorLeftRight | borderColorTopBottom}?value=<Css_color>

Muda a cor da borda de destino (o objetivo pré-determinado é o parágrafo).
Ex: paragraph/borderColorLeft?value=green

Sintaxis: {doc | paragraph | image | section | header | footer}/borderRadius?value=<Css_length>

Muda o raio da borda objetivo (o objetivo pré-determinado é o parágrafo).
Ex: paragraph/borderRadius?value=4pt

borders  

Sintaxis: {doc | paragraph | image | section | header | footer/}{inside | outside/}borders

Submenu pré-determinado para as bordas objetivo.

Sintaxis: {doc | paragraph | image | section | header | footer/}{inside | outside/}{borderStyle | borderStyleLeft | borderStyleRight | borderStyleTop | borderStyleBottom | borderStyleLeftRight | borderStyleTopBottom}?value={none | hidden | dotted | dashed | solid | double | groove | ridge | inset | outset}

Muda o estilo da borda objetivo (o objetivo pré-determinado é o parágrafo).
Ex: paragraph/borderStyleLeft?value=double. Ex: outside/borderStyle?value=solid //estabelece as bordas exteriores dos parágrafos selecionados para que tenham um estilo sólido. Ex: inside/borderStyle?value=none //elimina as bordas interiores dos parágrafos selecionados

Sintaxis: {doc | paragraph | image | section | header | footer/}{inside | outside/}{borderWidth | borderWidthLeft | borderWidthRight | borderWidthTop | borderWidthBottom | borderWidthLeftRight | borderWidthTopBottom}?value=<Css_length>

Muda o objetivo de largura da borda (o objetivo como padrão é o parágrafo).
Ex: paragraph/borderWidthLeft?value=4pt

Sintaxe: {section/}columnCount?value={1<=number<=20}

Número de colunas no documento atual  ou seções.
Ex: section/columnCount?value=3

Syntaxe: {section/}columnRuleColor?value={CSS color}

Cor para a linha decorativa entre documentos ou colunas de seção.
Ex: columnRuleColor?value="#FFFFFF"

Sintaxe: {section/}columnRuleStyle?value={none | dotted | dashed | solid | double | groove | ridge | inset | outset}

Estilo para a linha decorativa entre colunas documentos ou seções.
Ex: columnRuleStyle?value="solid"

Sintaxe: {section/}columnRuleWidth?value={CSS length}

Largura da linha decorativa entre colunas de documento ou seções.
Ex: columnRuleWidth?value="2pt"

colunas  

Sintaxe: {section/}columns

Apenas para item de menu: criat automaticamente um sub-menu completo Columns com todos os sub-menus de ação de coluna (except insertColumnBreak)

Sintaxe: {section/}columnSpacing?value={CSS length}

Espaço entre duas colunas no documento atual ou seção.
Ex: columnSpacing?value="1cm"

Sintaxis: {paragraph | image}/deleteStyleSheet?index={1<= number <= number of target style sheets}

Elimina a folha de estilo N das folhas de estilo armazenadas para o objetivo selecionado (o objetivo como padrão é o parágrafo). O nome do elemento de menu é substituído em tempo de execução com o nome da folha de estilo.

Sintaxis: direction?value={ltr | rtl}

Direção do parágrafo.

doc  

Sintaxis: doc

Submenu padrão para a disposição do corpo do documento (atributos de modo embebido ou atributos padrão para as seções - mas para a margem que está reservada para o modo embebido unicamente) 

dpi  

Sintaxis: modifica o dpi da vista atual (independentemente do atributo de documento wk dpi utilizado internamente para a conversão de pixels <-> pontos).

Mudar vista dpi..
Ex: dpi?value=72


Sintaxis: fontStyleWrite

Só para comandos de menu. Mostra o submenu de estilos de fonte pré-determinados para 4D Write Pro.

Syntax: fontSubscript

Toggles subscript font attribute.

Sintaxis: fontSuperscript

Alterna o atributo de fonte Superscrito.

footer  

Sintaxis: footer

Mostra o submenu Rodapé.

Sintaxis: footer/remove

Elimina o rodapé selecionado

header  

Sintaxis: header

Mostra o submenu Cabeçalho.

Sintaxis: header/remove

Elimina o cabeçalho selecionado.

Sintaxis: htmlWYSIWIGEnabled

Alterna entre o modo wysiwyg html.

image  

Sintaxis: image

Mostra o submenu de layout de imagem.

Sintaxis: image/height?value={<Css_length> | auto}

Altura objetivo (só se admite para imagens).
Ex.: image/height?value=50pt. Para image/width, ver width.

Sintaxis: image/verticalAlign?value={top | middle | bottom | baseline | super | sub}

Alinhamento vertical da imagem
Ex: image/verticalAlign?value=super

Sintaxis: insertImage

Abre um diálogo de seleção de imagens e insere a imagem selecionada (se existir) como um caractere na área.

Syntaxe: insertColumnBreak

Insere uma quebra de coluna na seleção.

Syntax: insertPageBreak

Insere uma quebra de página na seleção.

Sintaxis: insertSectionBreak

Insere um salto de seção na seleção.

Sintaxis: lineHeight?value={<Css_length> | <Css_percentage>}

Altura de linha de parágrafo
Ex: lineHeight?value=120%

Sintaxis: listStartNumber?value={<number> (longint) | auto}

Número de inicio da lista.
Ex: listStartNumber?value=10

Sintaxis: listStyleImage/showDialog

Abre um diálogo de arquivo para escolher uma imagem que se mostrará como una vinheta de estilo de lista; também estabelecerá o tipo de estilo de lista para o estilo de disco que se utilizará se não se encontra a imagem.

Sintaxis: listStyleType?value={none | disc | circle | square | hollow-square | diamond | club | decimal | decimal-leading- zero | lower-latin | lower-roman | upper-latin | upper-roman | lower-greek | decimal-greek | armenian | georgian | hebrew | hiragana | katakana | cjk-ideographic}

Tipo de estilo de lista de parágrafo.

margin  

Sintaxis: {doc | paragraph | image | section | header | footer/}{inside | outside/}{margin | marginLeft | marginRight | marginTop | marginBottom | marginLeftRight | marginTopBottom}?value={<Css_length> | auto}

Muda a margem objetivo (o objetivo pré-determinado é o parágrafo).
Ex: margin?value=4pt //estabelece todas as margens de parágrafo em 4pt.
Ex: outside/margin?value=4pt //estabelece as margens dos parágrafos exteriores em 4pt.
Ex: doc/marginLeft?value=1cm //estabelece a margem esquerdo em 1 cm para o documento como se usa em modo aninhado.
Ex: section/marginLeft?value=1cm // estabelece a margem esquerdo em 1 cm para as páginas da primeira seção selecionada

merge  

Sintaxis: merge

Fusiona parágrafos.

Sintaxis: {paragraph | image}/minHeight?value=<Css_length>

Altura mínima objetivo (o objetivo pré-determinado é o parágrafo).
Ex: paragraph/minHeight?value=50pt

Sintaxis: {paragraph | image}/minWidth?value=<Css_length>

Largura mínima do objetivo (o objetivo padrão é o parágrafo).
Ex: paragraph/minWidth?value=50pt

Sintaxis: moveToBack

Move a imagem para trás. (não habilitado para imagens em linha)

Sintaxis: moveToFront

Move a imagem para frente. (não habilitado para imagens inline)

Sintaxis: newLineStyleSheet?index={1<=number<=number of paragraph stylesheets | newLineStyleSheet?value=auto

Os elementos de parágrafo selecionados utilizarão a folha de estilo N-ésima como folha de estilo para usá-la nos novos parágrafos criados ao devolver ou ao dividir os parágrafos; Se valor = auto, os novos parágrafos utilizarão a mesma folha de estilo (pré-determinada). (O nome de elemento de menu se substitui em iempo de execução com o nome da folha de estilo)

padding  

Sintaxis: {doc | paragraph | image | section | header | footer/}{inside | outside/}{padding | paddingLeft | paddingRight | paddingTop | paddingBottom | paddingLeftRight | paddingTopBottom }?value=<Css_length>

Muda o preenchimento do objetivo. (o objetivo pré-determinado é o parágrafo)

Sintaxis: pageMode?value={embedded | page | draft}

Muda o modo de vista. Ex: pageMode?value=page

Sintaxis: {section/}pageOrientation?value={landscape | portrait}

Muda o documento ou a orientação da página da primeira seção selecionada (se não for especificada a seção, se aplicará a todas as seções , ou então, à primeira seção selecionada).
Exemplo: pageOrientation?value=portrait //muda a orientação a vertical para todo o documento.
Exemplo: section/pageOrientation?value=landscape //mudar a orientação a horizontal para a primeira seção selecionada

Sintaxis: pageSize?index=<number>

Muda o tamanho da página de documento: o número é o tamanho de página N-ésimo na lista de tamanhos de páginas disponíveis na impressora atual.
Ex: pageSize?index=1

Sintaxis: paragraph

Submenu  padrão para o design do parágrafo.

print  

Sintaxis: print

Imprime o documento como renderizado no modo de página com a configuração de visualização da área 4D Write Pro enfocada.

Sintaxis: refreshImages

Recarrega imagens da rede para imagens com URL.

section  

Sintaxis: section

Submenu pré-determinado para o layout de página para a primeira seção selecionada.   

Sintaxis: section/differentFirstPage

A seção tem a primeira página diferente ou não.

Sintaxis: section/differentLeftRightPages

A seção tem páginas esquerda e direita diferentes ou então não

Sintaxis: section/name/showDialog

Mostra um diálogo que permite introduzir o primeiro nome de seção selecionado.

Sintaxe: section/reset

Restabece todos os primeiros atributos de seção selecionados aos atributos pré-determinados, que são herdados dos atributos doc para fundo, borda e preenchimento (igual que para o modo aninhado) e 2,5 cm para as margens de página. Propriedades de coluna de primeiras seções selecionadas também são removidas (de forma que apenas propriedades de seção padrão são aplicadas).
split  

Syntax: split

Divide os parágrafos.

Sintaxis: {paragraph | image}/styleSheet?value={1<=number<=number of target style sheets}

Aplica a enésima folha de estilo aos elementos de destino selecionados. Com o diálogo, a nova folha de estilos utilizará os atributos atuais de primeiro objetivo selecionado (o objetivo padrão é o parágrafo)
Ex: styleSheet?value=1 //Aplicar a folha de estilo de primeiro parágrafo aos parágrafos selecionados e defini-las como folhas de estilo de parágrafo.

Sintaxis: {paragraph | image}/styleSheets

Submenu pré-determinado para editar folhas de estilo objetivo.

Sintaxis: textAlign?value={left | right | center | justify | initial}

Alinhamento de texto de parágrafo (inicial = uso direito para rtl ou esquerdo para direção ltr)

Sintaxis: textIndent?value=<Css_length> (pode ser negativa)

Abre a indentação (recuo) do texto do parágrafo (recuo da primeira linha).
Ex: textIndent?value=2cm

Sintaxis: textLinethrough

Só para comandos de menu. Submenu Riscado (com estilo e cor).

Syntax: textLinethroughColor?value={<Css_color> | currentColor}

Ex: textLinethroughColor?value=red

Syntax: textLinethroughStyle?value={none | solid | dotted | dashed | double | semi-transparent | word}

Ex: textLinethroughStyle?value=dotted

Sintaxis: textShadow

Só para comandos de menu. Submenu pré-determinado para sombra de texto (com cor e deslocamento).

Sintaxis: textShadowColor?value={<Css_color> | none}

Muda o estado da sombra ou a cor dos caracteres.
Ex: textShadowColor?value=green

Sintaxis: textShadowOffset?value=<Css_length>

Só é admitido o tamanho em pt.
Ex: textShadowOffset?value=2pt

Syntax: textTransform?value={none | capitalize | uppercase | lowercase | small-uppercase}

Formata o texto.
Ex: textTransform?value=capitalize

Sintaxis: textUnderline

Só para comandos de menu. Submenu sublinhado (com estilo e cor)

Syntax: textUnderlineColor?value={<Css_color> | currentColor}

Ex: textUnderlineColor?value=red

Syntax: textUnderlineStyle?value={none | solid | dotted | dashed | double | semi-transparent | word}

Ex: textUnderlineStyle?value=dotted

Syntax: {paragraph | image}/updateStyleSheet

Atualiza a primeira folha de estilo selecionada com os atributos atuais do primeiro alvo selecionado (alvo padrão é parágrafo)

Sintaxis: userUnit?value={cm | mm | in | pt}

Muda a unidade de layout de documento (se reflexará nas réguas).

Sintaxis: verticalAlign?value={top | middle | bottom}

Alinhamento  vertical do parágrafo.
Ex: verticalAlign?value=top. O efeito depende do valor minHeight do parágrafo.

view  

Syntax: view

Só para comandos de menu. Submenu padrão para configurações de vista

Syntax: visibleBackground

Mostra ou esconde o fundo.

Syntax: visibleFooters

Mostra ou esconde cabeçalhos.

Syntax: visibleHeaders

Mostra ou esconde cabeçalhos.

Syntax: visibleHiddenChars

Mostra ou esconde caracteres escondidos

Syntax: visibleHorizontalRuler

Mostra ou esconde a régua horizontal.

Syntax: visiblePageFrames

Mostra ou esconde frames das páginas

Syntax: widowAndOrphanControlEnabled

Alterna entre modo janela e controle de órfãos

width  

Syntax: {paragraph | image}/width?value=<Css_length> | auto

Largura do alvo (só compatível para parágrafos e imagens - alvo padrão é o parágrafo).
Ex: image/width?value=50pt

zoom  

Syntax: zoom?value={25% <= percentage in Css <= 400%}

Muda a visão de zoom do documento
Ex: zoom?value=120%

Outras ações padrão estão disponíveis nos formulários 4D e podem ser utilizadas nas áreas 4D Write Pro:

 
 



Ver também 


 
PROPRIEDADES 

Produto: 4D
Tema: Usando ações padrão

 
HISTÓRIA 

New
Criado por: 4D v16 R3
Modificado: 4D v16 R4
Modificado: 4D v16 R6
Modificado: 4D v17

 
ARTICLE USAGE

Referência 4D Write Pro ( 4D v17)