Saltar para o conteúdo principal
Versão: 20

Lista de métodos

Aviso: os comandos nesta página não são thread-safe.

A - C - D - E - F - G - I - M - N - O - P - R - S

A

VP ADD FORMULA NAME

VP ADD FORMULA NAME ( vpAreaName : Text ; vpFormula : Text ; name : Text { ; options : Object } )

ParâmetroTipoDescrição
vpAreaNameText->Nome de objeto formulário área 4D View Pro
vpFormulaText->Fórmula 4D View Pro
nameText->Nome da fórmula
optionsObject->Opções para a fórmula

|

Descrição

O comando VP ADD FORMULA NAME cria ou modifica uma fórmula nomeada no documento aberto.

As fórmulas nomeadas criadas por este comando são guardadas com o documento.

Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

Passar a fórmula 4D View Pro que deseja nomear em vpFormula. Para obter informações detalhadas sobre a sintaxe das fórmulas, consulte a página Fórmulas e funções.

Passar o novo nome da fórmula em name. Se o nome já estiver a ser utilizado no mesmo âmbito, a nova fórmula nomeada substitui a existente. Note que pode utilizar o mesmo nome para diferentes âmbitos (ver abaixo).

Pode passar um objeto com propriedades adicionais para a fórmula nomeada em options. As propriedades abaixo são compatíveis:

PropriedadeTipoDescrição
scopeNumberEscopo da fórmula. Pode passar o índice da folha (a contagem começa em 0) ou utilizar as seguintes constantes:
  • vk current sheet
  • vk workbook
  • O âmbito determina se um nome de fórmula é local para uma determinada folha (scope=sheet index ou vk current sheet), ou global para todo o livro de trabalho (scope=vk workbook).
    commentTextComentário associado à fórmula nomeada

    Exemplo

    VP ADD FORMULA NAME("ViewProArea";"SUM($A$1:$A$10)";"Total2")

    Veja também

    Cell references
    VP Get formula by name
    VP Get names

    VP ADD RANGE NAME

    VP ADD RANGE NAME ( rangeObj : Object ; name : Text { ; options : Object } )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    nameText->Nome da fórmula
    optionsObject->Opções para a fórmula

    |

    Descrição

    O comando VP ADD RANGE NAME cria ou modifica um intervalo nomeado no documento aberto.

    Os intervalos nomeados criados por este comando são guardados com o documento.

    Em rangeObj, passe o intervalo que pretende nomear e passe o novo nome para o intervalo em name. Se o nome já estiver a ser utilizado no mesmo âmbito, o novo intervalo nomeado substitui o existente. Note que pode utilizar o mesmo nome para diferentes âmbitos (ver abaixo).

    Pode passar um objeto com propriedades adicionais para o intervalo nomeado em options. As propriedades abaixo são compatíveis:

    PropriedadeTipoDescrição
    scopeNumberÂmbito do intervalo. Pode passar o índice da folha (a contagem começa em 0) ou utilizar as seguintes constantes:
  • vk current sheet
  • vk workbook
  • O âmbito determina se um nome de um intervalo é local para uma determinada folha (scope=sheet index ou vk current sheet), ou global para todo o livro de trabalho (scope=vk workbook).
    commentTextComentário associado ao intervalo nomeado
    • Um intervalo nomeado é, na verdade, uma fórmula nomeada que contém coordenadas. VP ADD RANGE NAME facilita a criação de intervalos nomeados, mas também pode utilizar o comando VP ADD FORMULA NAME para criar intervalos nomeados.
    • As fórmulas que definem intervalos nomeados podem ser recuperadas com o comando VP Get formula by name.

    Exemplo

    Pretende criar um intervalo nomeado para um intervalo de células:

    $range:=VP Cell("ViewProArea";2;10)
    VP ADD RANGE NAME($range;"Total1")

    Veja também

    VP Get names
    VP Name

    VP ADD SELECTION

    VP ADD SELECTION ( rangeObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    |

    Descrição

    O comando VP ADD SELECTION adiciona as células especificadas às células selecionadas.

    Em rangeObj, passe um objeto intervalo de células a adicionar à seleção atual.

    A célula ativa não é modificada.

    Exemplo

    Tem células atualmente seleccionadas:

    O código seguinte adicionará células à sua seleção:

    $currentSelection:=VP Cells("myVPArea";3;4;2;3)
    VP ADD SELECTION($currentSelection)

    Resultados:

    Veja também

    VP Get active cell
    VP Get selection
    VP RESET SELECTION
    VP SET ACTIVE CELL
    VP SET SELECTION
    VP SHOW CELL

    VP ADD SHEET

    VP ADD SHEET ( vpAreaName : Text )
    VP ADD SHEET ( vpAreaName : Text ; index : Integer )
    VP ADD SHEET ( vpAreaName : Text ; sheet : Integer ; name : Text )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da nova folha
    nameText->Nome da folha

    |

    Descrição

    O comando VP ADD SHEET insere uma folha no documento carregado em vpAreaName.

    Em vpAreaName, passe o nome da área 4D View Pro.

    Em sheet, pode passar um índice para a nova folha. Se o index passado for inferior ou igual a 0, o comando insere a nova folha no início. Se o index exceder o número de folhas, o comando insere a nova folha após as existentes.

    A indexação começa em 0.

    Em name, pode indicar um nome para a nova folha. O novo nome não pode conter os seguintes caracteres: *, :, [, ], ?,\,/

    Exemplo

    O documento tem atualmente 3 folhas:

    vp-document-with-3-sheets

    Para inserir uma folha na terceira posição (índice 2) e chamar-lhe "March":

    VP ADD SHEET("ViewProArea";2;"March")

    vp-add-sheet

    Veja também

    VP REMOVE SHEET

    VP ADD SPAN

    VP ADD SPAN ( rangeObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    |

    Descrição

    O comando VP ADD SPAN combina as células em rangeObj como um único intervalo de células.

    Em rangeObj, passe um intervalo de células. As células do intervalo são unidas para criar uma célula maior que se estende por várias colunas ou linhas. Você pode passar vários intervalos de células para criar vários intervalos ao mesmo tempo. Note que se os intervalos de células se sobrepuserem, apenas o primeiro intervalo de células é utilizado.

    • Só são apresentados os dados da célula superior esquerda. Os dados nas outras células combinadas ficam ocultos até que a extensão seja removida.
    • Os dados ocultos em células estendidas podem ser acessados por meio de fórmulas (começando com a célula superior esquerda).

    Exemplo

    Para abranger as células do primeiro trimestre e do segundo trimestre nas duas células ao lado delas, e a célula da área sul nas duas linhas abaixo dela:

    initial-document

     // First quarter range
    $q1:=VP Cells("ViewProArea";2;3;3;1)

    // Second quarter range
    $q2:=VP Cells("ViewProArea";5;3;3;1)

    // South area range
    $south:=VP Cells("ViewProArea";0;5;1;3)

    VP ADD SPAN(VP Combine ranges($q1;$q2;$south))

    vp-add-span-result

    Veja também

    4D View Pro Range Object Properties
    VP Get spans
    VP REMOVE SPAN

    VP ADD STYLESHEET

    VP ADD STYLESHEET ( vpAreaName : Text ; styleName : Text ; styleObj : Object { ; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    styleNameText->Nome do estilo
    styleObjObject->Objeto que define as propriedades do atributo
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP ADD STYLESHEET cria ou modifica a folha de estilo styleName com base na combinação das propriedades especificadas em styleObj no documento aberto. .

    As folhas de estilo criadas por esse comando são salvas com o documento.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    O parâmetro styleName permite que você atribua um nome à folha de estilos. Se o nome já estiver sendo usado no mesmo escopo, a nova folha de estilo substituirá a existente. Note que pode utilizar o mesmo nome para diferentes âmbitos (ver abaixo).

    Em styleObj, designe as configurações da folha de estilos (por exemplo, fonte, decoração de texto, alinhamento, bordas etc.). For the full list of style properties, see Style object properties.

    Você pode designar onde definir a folha de estilos no parâmetro opcional sheet usando o índice da folha (a indexação começa em 0) ou com as seguintes constantes:

    • vk current sheet
    • vk workbook

    Se uma folha de estilo styleName for definida no nível da pasta de trabalho e no nível da planilha, o nível da planilha terá prioridade sobre o nível da pasta de trabalho quando a folha de estilo for definida.

    Para aplicar a folha de estilos, utilize os comandos VP SET DEFAULT STYLE ou VP SET CELL STYLE.

    Exemplo

    O seguinte código:

    $styles:=New object
    $styles.backColor:="green"

    //Line Border Object
    $borders:=New object("color";"green";"style";vk line style medium dash dot)

    $styles.borderBottom:=$borders
    $styles.borderLeft:=$borders
    $styles.borderRight:=$borders
    $styles.borderTop:=$borders VP ADD STYLESHEET("ViewProArea";"GreenDashDotStyle";$styles)

    //To apply the style VP SET CELL STYLE(VP Cells("ViewProArea";1;1;2;2);New object("name";"GreenDashDotStyle"))

    criará e aplicará o seguinte objeto estilo denominado GreenDashDotStyle:

    {
    backColor:green,
    borderBottom:{color:green,style:10},
    borderLeft:{color:green,style:10},
    borderRight:{color:green,style:10},
    borderTop:{color:green,style:10}
    }

    Veja também

    4D View Pro Style Objects and Style Sheets
    VP Get stylesheet
    VP Get stylesheets
    VP REMOVE STYLESHEET
    VP SET CELL STYLE
    VP SET DEFAULT STYLE

    VP All

    VP All ( vpAreaName : Text { ; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objeto intervalo de todas as células

    |

    Descrição

    O comando VP ALL devolve um novo objeto de intervalo que faz referência a todas as células.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    No parâmetro opcional sheet, pode designar uma folha específica onde o intervalo será definido (a contagem começa em 0). Se for omisso ou se passar vk current sheet, é utilizada a folha de cálculo atual.

    Exemplo

    Pretende definir um objeto intervalo para todas as células da folha atual:

    $all:=VP All("ViewProArea") // todas as células da folha atual

    Veja também

    VP Cell
    VP Cells
    VP Column
    VP Combine ranges
    VP Name
    VP Row

    C

    VP Cell

    VP Cell ( vpAreaName ; column : Integer ; row : Integer ; Text { ; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    columnInteger->Índice de coluna
    rowInteger->Índice de linha
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objeto intervalo de uma única célula

    Descrição

    O comando VP Cell devolve um novo objeto intervalo que referir-se a uma célula específica.

    Este comando destina-se a intervalos de uma única célula. Para criar um objeto de intervalo para várias células, use o comando VP Cells .

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    O parâmetro column define a coluna da posição do intervalo de células. Passe o índice da coluna neste parâmetro.

    O parâmetro row define a linha da posição do intervalo de células. Passar o índice da linha neste parâmetro.

    No parâmetro opcional sheet , você pode indicar o índice da planilha em que o intervalo será definido. Se for omitido ou se você passar vk current sheet, a planilha atual será usada por padrão.

    a indexação começa em 0.

    Exemplo

    Se quiser definir um objeto de intervalo para a célula mostrada abaixo (na planilha atual):

    vp-cell

    O código seria:

    $cell:=VP Cell("ViewProArea";2;4) // C5

    Veja também

    VP All
    VP Cells
    VP Column
    VP Combine ranges
    VP Name
    VP Row

    VP Cells

    VP Cells ( vpAreaName : Text ; column: Integer ; row: Integer ; columnCount : Integer ; rowCount : Integer { ; sheet : Integer } ) : Object

    Histórico
    ReleaseMudanças
    17 R4Adicionado
    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    columnInteger->Índice de coluna
    rowInteger->Índice de linha
    columnCountInteger->Número de colunas
    rowCountInteger->Número de linhas
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objeto intervalo de células

    |

    Descrição

    O comando VP Cells devolve um novo objeto intervalo que referir-se a células específicas.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    O parâmetro column define a primeira coluna do intervalo de células. Passar o índice da coluna (a contagem começa em 0) neste parâmetro. Se o intervalo estiver em várias colunas, você também deverá usar o parâmetro columnCount .

    No parâmetro row , você pode definir a(s) linha(s) da posição do intervalo de células. Passar o índice da linha (a contagem começa em 0) neste parâmetro. Se o intervalo estiver dentro de várias linhas, você também deverá usar o parâmetro rowCount .

    O parâmetro columnCount permite que você defina o número total de colunas em que o intervalo se encontra. columnCount deve ser superior a 0.

    O parâmetro rowCount permite que você defina o número total de linhas em que o intervalo se encontra. rowCount tem de ser superior a 0.

    No parâmetro opcional sheet, pode designar uma folha específica onde o intervalo será definido (a contagem começa em 0). Se for omitido ou se você passar vk current sheet, a planilha atual será usada por padrão.

    Exemplo

    Você deseja definir um objeto de intervalo para as seguintes células (na planilha atual):

    O código seria:

    $cells:=VP Cells("ViewProArea";2;4;2;3) // C5 a D7

    Veja também

    VP All
    VP Cells
    VP Column
    VP Combine ranges
    VP Name
    VP Row

    VP Column

    VP Column ( vpAreaName : Text ; column: Integer ; columnCount : Integer { ; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    columnInteger->Índice de coluna
    columnCountInteger->Número de colunas
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objeto intervalo de células

    |

    Descrição

    O comando VP Column devolve um novo objeto intervalo que referir-se a uma coluna ou colunas específicas.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    O parâmetro column define a primeira coluna do intervalo de colunas. Passar o índice da coluna (a contagem começa em 0) neste parâmetro. Se o intervalo contiver várias colunas, deve também utilizar o parâmetro opcional columnCount.

    O parâmetro opcional columnCount permite-lhe definir o número total de colunas do intervalo. columnCount deve ser superior a 0. Se for omitido, o valor será definido como 1 por padrão e um intervalo de tipo de coluna será criado.

    No parâmetro opcional sheet, pode designar uma folha específica onde o intervalo será definido (a contagem começa em 0). Se for omitido ou se você passar vk current sheet, a planilha atual será usada por padrão.

    Exemplo

    Se quiser definir um objeto de intervalo para a coluna mostrada abaixo (na planilha atual):

    O código seria:

     $column:=VP Column("ViewProArea";3) // coluna D

    Veja também

    VP All
    VP Cells
    VP Column
    VP Combine ranges
    VP Name
    VP Row
    VP SET COLUMN ATTRIBUTES

    VP COLUMN AUTOFIT

    VP COLUMN AUTOFIT ( rangeObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    |

    Descrição

    O comando VP COLUMN AUTOFIT dimensiona automaticamente a(s) coluna(s) em rangeObj conforme o seu conteúdo.

    Em rangeObj, passe um objeto de intervalo que contenha um intervalo de colunas cujo tamanho será tratado automaticamente.

    Exemplo

    As colunas a seguir são todas do mesmo tamanho e não exibem parte do texto:

    Selecionar as colunas e executar este código:

     VP COLUMN AUTOFIT(VP Get selection("ViewProarea"))

    ... redimensiona as colunas para se adaptarem ao tamanho do conteúdo:

    Veja também

    VP ROW AUTOFIT

    VP Combine ranges

    VP Combine ranges ( rangeObj : Object ; otherRangeObj : Object {;...otherRangeObjN : Object } ) : Object

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    otherRangeObjObject->Objeto intervalo
    ResultadosObject<-Objeto que contém um intervalo combinado

    |

    Descrição

    O comando VP Combine Ranges devolve um novo objeto intervalo que incorpora dois ou mais objetos intervalo existentes. Todos os intervalos devem ser da mesma área 4D View Pro.

    Em rangeObj, passe o primeiro intervalo.

    Em otherRangeObj, passe um ou vários intervalos para combinar com rangeObj.

    O comando incorpora rangeObj e otherRangeObj por referência.

    Exemplo

    Se quiser combinar objetos de intervalo de células, colunas e linhas em um novo e diferente objeto de intervalo:

     $cell:=VP Cell("ViewProArea";2;4) // C5
    $column:=VP Column("ViewProArea";3) // coluna D
    $row:=VP Row("ViewProArea";9) // linha 10

    $combine:=VP Combine ranges($cell;$column;$row)

    Veja também

    VP All
    VP Cells
    VP Column
    VP Combine ranges
    VP Name
    VP Row
    VP SET COLUMN ATTRIBUTES

    VP Convert from 4D View

    VP Convert from 4D View ( 4DViewDocument : Blob ) : Object

    ParâmetroTipoDescrição
    4DViewDocumentBlob->Documento 4D View
    ResultadosObject<-Objecto 4D View Pro

    |

    Descrição

    O comando VP Convert from 4D View permite que você converta um documento antigo do 4D View em um objeto do 4D View Pro.

    Esse comando não exige que o plug-in legado do 4D View esteja instalado em seu ambiente.

    No parâmetro 4DViewDocument , passe uma variável ou campo BLOB que contenha o documento 4D View a ser convertido. O comando retorna um objeto 4D View Pro no qual todas as informações originalmente armazenadas no documento 4D View são convertidas em atributos 4D View Pro.

    Exemplo

    Se quiser obter um objeto 4D View Pro de uma área 4D View armazenada em um BLOB:

    C_OBJECT($vpObj)
    $vpObj:=VP Convert from 4D View($pvblob)

    VP Convert to picture

    VP Convert to picture ( vpObject : Object {; rangeObj : Object} ) : Picture

    ParâmetroTipoDescrição
    vpObjectObject->Objeto 4D View Pro que contém a área a converter
    rangeObjObject->Objeto intervalo
    ResultadosImagem<-Imagem SVG da área

    |

    Descrição

    O comando VP Convert to picture converte o objeto vpObject 4D View Pro (ou o intervalo rangeObj dentro de vpObject) em uma imagem SVG.

    Este comando é útil, por exemplo:

    • para incorporar um documento 4D View Pro em outro documento, como um documento 4D Write Pro
    • para imprimir um documento do 4D View Pro sem ter que carregá-lo em uma área do 4D View Pro.

    Em vpObject, passe o objecto 4D View Pro que pretende converter. Esse objeto deve ter sido analisado anteriormente usando VP Export to object ou salvo usando VP EXPORT DOCUMENT.

    O processo de conversão de SVG exige que as expressões e os formatos (cf. Cell Format) incluídos na área do 4D View Pro sejam avaliados pelo menos uma vez, para que possam ser exportados corretamente. Se você converter um documento que não foi avaliado anteriormente, as expressões ou os formatos poderão ser renderizados de forma inesperada.

    Em rangeObj, passe um intervalo de células a ser convertido. Por padrão, se esse parâmetro for omitido, todo o conteúdo do documento será convertido.

    O conteúdo do documento é convertido com relação aos seus atributos de visualização, incluindo formatos (veja a observação acima), visibilidade de cabeçalhos, colunas e linhas. Há suporte para a conversão dos seguintes elementos:

    • Texto: estilo / fonte / tamanho / alinhamento / orientação / rotação / formato
    • Fundo da célula: cor / imagem
    • Borda das células: espessura / cor / estilo
    • Fusão de células
    • Imagens
    • Altura da linha
    • Largura da coluna
    • Colunas/linhas ocultas.

    Gridline visibility depends on document attribute defined with VP SET PRINT INFO.

    Resultado

    O comando devolve uma imagem em formato SVG.

    Exemplo

    Pretende converter uma área 4D View Pro em SVG, pré-visualizar o resultado e enviá-lo para uma variável imagem:

    C_OBJECT($vpAreaObj)
    C_PICTURE($vPict)
    $vpAreaObj:=VP Export to object("ViewProArea")
    $vPict:=VP Convert to picture($vpAreaObj) //exportar toda a área

    Veja também

    VP EXPORT DOCUMENT
    VP Export to object
    VP SET PRINT INFO

    VP Copy to object

    Histórico
    ReleaseMudanças
    19 R4Adicionado

    VP Copy to object ( rangeObj : Object {; options : Object} ) : Object

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    optionsObject->Opções adicionais
    ResultadosObject<-Objecto devolvido. Contém os dados copiados

    |

    Descrição

    O comando VP Copy to object copia o conteúdo, o estilo e as fórmulas de rangeObj para um objeto.

    Em rangeObj, passe o intervalo de células com os valores, a formatação e as fórmulas a serem copiadas. Se rangeObj for um intervalo combinado, somente o primeiro será usado.

    Você pode passar um parâmetro opcional options com as seguintes propriedades:

    PropriedadeTipoDescrição
    copyParâmetrosTrue (padrão) para manter os valores copiados, a formatação e as fórmulas após a execução do comando. False para os remover.
    copyOptionsIntegerEspecifica o que é copiado ou movido. Valores possíveis:

    ValorDescrição
    vk clipboard options all (padrão)Copia todos os objetos de dados, incluindo valores, formatação e fórmulas.
    vk clipboard options formattingCopia apenas a formatação.
    vk clipboard options formulasCopia apenas as fórmulas.
    vk clipboard options formulas and formattingCopia as fórmulas e a formatação.
    vk clipboard options valuesCopia apenas os valores.
    vk clipboard options value and formattingCopia os valores e a formatação.

    As opções de colagem definidas nas opções da pasta de trabalho são levadas em consideração.

    O comando retorna um objeto que contém os dados copiados.

    Exemplo

    Esse exemplo de código primeiro armazena o conteúdo, os valores, a formatação e as fórmulas de um intervalo em um objeto e, em seguida, cola-os em outro intervalo:

    var $originRange; $targetRange; $dataObject; $options : Object

    $originRange:=VP Cells("ViewProArea"; 0; 0; 2; 5)

    $options:=New object
    $options.copy:=True
    $options.copyOptions:=vk clipboard options all

    $dataObject:=VP Copy to object($originRange; $options)

    $targetRange:=VP Cell("ViewProArea"; 4; 0)
    VP PASTE FROM OBJECT($targetRange; $dataObject; vk clipboard options all)

    Veja também

    VP PASTE FROM OBJECT
    VP MOVE CELLS
    VP Get workbook options
    VP SET WORKBOOK OPTIONS

    VP CREATE TABLE

    Histórico
    ReleaseMudanças
    19 R8Suporte das opções de tema: bandColumns, bandRows, highlightFirstColumn, highlightLastColumn, theme
    18 R6Suporte da opção allowAutoExpand
    19 R6Adicionado

    VP CREATE TABLE ( rangeObj : Object ; tableName : Text {; source : Text} {; options : cs. ViewPro. TableOptions} )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    tableNameText->Nome da tabela
    sourceText->Nome da propriedade de contexto de dados a apresentar na tabela
    optionscs. ViewPro. TableOptions->Opções adicionais

    |

    Descrição

    O comando VP CREATE TABLE cria uma tabela no intervalo especificado. É possível criar uma tabela em um intervalo de células para facilitar o gerenciamento e a análise de um grupo de dados relacionados. Em geral, uma tabela contém dados relacionados em linhas e colunas e aproveita o contexto de dados .

    Em rangeObj, passe o intervalo de células em que a tabela será criada.

    Em tableName, introduza um nome para a tabela. O nome deve:

    • ser único na folha
    • incluir pelo menos 5 caracteres
    • não incluir espaços ou começar com um número

    Na fonte, você pode passar um nome de propriedade de um contexto de dados para exibir seus dados na tabela. Isto liga a tabela ao contexto de dados. Quando o contexto de dados é atualizado, os dados exibidos na tabela são atualizados de acordo. A propriedade source deve conter uma coleção de objetos e cada elemento representa uma linha.

    • Se você não especificar uma fonte, o comando criará uma tabela vazia com o tamanho definido em rangeObj.
    • Se a fonte especificada não puder ser totalmente exibida no documento, nenhuma tabela será criada.

    No parâmetro options , passe um objeto da classe cs.ViewPro.TableOptions que contém as propriedades da tabela a serem definidas.

    No objeto options , a coleção tableColumns determina a estrutura das colunas da tabela. O comprimento da coleção tableColumns deve ser igual à contagem de colunas do intervalo:

    • Quando a contagem de colunas em rangeObj excede o número de colunas em tableColumns, a tabela é preenchida com colunas vazias adicionais.
    • Quando a contagem de colunas em rangeObj é inferior ao número de tableColumns, a tabela exibe um número de colunas que corresponde à contagem de colunas do intervalo.

    Se você passar uma fonte ** , mas não passar a opção tableColumn , o comando gerará colunas automaticamente. Neste caso, rangeObj tem de ser um intervalo de células. Caso contrário, é utilizada a primeira célula do intervalo. Ao gerar colunas automaticamente, as seguintes regras se aplicam:

    • Se os dados passados para o comando forem uma coleção de objetos, os nomes das propriedades serão usados como títulos de coluna. Por exemplo:
    ([{ LastName: \"Freehafer\", FirstName: \"Nancy\"},{ LastName: \"John\", FirstName: \"Doe\"})

    Aqui, os títulos das colunas seriam LastName e FirstName.

    • Se os dados passados para o comando forem uma coleção de valores escalares, eles deverão conter uma coleção de subcoleções:

      • A coleção de primeiro nível contém subcoleções de valores. Cada subcolecção define uma linha. Passa uma coleção vazia para saltar uma linha. O número de valores na primeira subcoleção determina quantas colunas são criadas.
      • Os índices das subcoleções são utilizados como títulos das colunas.
      • Cada subcoleção define os valores das células para a linha. Os valores podem ser Integer, Real, Boolean, Text, Date, Null, Time ou Picture. Um valor Time deve ser um objeto que contenha um atributo de tempo, conforme descrito em VP SET VALUE.

    Isto só funciona quando se geram colunas automaticamente. Não é possível usar uma coleção de dados escalares com a opção tableColumns .

    Exemplo

    Para criar uma tabela utilizando um contexto de dados:

    // Set a data context
    var $data : Object

    $data:=New object()
    $data.people:=New collection()
    $data.people.push(New object("firstName"; "John"; "lastName"; "Smith"; "email"; "johnsmith@gmail.com"))
    $data.people.push(New object("firstName"; "Mary"; "lastName"; "Poppins"; "email"; "marypoppins@gmail.com")) VP SET DATA CONTEXT("ViewProArea"; $data)

    // Define the columns for the table
    var $options : cs. ViewPro. TableOptions

    $options:=cs. ViewPro. TableOptions.new()
    $options.tableColumns:=New collection()
    $options.tableColumns.push(cs. ViewPro. TableColumns.new("name"; "First name"; "dataField"; "firstName"))
    $options.tableColumns.push(cs. ViewPro. TableColumns.new("name"; "Last name"; "dataField"; "lastName"))
    $options.tableColumns.push(cs. ViewPro. TableColumns.new("name"; "Email"; "dataField"; "email"))

    // Create a table from the "people" collection VP CREATE TABLE(VP Cells("ViewProArea"; 1; 1; $options.tableColumns.length; 1); "ContextTable"; "people"; $options)

    Aqui está o resultado:

    Veja também

    VP Find table
    VP Get table column attributes
    VP Get table column index
    VP INSERT TABLE COLUMNS
    VP INSERT TABLE ROWS
    VP REMOVE TABLE
    VP RESIZE TABLE
    VP SET DATA CONTEXT
    VP SET TABLE COLUMN ATTRIBUTES
    VP SET TABLE THEME

    D

    VP DELETE COLUMNS

    VP DELETE COLUMNS ( rangeObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    |

    Descrição

    O comando VP DELETE COLUMNS remove as colunas do intervalo rangeObj.

    Em rangeObj, passe um objeto que contenha um intervalo de colunas a remover. Se o intervalo passado contiver:

    • tanto colunas como linhas, apenas as colunas são removidas.
    • apenas linhas, o comando não faz nada.

    Columns are deleted from right to left.

    Exemplo

    Para eliminar as colunas seleccionadas pelo utilizador (colunas B, C e D da imagem abaixo):

    utilizar o seguinte código:

    VP DELETE COLUMNS(VP Get selection("ViewProArea"))

    Veja também

    VP All
    VP Cells
    VP Column

    VP DELETE ROWS

    VP DELETE ROWS ( rangeObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    |

    Descrição

    O comando VP DELETE ROWS remove as linhas do rangeObj.

    Em rangeObj, passe um objeto que contenha um intervalo de linhas a remover. Se o intervalo passado contiver:

    • tanto colunas como linhas, apenas as linhas são removidas.
    • apenas colunas, o comando não faz nada.

    Rows are deleted from bottom to top.

    Exemplo

    Para eliminar as linhas selecionadas pelo usuário (na imagem abaixo, as linhas 1, 2 e 3):

    utilizar o seguinte código:


    VP DELETE ROWS(VP Get selection("ViewProArea"))

    Veja também

    VP All
    VP Cells
    VP Column

    E

    VP EXPORT DOCUMENT

    VP EXPORT DOCUMENT ( vpAreaName : Text ; filePath : Text {; paramObj : Object} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    filePathText->Caminho do documento
    paramObjObject->Opções de exportação

    |

    Descrição

    O comando VP EXPORT DOCUMENT Exporta o objeto do 4D View Pro anexado à área do 4D View Pro vpAreaName para um documento no disco de acordo com os parâmetros filePath e paramObj.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Em filePath, passe o caminho de destino e o nome do documento a ser exportado. Se você não especificar um caminho, o documento será salvo no mesmo nível da pasta Project.

    Você pode especificar o formato do arquivo exportado incluindo uma extensão após o nome do documento:

    • 4D View Pro (".4vp")
    • Microsoft Excel (".xlsx")
    • PDF (".pdf")
    • CSV (".txt", ou ".csv")

    Se a extensão não for incluída, mas o formato for especificado em paramObj, o arquivo exportado terá a extensão que corresponde ao formato, exceto para o formato CSV (nenhuma extensão é adicionada nesse caso).

    O parâmetro opcional paramObj permite definir várias propriedades para o objeto 4D View Pro exportado, bem como iniciar um método de retorno de chamada quando a exportação for concluída.

    PropriedadeTipoDescrição
    formattext(optional) When present, designates the exported file format: ".4vp" (default), ".csv", ".xlsx", or ".pdf". É possível utilizar as seguintes constantes:
  • vk 4D View Pro format
  • vk csv format
  • vk MS Excel format
  • vk pdf format
  • 4D adiciona a extensão apropriada ao nome do arquivo se necessário. Se o formato especificado não corresponder à extensão em filePath, ele será adicionado ao final de filePath. Se um formato não for especificado e nenhuma extensão for fornecida em filePath, o formato de arquivo padrão será usado.
    senhatextSomente Microsoft Excel (opcional) - Senha usada para proteger o documento do MS Excel
    formulaobjectMétodo de retorno de chamada a ser lançado quando a exportação estiver concluída. O uso de um método de retorno de chamada é necessário quando a exportação é assíncrona (que é o caso dos formatos PDF e Excel) se você precisar que algum código seja executado após a exportação. O método callback deve ser usado com o comando Formula (veja abaixo para obter mais informações).
    valuesOnlybooleanEspecifica que somente os valores das fórmulas (se houver) serão exportados.
    includeFormatInfobooleanVerdadeiro para incluir informações de formatação; caso contrário, falso (o padrão é verdadeiro). As informações de formatação são úteis em alguns casos, por exemplo, para exportação para SVG. Por outro lado, definir essa propriedade como false permite reduzir o tempo de exportação.
    includeBindingSourceParâmetros4DVP e Microsoft Excel apenas. True (padrão) para exportar os valores do contexto de dados atual como valores de célula no documento exportado (os contextos de dados em si não são exportados). Caso contrário, false. Cell binding sempre é exportada. Para o gerenciamento do contexto de dados e da vinculação de células, consulte VP SET DATA CONTEXT e VP SET BINDING PATH.
    sheetIndexnumberSomente PDF (opcional) - Índice da planilha a ser exportada (a partir de 0). -2=todas as planilhas visíveis (default), -1=apenas a planilha atual
    pdfOptionsobjectApenas PDF (opcional) - Opções para exportação de PDF

    PropriedadeTipoDescrição
    creatortextnome do aplicativo que criou o documento original a partir do qual ele foi convertido.
    titletexttítulo do documento.
    autortextnome da pessoa que criou o documento.
    keywordstextpalavras-chave associadas ao documento.
    subjecttextassunto do documento.

    csvOptionsobjectApenas CSV (opcional) - Opções para exportação csv

    PropriedadeTipoDescrição
    rangeobjectObjeto intervalo de células
    rowDelimitertextDelimitador de linha. Padrão: "\r\n"
    columnDelimitertextDelimitador de coluna. O padrão: ","

    \<customProperty>anyQualquer propriedade personalizada que estará disponível por meio do parâmetro $3 no método de retorno de chamada.

    Notas sobre o formato Excel:

    • Ao exportar um documento do 4D View Pro para um arquivo no formato Microsoft Excel, algumas configurações podem ser perdidas. Por exemplo, os métodos e fórmulas 4D não são suportados pelo Excel. Você pode verificar outras configurações com essa lista do GrapeCity.
    • A exportação nesse formato é executada de forma assíncrona; use a fórmula ** propriedade do paramObj ** para o código a ser executado após a exportação.

    Notas sobre o formato PDF:

    • Ao exportar um documento do 4D View Pro em PDF, as fontes usadas no documento são automaticamente incorporadas ao arquivo PDF. Somente fontes OpenType (arquivos .OTF ou .TTF) com um mapa Unicode podem ser incorporadas. Se não for encontrado nenhum arquivo de fonte válido para uma fonte, será usada uma fonte padrão.
    • A exportação nesse formato é executada de forma assíncrona; use a fórmula ** propriedade do paramObj ** para o código a ser executado após a exportação.

    Notas sobre o formato CSV:

    • Ao exportar um documento do 4D View Pro para CSV, algumas configurações podem ser perdidas, pois somente o texto e os valores são salvos.
    • Todos os valores são guardados como cadeias de caracteres entre aspas duplas. Para obter mais informações sobre valores separados por delimitadores, consulte este artigo na Wikipedia.

    Após a conclusão da operação de exportação, o VP EXPORT DOCUMENT aciona automaticamente a execução do método definido na propriedade formula do paramObj, se usado.

    Passagem de um método de retorno de chamada (fórmula)

    When including the optional paramObj parameter, the VP EXPORT DOCUMENT command allows you to use the Formula command to call a 4D method which will be executed once the export has completed. O método de retorno de chamada receberá os seguintes valores em variáveis locais:

    VariávelTipoDescrição
    $1textO nome do objeto de área 4D View Pro
    $2textO caminho do ficheiro do objeto 4D View Pro exportado
    $3objectUma referência ao paramObj do comando
    $4objectUm objeto devolvido pelo método com uma mensagem de estado
    .successbooleanTrue se a exportação for bem sucedida, False caso contrário.
    .errorCodeintegerCódigo de erro. Pode ser devolvido por 4D ou JavaScript.
    .errorMessagetextMensagem de erro. Pode ser devolvido por 4D ou JavaScript.

    Exemplo 1

    Pretende exportar o conteúdo da área "VPArea" para um documento 4D View Pro no disco:

    var $docPath: Text

    $docPath:="C:\\Bases\\ViewProDocs\\MyExport.4VP" VP EXPORT DOCUMENT("VPArea";$docPath)
    //MyExport.4VP is saved on your disk

    Exemplo 2

    Pretende exportar a folha atual em PDF:

    var $params: Object
    $params:=New object
    $params.format:=vk pdf format
    $params.sheetIndex:=-1
    $params.pdfOptions:=New object("title";"Annual Report";"author";Current user)
    VP EXPORT DOCUMENT("VPArea";"report.pdf";$params)

    Exemplo 3

    Você deseja exportar um documento do 4D View Pro no formato ".xlsx" e chamar um método que iniciará o Microsoft Excel com o documento aberto após a conclusão da exportação:

     $params:=New object
    $params.formula:=Formula(AfterExport)
    $params.format:=vk MS Excel format //".xlsx"
    $params.valuesOnly:=True

    VP EXPORT DOCUMENT("ViewProArea";"c:\\tmp\\convertedfile";$params)

    Método AfterExport:

     C_TEXT($1;$2)
    C_OBJECT($3;$4)
    $areaName:=$1
    $filePath:=$2
    $params:=$3
    $status:=$4

    If($status.success=False)
    ALERT($status.errorMessage)
    Else
    LAUNCH EXTERNAL PROCESS("C:\\Program Files\\Microsoft Office\\Office15\\excel "+$filePath)
    End if

    Exemplo

    Pretende exportar a folha atual para um ficheiro .txt com valores separados por "|":

    example-export-csv

    var $params : Object
    $params:=New object
    $params.range:=VP Cells("ViewProArea";0;0;2;5)
    $params.rowDelimiter:="\n"
    $params.columnDelimiter:="|" VP EXPORT DOCUMENT("ViewProArea";"c:\\tmp\\data.txt";New object("format";vk csv format;"csvOptions";$params))

    Aqui está o resultado:

    example-export-csv

    Veja também

    VP Convert to picture
    VP Export to object
    VP Column
    VP Print

    VP Export to object

    VP Export to object ( vpAreaName : Text {; options : Object} ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    optionsObject->Opções de exportação
    ResultadosObject<-Objeto 4D View Pro

    |

    Descrição

    O comando VP Export to object Retorna o objeto do 4D View Pro anexado à área do 4D View Pro vpAreaName. Você pode usar esse comando, por exemplo, para armazenar a área do 4D View Pro em um campo de objeto do banco de dados 4D.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    No parâmetro options , você pode passar as seguintes opções de exportação, se necessário:

    PropriedadeTipoDescrição
    includeFormatInfoParâmetrosVerdadeiro (padrão) para incluir informações de formatação; caso contrário, falso. As informações de formatação são úteis em alguns casos, por exemplo, para exportação para SVG. Por outro lado, a definição dessa propriedade como False permite reduzir o tempo de exportação.
    includeBindingSourceParâmetrosTrue (padrão) para exportar os valores do contexto de dados atual como valores de célula no objeto exportado (os contextos de dados em si não são exportados). Caso contrário, false. Cell binding sempre é exportada.

    Para mais informações sobre os objectos 4D View Pro, consulte o parágrafo objeto 4D View Pro.

    Exemplo 1

    Você deseja obter a propriedade "version" da área atual do 4D View Pro:

    var $vpAreaObj : Object
    var $vpVersion : Number
    $vpAreaObj:=VP Export to object("vpArea")
    // $vpVersion:=OB Get($vpAreaObj;"version")
    $vpVersion:=$vpAreaObj.version

    Exemplo 2

    Pretende-se exportar a área, excluindo a informação de formatação:

    var $vpObj : Object
    $vpObj:=VP Export to object("vpArea";New object("includeFormatInfo";False))

    Veja também

    VP Convert to picture
    VP EXPORT DOCUMENT
    VP IMPORT FROM OBJECT

    F

    VP Find

    VP Find ( rangeObj : Object ; searchValue : Text ) : Object
    VP Find ( rangeObj : Object ; searchValue : Text ; searchCondition : Object } ) : Object
    VP Find ( rangeObj : Object ; searchValue : Text ; searchCondition : Object ; replaceValue : Text ) : Object

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    searchValueText->Valor da pesquisa
    searchConditionObject->Objeto que contém condição(ões) de pesquisa
    replaceValueText->Valor de substituição
    ResultadosObject<-Objeto intervalo

    |

    Descrição

    O comando VP Find pesquisa o rangeObj para o searchValue. Podem ser utilizados parâmetros opcionais para refinar a pesquisa e/ou substituir quaisquer resultados encontrados.

    No parâmetro rangeObj , passe um objeto que contenha um intervalo a ser pesquisado.

    O parâmetro searchValue permite que você passe o texto a ser pesquisado dentro do rangeObj.

    Você pode passar o parâmetro opcional searchCondition para especificar como a pesquisa é realizada. As propriedades abaixo são compatíveis:

    PropriedadeTipoDescrição
    afterColumnIntegerO número da coluna imediatamente anterior à coluna inicial da pesquisa. Se o rangeObj for um intervalo combinado, o número da coluna fornecido deverá ser do primeiro intervalo. Valor padrão: -1 (início do intervalo rangeObj)
    afterRowIntegerO número da linha imediatamente anterior à linha inicial da pesquisa. Se o rangeObj for um intervalo combinado, o número da linha fornecido deverá ser do primeiro intervalo. Valor padrão: -1 (início do intervalo rangeObj)
    allParâmetros
  • True - Todas as células em rangeObj correspondentes a searchValue são retornadas
  • False - (valor padrão) Somente a primeira célula em rangeObj correspondente a searchValue é retornada
  • flagsInteger
    vk find flag exact matchTodo o conteúdo da célula deve corresponder completamente ao valor da pesquisa
    vk find flag ignore caseAs letras maiúsculas e minúsculas são consideradas iguais. Ex: "a" é o mesmo que "A".
    vk find flag nonenenhum sinalizador de pesquisa é considerado (padrão)
    vk find flag use wild cardsCaracteres curinga (*,?) podem ser usados na cadeia de pesquisa. Os caracteres curinga podem ser usados em qualquer comparação de cadeia de caracteres para corresponder a qualquer número de caracteres:
  • * para zero ou vários caracteres (por exemplo, a busca por "bl*" pode encontrar "bl", "black" ou "blob")
  • ? para um único caractere (por exemplo, a busca por "h?t" pode encontrar "hot" ou "hit")
  • Esses marcadores podem ser combinados. Por exemplo: $search.flags:=vk find flag use wild cards+vk find flag ignore case
    orderInteger
    vk find order by columnsA pesquisa é efectuada por colunas. Cada linha de uma coluna é pesquisada antes que a pesquisa continue para a próxima coluna.
    vk find order by rowsA pesquisa é efectuada por linhas. Cada coluna de uma linha é pesquisada antes de a pesquisa continuar para a próxima linha (padrão)
    targetInteger
    vk find target formulaA pesquisa é efectuada na fórmula da célula
    vk find target tagA pesquisa é efetuada na etiqueta da célula
    vk find target textA pesquisa é efetuada no texto da célula (padrão)

    Esses marcadores podem ser combinados. Por exemplo:$search.target:=vk find target formula+vk find target text

    No parâmetro opcional replaceValue , você pode passar o texto para substituir qualquer instância do texto em searchValue encontrado no rangeObj.

    Objecto devolvido

    A função retorna um objeto de intervalo que descreve cada valor de pesquisa que foi encontrado ou substituído. É devolvido um objeto de intervalo vazio se não forem encontrados resultados.

    Exemplo 1

    Para encontrar a primeira célula que contém a palavra "Total":

    var $range;$result : Object

    $range:=VP All("ViewProArea")

    $result:=VP Find($range;"Total")

    Exemplo 2

    Para encontrar "Total" e substituí-lo por "Total geral":

    var $range;$condition;$result : Object

    $range:=VP All("ViewProArea")

    $condition:=New object
    $condition.target:=vk find target text
    $condition.all:=True //Search entire document
    $condition.flags:=vk find flag exact match

    // Replace the cells containing only 'Total' in the current sheet with "Grand Total"
    $result:=VP Find($range;"Total";$condition;"Grand Total")

    // Check for empty range object
    If($result.ranges.length=0)
    ALERT("No result found")
    Else
    ALERT($result.ranges.length+" results found")
    End if

    VP Find table

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP Find table ( rangeObj : Object ) : Text

    ParâmetroTipoDescrição
    rangeObjObject->Intervalo de células
    ResultadosText<-Nome da tabela

    |

    Descrição

    O comando VP Find table devolve o nome da tabela à qual pertence à célula rangeObj.

    Em rangeObj, passar um objeto de intervalo de células. Se as células designadas não pertencerem a uma tabela, o comando retornará uma string vazia.

    Se rangeObj não for um intervalo de células ou contiver vários intervalos, será usada a primeira célula do primeiro intervalo.

    Exemplo

    If (FORM Event.code=On After Edit && FORM Event.action="valueChanged")
    $tableName:=VP Find table(FORM Event.range)
    If ($tableName#"")
    ALERT("The "+$tableName+" table has been modified.")
    End if
    End if
    End if

    Veja também

    VP Get table range

    VP FLUSH COMMANDS

    VP FLUSH COMMANDS ( vpAreaName : Text )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário

    |

    Descrição

    O comando VP FLUSH COMMANDS executa imediatamente os comandos armazenados e limpa o buffer de comandos.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Para aumentar o desempenho e reduzir o número de solicitações enviadas, os comandos do 4D View Pro chamados pelo desenvolvedor são armazenados em um buffer de comando. Quando chamado, VP FLUSH COMMANDS executa os comandos como um lote ao sair do método e esvazia o conteúdo do buffer de comandos.

    Exemplo

    Você deseja rastrear a execução dos comandos e esvaziar o buffer de comandos:


    VP SET TEXT VALUE(VP Cell("ViewProArea1";10;1);"INVOICE")
    VP SET TEXT VALUE(VP Cell("ViewProArea1";10;2);"Invoice date: ")
    VP SET TEXT VALUE(VP Cell("ViewProArea1";10;3);"Due date: ")

    VP FLUSH COMMANDS(("ViewProArea1")
    TRACE

    VP Font to object

    VP Font to object ( font : Text ) : Object

    ParâmetroTipoDescrição
    fontText->Cadeia de caracteres abreviada da fonte
    ResultadosObject<-Objecto letra

    Descrição

    O comando utilitário VP Font to object devolve um objeto a partir de uma cadeia de caracteres abreviada. Esse objeto pode ser usado para definir ou obter configurações de propriedade de fonte por meio de notação de objeto.

    No parâmetro font , passe uma cadeia de caracteres abreviada de fonte para especificar as diferentes propriedades de uma fonte (por exemplo, "12 pt Arial"). Você pode saber mais sobre as cadeias de caracteres abreviadas de fontes nesta página , por exemplo.

    O objeto retornado contém atributos de fonte definidos como propriedades. Para obter mais informações sobre as propriedades disponíveis, consulte o comando VP Object to font .

    Exemplo 1

    Este código:

    $font:=VP Font to object("16pt arial")

    devolverá o seguinte objeto $font:

    {

    family:arial
    size:16pt
    }

    Exemplo 2

    Ver exemplo para VP Object to font.

    Veja também

    4D View Pro Style Objects and Style Sheets
    VP Object to font
    VP SET CELL STYLE
    VP SET DEFAULT STYLE

    G

    VP Get active cell

    VP Get active cell ( vpAreaName : Text { ; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objeto intervalo de uma única célula

    |

    Descrição

    O comando VP Get active cell retorna um novo objeto de intervalo referenciando a célula que tem o foco e onde os novos dados serão inseridos (a célula ativa).

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    No parâmetro opcional sheet, pode designar uma folha específica onde o intervalo será definido (a contagem começa em 0). Se for omisso ou se passar vk current sheet, é utilizada a folha de cálculo atual.

    Exemplo

    O código seguinte irá obter as coordenadas da célula ativa:

    $activeCell:=VP Get active cell("myVPArea")

    //returns a range object containing:
    //$activeCell.ranges[0].column=3
    //$activeCell.ranges[0].row=4
    //$activeCell.ranges[0].sheet=0

    Veja também

    VP ADD SELECTION
    VP Get selection
    VP RESET SELECTION
    VP SET ACTIVE CELL
    VP SET SELECTION
    VP SHOW CELL

    VP Get binding path

    Histórico
    ReleaseMudanças
    19 R5Adicionado

    VP Get binding path ( rangeObj : Object ) : Text

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    ResultadosText<-Nome do atributo ligado à célula

    |

    Descrição

    O comando VP Get binding path devolve o nome do atributo ligado à célula especificada em rangeObj.

    Em rangeObj, passe um objeto que seja um intervalo de células ou um intervalo combinado de células. Note que:

    • Se rangeObj for um intervalo com várias células, o comando retornará o nome do atributo vinculado à primeira célula do intervalo.
    • Se rangeObj contiver vários intervalos de células, o comando retornará o nome do atributo vinculado à primeira célula do primeiro intervalo.

    Exemplo

    var $p; $options : Object
    var $myAttribute : Text

    $p:=New object
    $p.firstName:="Freehafer"
    $p.lastName:="Nancy" VP SET DATA CONTEXT("ViewProArea"; $p) VP SET BINDING PATH(VP Cell("ViewProArea"; 0; 0); "firstName")
    VP SET BINDING PATH(VP Cell("ViewProArea"; 1; 0); "lastName")

    $myAttribute:=VP Get binding path(VP Cell("ViewProArea"; 1; 0)) // "lastName"

    Veja também

    VP SET BINDING PATH
    VP Get data context
    VP SET DATA CONTEXT

    VP Get cell style

    VP Get cell style ( rangeObj : Object ) : Object

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    ResultadosObject<-Objecto style

    |

    Descrição

    O comando VP Get cell style devolve um objeto estilo para a primeira célula de rangeObj.

    Em rangeObj, passe um intervalo que contenha o estilo a ser recuperado.

    • Se rangeObj contiver um intervalo de células, o estilo da célula será retornado.
    • Se rangeObj contiver um intervalo que não seja um intervalo de células, o estilo da primeira célula do intervalo será retornado.
    • Se rangeObj contiver vários intervalos, somente o estilo da primeira célula do primeiro intervalo será retornado.

    Exemplo

    Para obter os detalhes sobre o estilo na célula selecionada (B2):

    Este código:

    $cellStyle:=VP Get cell style(VP Get selection("myDoc"))

    ... devolverá este objecto:

    {
    "backColor":"Azure",
    "borderBottom":
    {
    "color":#800080,
    "style":5
    }
    "font":"8pt Arial",
    "foreColor":"red",
    "hAlign":1,
    "isVerticalText":"true",
    "vAlign":0
    }

    Veja também

    VP GET DEFAULT STYLE
    VP SET CELL STYLE

    VP Get column attributes

    VP Get column attributes ( rangeObj : Object ) : Collection

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    ResultadosCollection<-Coleção de propriedades da colunas

    |

    Descrição

    O comando VP Get column attributes devolve um conjunto de propriedades para as colunas de rangeObj.

    Em rangeObj, passe um objeto que contenha um intervalo das colunas cujos atributos serão recuperados.

    A coleção retornada contém todas as propriedades das colunas, independentemente de terem sido definidas ou não pelo comando VP SET COLUMN ATTRIBUTES .

    Exemplo

    O seguinte código:

    C_OBJECT($range)
    C_COLLECTION($attr)

    $range:=VP Column("ViewProArea";1;2)
    $attr:=VP Get column attributes($range)

    ... devolverá uma coleção dos atributos no intervalo dado:

    Veja também

    VP Get row attributes
    VP SET COLUMN ATTRIBUTES
    VP SET ROW ATTRIBUTES

    VP Get column count

    VP Get column count ( vpAreaName : Text { ; sheet : Integer } ) : Integer

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosInteger<-Número total de colunas

    |

    Descrição

    O comando VP Get column count devolve o número total de colunas da sheet designada.

    Em vpAreaName, passe o nome da propriedade da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Você pode definir onde obter a contagem de colunas no parâmetro opcional sheet usando o índice da planilha (a contagem começa em 0). Se for omisso ou se passar vk current sheet, é utilizada a folha de cálculo atual.

    Exemplo

    O código seguinte retorna o número de colunas na área 4D View Pro:

    C_INTEGER($colCount)
    $colCount:=VP Get column count("ViewProarea")

    Veja também

    VP Get row count
    VP SET COLUMN COUNT
    VP SET ROW COUNT

    VP Get current sheet

    VP Get current sheet ( vpAreaName : Text )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    ResultadoInteger<-Índice da folha actual

    |

    Descrição

    O comando VP Get current sheet retorna o índice da planilha atual em vpAreaName. A folha atual é a folha selecionada no documento.

    Em vpAreaName, passe o nome da área 4D View Pro.

    A indexação começa em 0.

    Exemplo

    Quando a terceira folha é selecionada:

    third-sheet

    O comando devolve 2:

    $index:=VP Get current sheet("ViewProArea")

    Veja também

    VP SET CURRENT SHEET

    VP Get data context

    Histórico
    ReleaseMudanças
    19 R5Adicionado

    VP Get data context ( vpAreaName : Text {; sheet : Integer } ) : any

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da folha a partir da qual se obtém o contexto de dados
    ResultadosObject | Collection<-Contexto de dados

    |

    Descrição

    O comando VP Get data context devolve o data context atual de uma folha de cálculo. O contexto retornado inclui todas as modificações feitas no conteúdo do contexto de dados.

    Em sheet, passe o índice da planilha para obter o contexto de dados. Se nenhum índice for passado, o comando retornará o contexto de dados da planilha atual. Se não houver contexto para a planilha, o comando retornará Null.

    A função retorna um objeto ou uma coleção, dependendo do tipo de contexto de dados definido com VP SET DATA CONTEXT.

    Exemplo

    Para obter o contexto de dados ligado às células seguintes:

    var $dataContext : Object

    $dataContext:=VP Get data context("ViewProArea") // {firstName:Freehafer,lastName:Nancy}

    Veja também

    VP SET DATA CONTEXT
    VP Get binding path
    VP SET BINDING PATH

    VP Get default style

    VP Get default style ( vpAreaName : Text { ; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Parâmetros de estilo padrão

    |

    Descrição

    O comando VP Get default style devolve um objeto style por padrão para uma folha. O objeto retornado contém propriedades básicas de renderização de documentos, bem como as configurações de estilo padrão (se houver) previamente definidas pelo método VP SET DEFAULT STYLE . Para obter mais informações sobre propriedades de estilo, consulte Style Objects & Style Sheets.

    Em vpAreaName, passe o nome da propriedade da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Você pode definir onde obter a contagem de colunas no parâmetro opcional sheet usando o índice da planilha (a contagem começa em 0). Se for omisso ou se passar vk current sheet, é utilizada a folha de cálculo atual.

    Exemplo

    Para obter os detalhes sobre o estilo predefinido para este documento:

    Este código:

    $defaultStyle:=VP Get default style("myDoc")

    devolverá esta informação no objeto $defaultStyle:

    {
    backColor:#E6E6FA,
    hAlign:0,
    vAlign:0,
    font:12pt papyrus
    }

    Veja também

    VP Get cell style
    VP SET DEFAULT STYLE

    VP Get formula

    VP Get formula ( rangeObj : Object) : Text

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    ResultadosText<-Formula

    |

    Descrição

    O comando VP Get formula recupera a fórmula de um intervalo de células designado.

    Em rangeObj, passe um intervalo cuja fórmula você deseja recuperar. Se rangeObj designar várias células ou vários intervalos, uma fórmula é devolvida da primeira célula. Se rangeObj for uma célula sem fórmula, o método devolve uma string vazia.

    Exemplo

      //set a formula VP SET FORMULA(VP Cell("ViewProArea";5;2);"SUM($A$1:$C$10)")

    $result:=VP Get formula(VP Cell("ViewProArea";5;2)) // $result="SUM($A$1:$C$10)"

    Veja também

    VP Get formulas
    VP SET FORMULA
    VP SET ROW COUNT

    VP Get formula by name

    VP Get formula by name ( vpAreaName : Text ; name : Text { ; scope : Number } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    nameText->Nome do intervalo nomeado
    scopeNumber->Âmbito alvo (padrão=folha atual)
    ResultadosObject<-Definição da fórmula nomeada ou intervalo nomeado

    |

    Descrição

    O comando VP Get formula by name retorna a fórmula e comentários correspondentes ao intervalo nomeado ou formula nomeada passada no parâmetro name ou null se não existir no escopo definido.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Passe o intervalo com nome ou a fórmula com nome que quiser obter em name. Note que os intervalos com nome são devolvidos como fórmulas que contém referências absolutas de células.

    Pode definir onde obter a fórmula em scope utilizando o índice da folha (a numeração começa em 0) ou uma das constantes abaixo:

    • vk current sheet
    • vk workbook
    Objecto devolvido

    O objeto retornado contém as propriedades abaixo:

    PropriedadeTipoDescrição
    formulaTextTexto da fórmula correspondente à fórmula nomeada ou intervalo nomeado. Para os intervalos nomeados, a fórmula é uma sequência de coordenadas absolutas.
    commentTextComentário correspondente à fórmula nomeada ou ao intervalo nomeado

    Exemplo

    $range:=VP Cell("ViewProArea";0;0)
    VP ADD RANGE NAME("Total1";$range)

    $formula:=VP Get formula by name("ViewProArea";"Total1")
    //$formula.formula=Sheet1!$A$1

    $formula:=VP Get formula by name("ViewProArea";"Total")
    //$formula=null (if not existing)

    Veja também

    VP ADD FORMULA NAME
    VP Get names

    VP Get formulas

    VP Get formulas ( rangeObj : Object ) : Collection

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    ResultadosCollection<-Coleção de valores de uma fórmula

    |

    Descrição

    O comando VP Get formulas recupera as fórmulas de um rangeObj designado.

    Em rangeObj, passe um intervalo cuja fórmula você deseja recuperar. Se rangeObj designar vários intervalos, a fórmula do primeiro intervalo é devolvida Se rangeObj não contiver fórmulas, o comando retorna uma string vazia.

    A coleção devolvida é bidimensional:

    • A coleção de primeiro nível contém subcoleções de fórmulas. Cada subcolecção representa uma linha.
    • Cada subcoleção define os valores das células para a linha. The first-level collection contains subcollections of formulas.

    Exemplo

    Você deseja recuperar as fórmulas nas colunas Sum e Average desse documento:

    Pode utilizar este código:

    $formulas:=VP Get formulas(VP Cells("ViewProArea";5;1;2;3))
    //$formulas[0]=[Sum(B2:D2),Average(B2:D2)]
    //$formulas[1]=[Sum(B3:D3),Average(B3:D3)]
    //$formulas[2]=[Sum(B4:D4),Average(C4:D4)]

    Veja também

    VP Get formula
    VP Get values
    VP SET FORMULAS
    VP SET VALUES

    VP Get frozen panes

    VP Get frozen panes ( vpAreaName : Text { ; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objeto que contém as informações sobre as colunas e linhas congeladas

    |

    Descrição

    O comando VP Get frozen panes devolve um objeto com informações sobre as colunas e linhas congeladas em vpAreaName.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    No parâmetro opcional sheet, pode designar uma folha específica onde o intervalo será definido (a contagem começa em 0). Se for omisso ou se passar vk current sheet, é utilizada a folha de cálculo atual.

    Objeto devolvido

    O comando devolve um objeto que descreve as colunas e linhas congeladas. Este objeto pode conter as seguintes propriedades:

    PropriedadeTipoDescrição
    columnCountIntegerO número de colunas congeladas à esquerda da folha
    trailingColumnCountIntegerO número de colunas congeladas à direita da folha
    rowCountIntegerO número de linhas congeladas na parte superior da folha
    trailingRowCountIntegerO número de linhas congeladas na parte inferior da folha

    Exemplo

    Pretende obter informações sobre o número de colunas e linhas congeladas:

    var $panesObj : Object

    $panesObj:=VP Get frozen panes("ViewProArea")

    O objeto devolvido contém, por exemplo:

    Veja também

    VP SET FROZEN PANES

    VP Get names

    VP Get names ( vpAreaName : Text { ; scope : Number } ) : Collection

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    scopeNumber->Escopo de destino (padrão = planilha atual)
    ResultadosCollection<-Nomes existentes no âmbito definido

    |

    Descrição

    O comando VP Get names retorna uma coleção de todos "names" definidos na planilha atual ou no escopo escolhido pelo parâmetro scope.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Pode definir onde obter os nomes em scope usando o indice da planilha (contagem começa no 0) ou as constantes abaixo:

    • vk current sheet
    • vk workbook
    Coleção devolvida

    A coleção devolvida contém um objeto por nome. As seguintes propriedades do objeto podem ser devolvidas:

    PropriedadeTipoDescrição
    result[ ].nameTextnome da célula ou do intervalo
    result[ ].formulaTextformula
    result[ ].commentTextComentário associado ao nome

    Propriedades disponíveis dependendo do tipo de elemento nomeado (célula com nome, intervalo com nome ou fórmula com nome)

    Exemplo

    var $list : Collection


    $list:=VP Get names("ViewProArea";2) //nomes na 3ª folha

    Veja também

    VP ADD FORMULA NAME
    VP ADD RANGE NAME
    VP Get formula by name
    VP Name

    VP Get print info

    VP Get print info ( vpAreaName : Text { ; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objeto com informação de impressão

    |

    Descrição

    O comando VP Get print info retorna um objeto que contém os atributos de impressão do vpAreaName.

    Passe o nome da área 4D View Pro em vpAreaName. Se passar um nome que não existe, é devolvido um erro.

    No parâmetro opcional sheet , você pode designar uma planilha específica (a contagem começa em 0) cujos atributos de impressão você deseja retornar. Se for omisso ou se passar vk current sheet, é utilizada a folha de cálculo atual.

    Exemplo

    Este código:

    $pinfo:=VP Get print info("ViewProArea")

    ... retorna os atributos de impressão da área 4D View Pro definida no comando VP SET PRINT INFO:

    {
    bestFitColumns:false,
    bestFitRows:false,
    blackAndWhite:false,
    centering:0,
    columnEnd:8,
    columnStart:0,
    firstPageNumber:1,
    fitPagesTall:1,
    fitPagesWide:1,
    footerCenter:"&BS. H.I.E.L.D. &A Sales Per Region",
    footerCenterImage:,
    footerLeft:,
    footerLeftImage:,
    footerRight:"page &P of &N",
    footerRightImage:,
    headerCenter:,
    headerCenterImage:,
    headerLeft:"&G",
    headerLeftImage:logo.png,
    headerRight:,
    headerRightImage:,
    margin:{top:75,bottom:75,left:70,right:70,header:30,footer:30},
    orientation:2,
    pageOrder:0,
    pageRange:,
    paperSize:{width:850,height:1100,kind:1},
    qualityFactor:2,
    repeatColumnEnd:-1,
    repeatColumnStart:-1,
    repeatRowEnd:-1,
    repeatRowStart:-1,
    rowEnd:24,
    rowStart:0,
    showBorder:false,
    showColumnHeader:0,
    showGridLine:false,
    showRowHeader:0,
    useMax:true,
    watermark:[],
    zoomFactor:1
    }

    Veja também

    4D View Pro Print Attributes
    VP SET PRINT INFO

    VP Get row attributes

    VP Get row attributes ( rangeObj : Object ) : Collection

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    ResultadosCollection<-Coleção de propriedades de linha

    |

    Descrição

    O comando VP Get row attributes devolve um conjunto de propriedades para as linhas no rangeObj.

    En rangeObj, passe um objeto que contenha um intervalo de linhas cujos atributos serão recuperados.

    A coleção devolvida contém as propriedades das linhas, tenham ou não sido definidas pelo método VP SET ROW ATTRIBUTES.

    Exemplo

    O código seguinte retorna uma coleção de atributos no intervalo fornecido:

    var $range : Object
    var $attr : Collection

    $range:=VP Column("ViewProArea";1;2)
    $attr:=VP Get row attributes($range)

    Veja também

    VP Get column attributes
    VP SET COLUMN ATTRIBUTES
    VP SET ROW ATTRIBUTES

    VP Get row count

    VP Get row count ( vpAreaName : Text {; sheet : Integer } ) : Integer

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosInteger<-Número total de linhas

    |

    Descrição

    O comando VP Get row count devolve o número total de linhas da sheet designada.

    Em vpAreaName, passe o nome da propriedade da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Pode definir onde obter o número de linhas no parâmetro opcional sheet utilizando o índice da folha (a numeração começa em 0). Se for omisso ou se passar vk current sheet, é utilizada a folha de cálculo atual.

    Exemplo

    O código seguinte retorna o número de linhas na área 4D View Pro:

    var $rowCount : Integer
    $rowCount:=VP Get row count("ViewProarea")

    Veja também

    VP Get column count
    VP SET COLUMN COUNT
    VP SET ROW COUNT

    VP Get selection

    VP Get selection ( vpAreaName : Text {; sheet : Integer } ) ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objeto intervalo de células

    |

    Descrição

    O comando VP Get selection devolve um novo objeto intervalo que faz referência às células atualmente selecionadas.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    No parâmetro opcional sheet, pode designar uma folha específica onde o intervalo será definido (a contagem começa em 0). Se for omisso ou se passar vk current sheet, é utilizada a folha de cálculo atual.

    Exemplo

    O código seguinte recuperará as coordenadas de todas as células na seleção atual:

    $currentSelection:=VP Get selection("myVPArea")


    //retorna um objecto de intervalo que contém:
    //$currentSelection.ranges[0].column=5
    //$currentSelection.ranges[0].columnCount=2
    //$currentSelection.ranges[0].row=8
    //$currentSelection.ranges[0].rowCount=6

    Veja também

    VP ADD SELECTION
    VP Get active cell
    VP SET ACTIVE CELL
    VP SET SELECTION
    VP SHOW CELL

    VP Get sheet count

    VP Get sheet count ( vpAreaName : Text ) : Integer

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    ResultadoInteger<-Número de folhas

    |

    Descrição

    O comando VP Get sheet count devolve o número de folhas no documento carregado em vpAreaName.

    Em vpAreaName, passe o nome da área 4D View Pro.

    Exemplo

    No documento seguinte:

    Obter a contagem de folhas e definir a folha atual como a última folha:

     $count:=VP Get sheet count("ViewProArea")
    //definir a folha atual para a última folha (a indexação começa em 0)
    VP SET CURRENT SHEET("ViewProArea";$count-1)

    Veja também

    VP Get sheet index
    VP SET SHEET COUNT

    VP Get sheet index

    VP Get sheet index ( vpAreaName : Text ; name : Text ) : Integer

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    nameText->Nome da folha
    ResultadoInteger<-Índice da folha

    |

    Descrição

    If no sheet named name is found in the document, the method returns -1. In name, pass the name of the sheet whose index will be returned.

    Em vpAreaName, passe o nome da área 4D View Pro.

    In index, pass the index of the sheet to remove. If the passed index does not exist, the command does nothing.

    A indexação começa em 0.

    Exemplo

    No documento seguinte:

    Obter o índice da folha denominada "Total first quarter":

    $index:=VP Get sheet index("ViewProArea"; "Total do primeiro trimestre") //retorna 2

    Veja também

    VP Get sheet count
    VP Get sheet name

    VP Get sheet name

    VP Get sheet name ( vpAreaName : Text ; sheet : Integer ) : Text

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da folha
    ResultadoText<-Nome da folha

    |

    Descrição

    If sheet is omitted, the command applies to the current sheet. In sheet, pass the index of the target sheet.

    Em vpAreaName, passe o nome da área 4D View Pro.

    Em sheet, passe o índice da folha cujo nome será devolvido.

    Se o índice de folha passado não existir, o método devolve um nome vazio.

    A indexação começa em 0.

    Exemplo

    Obtém o nome da terceira folha do documento:

    $sheetName:=VP Get sheet name("ViewProArea";2)

    Veja também

    VP Get sheet index

    VP Get sheet options

    VP Get sheet options ( vpAreaName : Text {; sheet : Integer } ) ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objecto opções de folha

    |

    Descrição

    O comando VP Get sheet options retorna um objeto que contém os atributos atuais da área vpAreaName.

    Passe o nome da área 4D View Pro em vpAreaName. Se passar um nome que não existe, é devolvido um erro.

    No parâmetro opcional sheet, pode designar uma planilha específica (a contagem começa em 0). Se for omisso ou se passar vk current sheet, é utilizada a folha de cálculo atual.

    Objeto devolvido

    O método devolve um objeto que contém os valores atuais de todas as opções de folha disponíveis Um valor de uma opção pode ter sido modificado pelo usuário ou pelo método VP SET SHEET OPTIONS.

    Para ver a lista completa das opções, consulte Folha opções.

    Exemplo

    $options:=VP Get sheet options("ViewProArea")
    If($options.colHeaderVisible) //column headers are visible
    ... //do something End if

    Veja também

    4D VIEW PRO SHEET OPTIONS
    VP SET SHEET OPTIONS

    VP Get show print lines

    VP Get show print lines ( vpAreaName : Text {; sheet : Integer } ) : Boolean

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger<-Índice da folha
    ResultadoParâmetros<-True se as linhas de impressão forem visíveis, False caso contrário

    |

    Descrição

    returns True if the print preview lines are visible and False if they are hidden. O comando VP Get show print lines

    Em vpAreaName, passe o nome da área 4D View Pro.

    Em sheet, passe o índice da folha de destino. If no index is specified, the command applies to the current sheet.

    A indexação começa em 0.

    Exemplo

    O código abaixo comprova se as linhas de visualização prévia são mostradas ou ocultadas no documento:

     var $result : Boolean
    $result:=VP Get show print lines("ViewProArea";1)

    Veja também

    VP SET SHOW PRINT LINES

    VP Get spans

    VP Get spans ( rangeObj : Object ) : Object

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    ResultadosObject<-Objeto de células fundidas no intervalo definido

    |

    Descrição

    O comando VP Get spans recupera os intervalos de células no rangeObjdesignado.

    Em rangeObj, passe um intervalo de células fusionadas que queira recuperar. Se rangeObj não contiver um intervalo de células, um intervalo vazio será retornado.

    Exemplo

    Se quiser centrar o texto das células fusionadas neste documento:

    // Search for all cell spans
    $range:=VP Get spans(VP All("ViewProArea"))

    //center text
    $style:=New object("vAlign";vk vertical align center;"hAlign";vk horizontal align center)
    VP SET CELL STYLE($range;$style)

    Veja também

    VP ADD SPAN
    VP REMOVE SPAN

    VP Get stylesheet

    VP Get stylesheet ( vpAreaName : Text ; styleName : Text { ; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    styleNameText->Nome do estilo
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Objeto da folha de estilo

    |

    Descrição

    O comando VP Get stylesheet retorna o objeto de folha de estilo styleName que contém os valores da propriedade que foi definida.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Em styleName, passe o nome da folha de estilo a obter.

    Você pode designar onde definir a folha de estilos no parâmetro opcional sheet usando o índice da folha (a indexação começa em 0) ou com as seguintes constantes:

    • vk current sheet
    • vk workbook

    Exemplo

    O seguinte código:

    $style:=VP Get stylesheet("ViewProArea";"GreenDashDotStyle")

    ... retorna o objeto estilo GreenDashDotStyle da folha atual:

    {
    backColor:green,
    borderBottom:{color:green,style:10},
    borderLeft:{color:green,style:10},
    borderRight:{color:green,style:10},
    borderTop:{color:green,style:10}
    }

    Veja também

    4D View Pro Style Objects and Style Sheets
    VP ADD STYLESHEET
    VP Get stylesheets
    VP REMOVE STYLESHEET

    VP Get stylesheets

    VP Get stylesheets ( vpAreaName : Text { ; sheet : Integer } ) : Collection

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Âmbito alvo (padrão = folha atual)
    ResultadosCollection<-Coleção de objectos de folhas de estilo

    |

    Descrição

    O comando VP Get stylesheets retorna a coleção de objetos de folha de etilo definidos na folha designada sheet.

    Em vpAreaName, passe o nome da propriedade da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Você pode designar onde definir a folha de estilos no parâmetro opcional sheet usando o índice da folha (a indexação começa em 0) ou com as seguintes constantes:

    • vk current sheet
    • vk workbook

    Exemplo

    O código abaixo retorna a coleção de todos os objetos de estilo na folha atual:

    $styles:=VP Get stylesheets("ViewProArea")

    Nesse caso, a planilha atual usa dois objetos estilo:

    [
    {
    backColor:green,
    borderLeft:{color:green,style:10},
    borderTop:{color:green,style:10},
    borderRight:{color:green,style:10},
    borderBottom:{color:green,style:10},
    name:GreenDashDotStyle
    },
    {
    backColor:red,
    textIndent:10,
    name:RedIndent
    }
    ]

    Veja também

    VP ADD STYLESHEET
    VP Get stylesheet
    VP REMOVE STYLESHEET

    VP Get table column attributes

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP Get table column attributes ( vpAreaName : Text ; tableName : Text ; column : Integer {; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    columnInteger->Índice da coluna na tabela
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Atributos da *coluna *

    |

    Descrição

    O comando VP Get table column attributes devolve os atributos atuais da coluna especificada columnem tableName.

    Em vpAreaName, passe o nome da área 4D View Pro.

    Em sheet, passe o índice da folha de destino. Se nenhum indice for especcificado ou se passar -1, o comando se aplica a folha atual.

    A indexação começa em 0.

    O comando retorna um objeto descrevendo os atributos atuais da column:

    PropriedadeTipoDescrição
    dataFieldtextNome da propriedade da coluna da tabela no contexto de dados. Não devolvido se a tabela for apresentada automaticamente
    nametextNome da coluna da tabela.
    footerTexttextValor do rodapé da coluna.
    footerFormulatextFórmula do rodapé da coluna.
    filterButtonVisiblebooleanTrue se o botão de filtro da coluna da tabela for exibido, senão False

    Se tableName não for encontrado ou se o índice column for maior que o número de colunas, o comando retorna null.

    Exemplo

    var $attributes : Object
    $attributes:=VP Get table column attributes("ViewProArea"; $tableName; 1)
    If ($attributes.dataField#"")
    ...
    End if

    Veja também

    VP CREATE TABLE
    VP Find table
    VP SET TABLE COLUMN ATTRIBUTES
    VP RESIZE TABLE

    VP Get table column index

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP Get table column index ( vpAreaName : Text ; tableName : Text ; columnName : Text {; sheet : Integer } ) : Integer

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    columnNameText->Nome da coluna da tabela
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosInteger<-Índice de columnName

    |

    Descrição

    O comando VP Get table column index devolve o índice do columnName no tableName.

    Em vpAreaName, passe o nome da área 4D View Pro.

    Em columnName, passe o nome da tabela coluna para o qual deseja o indice.

    Em sheet, passe o índice da folha de destino. Se nenhum indice for especcificado ou se passar -1, o comando se aplica a folha atual.

    A indexação começa em 0.

    Se tableName ou columnName não for encontrado, o comando retornará -1.

    Exemplo

        // Search the column id according the column name
    var $id : Integer
    $id:=VP Get table column index($area; $tableName; "Weight price")
    // Remove the column by id VP REMOVE TABLE COLUMNS($area; $tableName; $id)

    Veja também

    VP CREATE TABLE
    VP Find table
    VP Get table column attributes
    VP SET TABLE COLUMN ATTRIBUTES

    VP Get table dirty rows

    Histórico
    ReleaseMudanças
    19 R8Adicionado

    VP Get table dirty rows ( vpAreaName : Text ; tableName : Text { ; reset : Boolean {; sheet : Integer }} ) : Collection

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    resetParâmetros->True para apagar o estado "dirty" da tabela atual, False para mantê-lo igual. Padrão=True
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosCollection<-Coleção de objetos com todos os elementos que foram modificados desde o último reset

    |

    Descrição

    O comando VP Get table dirty rows retorna uma coleção de objetos dirty row, contendo itens que foram modificados desde o último reset na tableName especificada..

    Em vpAreaName, passe o nome da área 4D View Pro.

    Em tableName, passe o nome da tabela para a qual deseja as dirty rows. Só colunas modificadas vinculadas a um data context são levadas em consideração.

    Como padrão, chamar o comando vai apagar o status dirty da tabela atual. Para manter este estado intacto, passe False no parâmetro reset.

    Em sheet, passe o índice da folha de destino. Se nenhum indice for especcificado ou se passar -1, o comando se aplica a folha atual.

    A indexação começa em 0.

    Cada objeto dirty row na coleção retornada contém as propriedades abaixo:

    PropriedadeTipoDescrição
    itemobjectObjeto modificado da linha modificada
    originalItemobjectObjeto antes da modificação
    rowintegerÍndice da linha modificada

    Se tableName não for encontrada ou se não contiver uma coluna modificada, o comando retorna uma coleção vazia.

    Exemplo

    Pretende contar o número de linhas editadas:

    var $dirty : Collection
    $dirty:=VP Get table dirty rows("ViewProArea"; "ContextTable"; False)
    VP SET NUM VALUE(VP Cell("ViewProArea"; 0; 0); $dirty.length)

    Veja também

    VP CREATE TABLE
    VP Find table
    VP SET TABLE COLUMN ATTRIBUTES
    VP RESIZE TABLE

    VP Get table range

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP Get table range ( vpAreaName : Text ; tableName : Text {; onlyData : Integer {; sheet : Integer }} ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    onlyDataInteger->vk table full range (padrão) ou vk table data range
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosObject<-Intervalo que contém a tabela

    |

    Descrição

    O comando VP Get table range devolve o intervalo de tableName.

    Em vpAreaName, passe o nome da área 4D View Pro.

    No parâmetro onlyData pode passar uma das constantes abaixo se deseja obter apenas os dados:

    ParâmetrosValorDescrição
    vk table full range0Obtém o intervalo de células para a área da tabela com rodapé e cabeçalho (padrão se omitido)
    vk table data range1Obter o intervalo de células apenas para a área de dados da tabela

    Em sheet, passe o índice da folha de destino. Se nenhum índice for especificado, o comando se aplica à folha atual.

    A indexação começa em 0.

    SetableName não for encontrado, o comando retorna null.

    Veja também

    VP RESIZE TABLE
    VP Find table

    VP Get table theme

    Histórico
    ReleaseMudanças
    19 R8Adicionado

    VP Get table theme ( vpAreaName : Text ; tableName : Text ) : cs. ViewPro. TableTheme

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    Resultadoscs. ViewPro. TableTheme<-Valores de propriedade do tema da tabela atual

    |

    Descrição

    O comando VP Get table theme retorna os valores de propriedade do tema atual na tableName. Um tema de uma tabela pode ser definido usando os comando VP CREATE TABLE ou VP SET TABLE THEME, ou através da interface.

    Em vpAreaName, passe o nome da área 4D View Pro e em tableName, o nome da tabela.

    O comando devolve um objeto da classe cs.ViewPro.TableTheme com propriedades e valores que descrevem o tema atual da tabela.

    Exemplo

    O comando devolve um objeto tema completo mesmo se for usado um nome de tema SpreadJS nativo para definir o tema.

    var $param : cs. ViewPro. TableTheme
    $param:=cs. ViewPro. TableTheme.new()
    $param.theme:="dark10" //use of a native theme name VP SET TABLE THEME("ViewProArea"; "ContextTable"; $param)
    $vTheme:=VP Get table theme("ViewProArea"; "ContextTable")
    $result:=Asserted(Value type($vTheme.theme)=Is object) //true

    Veja também

    VP CREATE TABLE
    VP SET TABLE THEME

    VP Get tables

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP Get tables ( vpAreaName : Text { ; sheet : Integer } ) : Collection

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da folha (folha atual se omitida)
    ResultadosCollection<-Coleção do textos com todos os nomes de tabelas

    |

    Descrição

    O comando VP Get tables devolve uma coleção de todos os nomes de tabelas definidos na sheet.

    Em vpAreaName, passe o nome da área 4D View Pro.

    Em sheet, passe o índice da folha de destino. Se nenhum índice for especificado, o comando se aplica à folha atual.

    A indexação começa em 0.

    Exemplo

    O código abaixo devolverá uma coleção de todos os nomes de tabelas da folha atual:

    $tables:=VP Get tables("ViewProArea")
    //$tables contém por exemplo ["contextTable","emailTable"]

    Veja também

    VP CREATE TABLE

    VP Get value

    VP Get value ( rangeObj : Object ) : Object

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    ResultadosObject<-Objeto que contém um valor de célula

    |

    Descrição

    O comando VP Get value recupera um valor de célula de um intervalo de células designado.

    Em rangeObj, passe um intervalo cujo valor você deseja recuperar.

    Objeto devolvido

    O objeto devolvido conterá a propriedade value e em caso de um valor data js, uma propriedade time:

    PropriedadeTipoDescrição
    valueInteger, Real, Boolean, Text, DateValor de rangeObj (exceto - time)
    timeRealValor hora (em segundos) se o valor for do tipo data js

    Se o objetivo retornado incluir uma data ou hora, é tratado como uma datetime e completado como abaixo:

    • valor hora - a porção da data se completa como dezembro, 30, 1899 em formato dd/MM/yyyy
    • valor data - a parte da hora se completa como meia noite no formato HH:mm:ss (00:00:00)

    Se rangeObj contiver várias células ou vários intervalos, o valor da primeira célula é retornado. O comando retorna um objeto null se a célula estiver vazia.

    Exemplo

    $cell:=VP Cell("ViewProArea";5;2)
    $value:=VP Get value($cell)
    If(Value type($value.value)=Is text)
    VP SET VALUE($cell;New object("value";Uppercase($value.value)))
    End if

    Veja também

    VP Get values
    VP SET VALUE
    VP SET VALUES

    VP Get values

    VP Get values ( rangeObj : Object ) : Collection

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    ResultadosCollection<-Coleção de valores

    |

    Descrição

    O comando VP Get values obtém os valores do rangeObj designado.

    Em rangeObj, passe um intervalo cujo valor você deseja recuperar. Se rangeObj incluir vários intervalos, somente o primeiro será usado.

    A coleção retornada por VP Get values contém uma coleção bidimensional:

    • Cada elemento da coleção de primeiro nível representa uma linha e contém uma subcoleção de valores.
    • Cada subcoleção contém valores de células para a linha. Os valores podem ser Inteiros, Reais, Booleanos, Texto, Null. Se um valor for uma data ou hora, é retornado em um objeto com as propriedades abaixo:
    PropriedadeTipoDescrição
    valueDateValor da célula (exceto - time)
    timeRealValor hora (em segundos) se o valor for do tipo data js

    Datas ou horas são tratadas como um datetime e são completadas da forma abaixo:

    • valor hora - a parte da data é preenchida como 30 de dezembro de 1899
    • valor data - a porção hora é completa como meia noite (00:00:00:000)

    Exemplo

    Pretende obter valores de C4 a G6:

    $result:=VP Get values(VP Cells("ViewProArea";2;3;5;3))
    // $result[0]=[4,5,null,hello,world]
    // $result[1]=[6,7,8,9,null]
    // $result[2]=[null,{time:42,value:2019-05-29T00:00:00.000Z},null,null,null]

    Veja também

    VP Get formulas
    VP Get value
    VP SET FORMULAS
    VP SET VALUES

    VP Get workbook options

    VP Get workbook options ( vpAreaName : Text ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    ResultadosObject<-Objeto que contém as opções do livro de trabalho

    |

    Descrição

    VP Get workbook options retorna um objeto contendo todas as opções de workbook em vpAreaName

    Em vpAreaName, passe o nome da área 4D View Pro.

    O objeto devolvido contém todas as opções de workbook (padrão e modificadas) no workbook.

    A lista de opções de workbook está referenciada na descrição de VP SET WORKBOOK OPTIONS.

    Exemplo

    var $workbookOptions : Object

    $workbookOptions:=VP Get workbook options("ViewProArea")

    Veja também

    VP SET WORKBOOK OPTIONS

    I

    VP IMPORT DOCUMENT

    VP IMPORT DOCUMENT ( vpAreaName : Text ; filePath : Text { ; paramObj : Object} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    filePathText->Caminho do documento
    paramObjObject->Opções de importação

    |

    Descrição

    O comando VP IMPORT DOCUMENT importa e mostra o documento designado por filePath na área 4D View Pro vpAreaName. O documento importado substitui qualquer dado já inserido na área

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Em filePath, passe o caminho de destino e o nome do documento a ser importado. São suportados os seguintes formatos:

    • Os documentos 4D View Pro (extensão ".4vp")

    • Microsoft Excel (extensão ".xlsx")

    • documentos textos (extensão ".txt", ".csv", o documento deve ser em utf-8)

    Se a extensão do documento não for uma extensão conhecida, como .4vp ou .xlsx, o documento é considerado como sendo um documento texto. Deve passar uma rota completa, a não ser que o documento esteja localizado no mesmo nível que a pasta Project, em cujo caso pode passar apenas seu nome.

    Quando importar um arquivo formatado em Excel em um documento 4D View Pro, algumas configurações podem ser perdidas. Você pode verificar outras configurações com essa lista do GrapeCity.

    Um erro é retornado se o parâmetro filePath for inválido ou se o arquivo estiver faltando ou for malformado

    O parâmetro opcional paramObj permite definir as propriedades do documento importado

    ParâmetroTipoDescrição
    formulaobjectNome de um método callback a ser iniciado quando a importação for concluída. O método deve utilizar o comando Formula. Consulte Passando um método de retorno de chamada (fórmula).
    senhatextSomente Microsoft Excel (opcional) - Senha usada para proteger o documento do MS Excel.
    csvOptionsobjectopções para importação csv
    rangeobjectO intervalo de células que contém a primeira célula onde os dados serão escritos. Se o intervalo especificado não é um intervalo de células, só a primeira célula do intervalo é usada.
    rowDelimitertextDelimitador de linha. Se não estiver presente, o delimitador é automaticamente determinado por 4D.
    columnDelimitertextDelimitador de coluna. O padrão: ","

    Para obter mais informações sobre CSV e valores separados por delimitadores, consulte este artigo na Wikipedia

    Exemplo 1

    Se quiser importar um documento 4D View Pro armazenado no disco quando o formulário for aberto:

    C_TEXT($docPath)
    If(Form event code=On VP Ready) //A zona 4D View Pro está carregada e pronta
    $docPath:="C:\\Bases\\ViewProDocs\\MyExport.4VP"
    VP IMPORT DOCUMENT("VPArea";$docPath)
    End if

    Exemplo 2

    Você deseja importar um documento do Microsoft Excel protegido por senha para uma área do 4D View Pro:

    $o:=New object
    $o.password:="excel123" VP IMPORT DOCUMENT("ViewProArea";"c:\\tmp\\excelfilefile.xlsx";$o)
        //myImport callback method
    #DECLARE($area : Text; $filePath : Text; $param : Object; $status : Object)

    If ($status.success)
    ALERT("Import successfully completed")
    Else
    ALERT("Error: "+$status.errorMessage)
    End if

    Exemplo 3

    Você deseja importar um arquivo .txt que usa uma vírgula (",") como delimitador:

    example-import-csv

    $params:=New object
    $params.range:=VP Cells("ViewProArea";0;0;2;5)
    VP IMPORT DOCUMENT("ViewProArea";"c:\\import\\my-file.txt";New object("csvOptions";$params))

    Aqui está o resultado: example-import-csv

    Veja também

    VP EXPORT DOCUMENT
    VP NEW DOCUMENT

    VP IMPORT FROM OBJECT

    VP IMPORT FROM OBJECT ( vpAreaName : Text { ; viewPro : Object} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    viewProObject->Objeto 4D View Pro

    |

    Descrição

    O comando VP IMPORT FROM OBJECT importa e exibe o objeto viewPro 4D View Pro object in the vpAreaName 4D View Pro area. O documento importado substitui qualquer dado já inserido na área

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Em viewPro, passe um objeto 4D View Pro válido. Este objeto pode ter sido criado usando VP Export to object ou manualmente. For more information on 4D View Pro objects, please refer to the 4D View Pro object section.

    Um erro é retornado se o objeto viewPro for inválido.

    Exemplo

    Se quiser importar uma folha de cálculo que foi salva previamente em um campo objeto:

    QUERY([VPWorkBooks];[VPWorkBooks]ID=10)
    VP IMPORT FROM OBJECT("ViewProArea1";[VPWorkBooks]SPBook)

    Veja também

    VP Export to object

    VP INSERT COLUMNS

    VP INSERT COLUMNS ( rangeObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    |

    Descrição

    O comando VP INSERT COLUMNS insere colunas no rangeObj.

    Em rangeObj, passe um objeto contendo um intervalo de coluna início ( a coluna que designa onde a nova coluna será inserida) e o número de colunas a inserir. Se o número de colunas a inseriri for omitido (não definido), uma única coluna é inserida.

    Novas colunas são inseridas na esquerda, diretamente na coluna inicio em rangeObj.

    Exemplo

    Para inserir três colunas antes da segunda coluna:

    VP INSERT COLUMNS(VP Column("ViewProArea";1;3))

    O resultado é:

    Veja também

    VP DELETE COLUMNS
    VP DELETE ROWS
    VP INSERT ROWS

    VP INSERT ROWS

    VP INSERT ROWS ( rangeObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    |

    Descrição

    O comando VP INSERT ROWS insere linhas definidas pelo rangeObj.

    Em rangeObj, passe um objeto contendo um intervalo de linha início ( a linhaa que designa onde a nova linha será inserida) e o número de linhas a inserir. Se o número de linhas a inserir for omitido (não definido), uma única linha é inserida.

    Novas linhas são inseridas imediatamente antes da primeira linha do rangeObj.

    Exemplo

    Para inserir 3 linhas antes da primeira linha:

    VP INSERT ROWS(VP Row("ViewProArea";0;3))

    O resultado é:

    Veja também

    VP DELETE COLUMNS
    VP DELETE ROWS
    VP INSERT COLUMNS

    VP INSERT TABLE COLUMNS

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP INSERT TABLE COLUMNS ( vpAreaName : Text ; tableName : Text ; column : Integer {; count : Integer {; insertAfter : Integer {; sheet : Integer }}} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    columnInteger->Índice na tabela da coluna inicial a inserir
    countText->Número de colunas a adicionar (tem de ser >0)
    insertAfterInteger->vk table insert before ou vk table insert after column
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP INSERT TABLE COLUMNS insere uma ou um número countde colunas vazias na tabela especificada tableName no índice determinado column.

    Quando uma coluna foi inserida com este comando, pode geralmente modificar seu conteúdo usando o comando VP SET TABLE COLUMN ATTRIBUTES.

    No parâmetro insertAfter pode passar uma das constantes abaixo para indicar se as colunas devem sr inseridas antes ou depois do índice column:

    ParâmetrosValorDescrição
    vk table insert before0Insere colunas antes de column (padrão se omitir o parâmetro)
    vk table insert after1Inserir coluna(s) após a *coluna *

    Este comando insere algumas colunas na tabela tableName , NÂO na folha. O número total de colunas da folha não é impactado pelo comando. Dados presentes à direita da tabela (se houver) são movidos para a direita automaticamente de acordo com o número de colunas adicionadas.

    se tableName não existir ou se não houver espaço suficiente na folha, nada acontece.

    Exemplo

    Ver exemplos para VP INSERT TABLE ROWS e VP SET TABLE COLUMN ATTRIBUTES.

    Veja também

    VP INSERT TABLE ROWS
    VP REMOVE TABLE COLUMNS
    VP SET TABLE COLUMN ATTRIBUTES

    VP INSERT TABLE ROWS

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP INSERT TABLE ROWS ( vpAreaName : Text ; tableName : Text ; row : Integer {; count : Integer {; insertAfter : Integer {; sheet : Integer }}} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    rowInteger->Índice na tabela da linha inicial a inserir
    countText->Número de linhas a adicionar (tem de ser >0)
    insertAfterInteger->vk table insert before ou vk table insert after row
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP INSERT TABLE ROWS insere uma ou um número countde linhas vazias na tabela especificada tableName no índice determinado row.

    No parâmetro insertAfter pode passar uma das constantes abaixo para indicar se as linhas devem ser inseridas antes ou depois do índice row:

    ParâmetrosValorDescrição
    vk table insert before0Inserir linha(s) antes da row (predefinição se omitido)
    vk table insert after1Inserir linha(s) após a row

    Este comando insere algumas linhas na tabela tableName , NÂO na folha. O número total de linhas da folha não é impactado pelo comando. Dados presentes abaixo da tabela (se houver) são movidos para baixo automaticamente de acordo com o número de linhas adicionadas.

    Se a tabela tableNameestiver vinculada adata context, o comando insere novos elementos vazios na coleção.

    se tableName não existir ou se não houver espaço suficiente na folha, nada acontece.

    Exemplo

    Você cria uma tabela com um contexto de dados:

    var $context : Object
    $context:=New object()

    $context.col:=New collection
    $context.col.push(New object("name"; "Smith"; "salary"; 10000))
    $context.col.push(New object("name"; "Wesson"; "salary"; 50000))
    $context.col.push(New object("name"; "Gross"; "salary"; 10500)) VP SET DATA CONTEXT("ViewProArea"; $context) VP CREATE TABLE(VP Cells("ViewProArea"; 1; 1; 3; 3); "PeopleTable"; "col")

    Se quiser inserir duas linhas e duas colunas na tabela, pode escrever:

    VP INSERT TABLE ROWS("ViewProArea"; "PeopleTable"; 1; 2)
    VP INSERT TABLE COLUMNS("ViewProArea"; "PeopleTable"; 1; 2)

    Veja também

    VP INSERT TABLE COLUMNS
    VP REMOVE TABLE ROWS

    M

    VP MOVE CELLS

    Histórico
    ReleaseMudanças
    19 R4Adicionado

    VP MOVE CELLS ( originRange : Object ; targetRange : Object ; options : Object )

    ParâmetroTipoDescrição
    originRangeObject->Intervalo de células a partir do qual copiar
    targetRangeObject->Intervalo de destino para os valores, formatação e fórmulas
    optionsObject->Opções adicionais

    |

    Descrição

    O comando VP MOVE CELLS move ou copia os valores, estilo e fórmulas de originRange a targetRange.

    originRange e targetRange podem se referir a áreas View Pro diferentes.

    Em originRange, passe um objeto intervalo que contenha os valores, o estilo e as células da fórmula a copiar ou mover. Se originRange for um intervalo combinado, somente o primeiro será usado.

    Em targetRange, passe o intervalo de células onde os valores de célula, estilo e fórmulas serão copiados ou movidos.

    O parâmetro options tem várias propriedades:

    PropriedadeTipoDescrição
    copyParâmetrosDetermina se os valores, formatação e fórmulas das células no intervalo originRange são removidos após o comando executar:
    • False (padrão) para os remover
    • True para os manter
    pasteOptionsIntegerEspecifica o que é colado. Valores possíveis:

    ValorDescrição
    vk clipboard options all (padrão)Cola todos os objectos de dados, incluindo valores, formatação e fórmulas.
    vk clipboard options formattingCola apenas a formatação.
    vk clipboard options formulasCola apenas as fórmulas.
    vk clipboard options formulas and formattingCola as fórmulas e a formatação.
    vk clipboard options valuesCola apenas os valores.
    vk clipboard options value and formattingCola os valores e a formatação.

    As opções de colagem definidas nas opções da pasta de trabalho são levadas em consideração.

    Exemplo

    Para copiar os conteúdos, valores, formatação e fórmulas de um intervalo de origem:

    var $originRange; $targetRange; $options : Object

    $originRange:=VP Cells("ViewProArea"; 0; 0; 2; 5)

    $targetRange:=VP Cells("ViewProArea"; 4; 0; 2; 5)

    $options:=New object
    $options.copy:=True
    $options.pasteOptions:=vk clipboard options all

    VP MOVE CELLS($originRange; $targetRange; $options)

    Veja também

    VP Copy to object
    VP PASTE FROM OBJECT
    VP SET WORKBOOK OPTIONS

    N

    VP Name

    VP Name ( vpAreaName : Text ; rangeName : Text { ; sheet : Integer } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    rangeNameText->Nome do intervalo existente
    sheetInteger->Localização do intervalo (folha atual se omitida)
    ResultadosObject<-Objeto intervalo de nome

    |

    Descrição

    O comando VP Name devolve um novo objeto intervalo que faz referência a um intervalo nomeado.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    O parâmetro rangeName especifica um intervalo de célula nomeada existente.

    No parâmetro folha opcional, você pode designar uma planilha específica onde intervalo é definido. Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual ou toda a pasta de trabalho com as seguintes constantes:

    • vk current sheet
    • vk workbook

    Exemplo

    Pretende atribuir um valor ao intervalo nomeado "Total".

    // name the B5 cell as Total
    VP ADD RANGE NAME(VP Cell("ViewProArea";1;4);"Total")
    $name:=VP Name("ViewProArea";"Total")
    VP SET NUM VALUE($name;285;"$#,###.00")

    Veja também

    VP ADD RANGE NAME
    VP ALL
    VP Cell
    VP Cells
    VP Column
    VP Combine ranges
    VP Get names
    VP REMOVE NAME
    VP Row

    VP NEW DOCUMENT

    VP NEW DOCUMENT ( vpAreaName : Text )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário

    |

    Descrição

    O comando VP NEW DOCUMENT carrega e exibe um novo documento padrão no objeto de área de formulário 4D View Pro, vpAreaName. O novo documento vazio substitui quaisquer dados já inseridos na área.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Exemplo

    Se quiser exibir um documento vazio no formulário "myVPArea":

    VP NEW DOCUMENT("myVPArea")

    Veja também

    VP IMPORT DOCUMENT


    O

    VP Object to font

    VP Object to font ( fontObj : Object ) : Text

    ParâmetroTipoDescrição
    fontObjObject->Objecto letra
    ResultadosText<-Fonte abreviada

    |

    Descrição

    O comando VP Object to font retorna uma string abreviada de fontObj.

    Em fontObj, passe um objeto que contém as propriedades da fonte. As propriedades abaixo são compatíveis:

    PropriedadeTipoDescriçãoValores possíveisObrigatório
    familytextEspecifica o tipo de letra.qualquer família de tipos de letra padrão ou genérica. Ex. Ex. Ex. "Arial", "Helvetica", "serif", "arial,sans-serif"Sim
    sizetextDefines the size of the font. The line-height can be added to the font-size: font-size/line-height: Ex: "15pt/20pt"um número com uma das seguintes unidades:
  • "em", "ex", "%", "px", "cm", "mm", "in", "pt", "pc", "ch", "rem", "vh", "vw", "vmin", "vmax"
  • ou uma das seguintes:
  • vk font size large
  • vk font size larger
  • vk font size x large
  • vk font size xx large
  • vk font size small
  • vk font size smaller
  • vk font size x small
  • vk font size xx small
  • Sim
    styletextO estilo do tipo de letra.
  • vk font style italic
  • vk font style oblique
  • Não
    varianttextEspecifica o tipo de letra em pequenas maiúsculas.
  • vk font variant small caps
  • Não
    weighttextDefine a espessura do tipo de letra.
  • vk font weight 100
  • vk font weight 200
  • vk font weight 300
  • vk font weight 400
  • vk font weight 500
  • vk font weight 600
  • vk font weight 700
  • vk font weight 800
  • vk font weight 900
  • vk font weight bold
  • vk font weight bolder
  • vk font weight lighter
  • Não

    Este objeto pode ser criado com o comando Fonte VP para objeto.

    A string abreviada retornada pode ser atribuída à propriedade "font" de uma célula com VP SET CÉLULA, por exemplo.

    Exemplo

    $cellStyle:=VP Get cell style($range)

    $font:=VP Font to object($cellStyle.font)
    $font.style:=vk font style oblique
    $font.variant:=vk font variant small caps
    $font.weight:=vk font weight bolder

    $cellStyle.font:=VP Object to font($font)
    //$cellStyle.font contém "bolder oblique small-caps 16pt arial"

    Veja também

    4D View Pro Style Objects and Style Sheets
    VP Font to object
    VP SET CELL STYLE
    VP SET DEFAULT STYLE

    P

    VP PASTE FROM OBJECT

    Histórico
    ReleaseMudanças
    19 R4Adicionado

    VP PASTE FROM OBJECT ( rangeObj : Object ; dataObject : Object {; options : Longint} )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo de células
    dataObjectObject->Objeto que contém os dados a colar
    optionsInteger->Especifica o que é colado

    |

    Descrição

    O comando VP PASTE FROM OBJECT Cola o conteúdo, o estilo e as fórmulas armazenadas no dataObject no objeto rangeObj.

    No rangeObj, passe o objeto de gama de células onde os valores, formatando, e/ou as células serão coladas. Se rangeObj se refere a mais de uma célula, apenas a primeira é usada.

    No dataObject, passa o objeto que contém os dados da célula, a formatação e as fórmulas a serem coladas.

    Na opção opcional opções , você pode especificar o que colar no intervalo de células. Valores possíveis:

    ParâmetrosDescrição
    vk clipboard options allCola todos os objectos de dados, incluindo valores, formatação e fórmulas.
    vk clipboard options formattingCola apenas a formatação.
    vk clipboard options formulasCola apenas as fórmulas.
    vk clipboard options formulas and formattingCola fórmulas e formatação.
    vk clipboard options valuesCola apenas valores.
    vk clipboard options value and formattingCola valores e formatação.

    As opções de colagem definidas nas opções da pasta de trabalho são levadas em consideração.

    Se options se refere a uma opção de colar não presente no objeto copiado (por exemplo, fórmulas), o comando não faz nada.

    Exemplo

    Ver o exemplo de VP Copy to object

    Veja também

    VP Copy to object
    VP MOVE CELLS
    VP Get workbook options
    VP SET WORKBOOK OPTIONS

    VP PRINT

    VP PRINT ( vpAreaName : Text { ; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP PRINT abre uma janela de diálogo de impressão para imprimir vpAreaName.

    Passe a área 4D View Pro a ser impressa em vpAreaName. O comando abrirá a janela de diálogo de impressão do sistema onde a impressora pode ser especificada e as propriedades da página podem ser definidas.

    As propriedades definidas na janela de diálogo de impressão são para o papel de impressora, elas não são as propriedades de impressão para a área 4D View Pro. Propriedades de impressão para áreas 4D View Pro são definidas usando o comando VP SET PRINT INFO. É altamente recomendável que as propriedades tanto para impressora quanto para correspondência 4D View Pro, caso contrário, o documento impresso pode não corresponder às suas expectativas.

    No parâmetro opcional sheet , você pode designar uma planilha específica para imprimir (a contagem começa às 0). Se omitido, a folha atual será usada como padrão. Você pode selecionar explicitamente a planilha atual ou toda a planilha com as seguintes constantes:

    • vk current sheet
    • vk workbook
    • As áreas do 4D View Pro só podem ser impressas com o comando VP PRINT.
    • Comandos do tema de idioma 4D Imprimir não são suportados pela VP PRINT.
    • Esse comando é destinado a impressão individual pelo usuário final. Para trabalhos de impressão automáticos, recomendamos exportar a área 4D View Pro como um PDF com o método EXPORT DOCUMENT.

    Exemplo

    O seguinte código:

     VP PRINT("myVPArea")

    ... abre uma janela de diálogo de impressão:

    Veja também

    VP EXPORT DOCUMENT
    VP SET PRINT INFO

    R

    VP RECOMPUTE FORMULAS

    VP RECOMPUTE FORMULAS ( vpAreaName : Text )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário

    |

    Descrição

    O comando VP RECOMPUTE FORMULAS avalia imediatamente todas as fórmulas em vpAreaName. Por padrão, o 4D calcula automaticamente fórmulas quando elas são inseridas, importadas ou exportadas. VP RECOMPUTE FORMULAS permite forçar o cálculo a qualquer momento (por exemplo, se as fórmulas forem modificadas ou se as fórmulas contiverem chamadas para o banco de dados). The command launches the execution of the VP FLUSH COMMANDS command to execute any stored commands and clear the command buffer, then calculates all formulas in the workbook.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Certifique-se de que o comando VP SUSPEND COMPUTANDO não foi executado antes de usar VP RECOMPUTE FORMULAS, caso contrário, o comando não faz nada.

    Exemplo

    Para atualizar todas as fórmulas no livro de trabalho:

    VP RECOMPUTE FORMULAS("ViewProArea")

    Veja também

    VP RESUME COMPUTING
    VP SUSPEND COMPUTING

    VP REMOVE NAME

    VP REMOVE NAME ( vpAreaName : Text ; name : Text { ; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    nameText->Nome do intervalo nomeado ou da fórmula nomeada a remover
    scopeInteger->Âmbito alvo (padrão=folha atual)

    |

    Descrição

    O comando VP REMOVER NOME remove o intervalo nomeado ou a fórmula nomeada passada no parâmetro nome no escopo definido **.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Passe o intervalo ou a fórmula nomeada que você deseja remover no nome **.

    Você pode definir onde remover o nome no escopo ** usando o índice da folha (contagem começa em 0) ou as seguintes constantes:

    • vk current sheet
    • vk workbook

    Exemplo

    $range:=VP Cell("ViewProArea";0;0)
    VP ADD RANGE NAME("Total1";$range) VP REMOVE NAME("ViewProArea";"Total1")
    $formula:=VP Get formula by name("ViewProArea";"Total1")
    //$formula=null

    Veja também

    VP Name

    VP REMOVE SHEET

    VP REMOVE SHEET ( vpAreaName : Text ; index: Integer )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    indexInteger->Índice da folha a remover

    |

    Veja também

    VP ADD SHEET

    Descrição

    O comando VP REMOVE SHEET remove a folha com o índice especificado do documento carregado no vpAreaName.

    Em vpAreaName, passe o nome da área 4D View Pro.

    In sheet, pass the index of the target sheet. If no index is specified, the command applies to the current sheet.

    A indexação começa em 0.

    Exemplo

    O documento tem atualmente três folhas:

    Retirar a terceira folha:

    VP REMOVE SHEET("ViewProArea";2)

    VP REMOVE SPAN

    VP REMOVE SPAN ( rangeObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    Descrição

    O comando VP REMOVE SPAN remove o intervalo das células em rangeObj.

    Em rangeObj, passe um objeto de alcance do intervalo da célula. As células geradas no alcance são divididas em células individuais.

    Exemplo

    Para remover todos os intervalos de células deste documento:

     //encontre todas as células fusionadas
    $span:=VP Obter spans(VP All("ViewProArea"))


    /remove a célula
    VP SPAN($span)

    Resultados:

    Veja também

    VP ADD SPAN
    VP Get spans

    VP REMOVE STYLESHEET

    VP REMOVE STYLESHEET ( vpAreaName : Text ; styleName : Text { ; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    styleNameText->Nome do estilo a remover
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP REMOVE STYLESHEET remove a folha de estilo passada no styleName do vpAreaName.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Passe a folha de estilo para remover no parâmetro styleName.

    Você pode definir onde remover o estilo no parâmetro sheet opcional usando o índice da folha (contagem começa em 0) ou com as seguintes constantes:

    • vk current sheet
    • vk workbook

    Exemplo

    Para remover o objeto de estilo GreenDashDotStyle da folha atual:

    VP REMOVE STYLESHEET("ViewProArea";"GreenDashDotStyle")

    Veja também

    VP ADD STYLESHEET
    VP Get stylesheet
    VP Get stylesheets

    VP REMOVE TABLE

    Histórico
    ReleaseMudanças
    19 R6Adicionado

    VP REMOVE TABLE ( vpAreaName : Object; tableName : Text {; options : Integer} {; sheet : Integer}} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área View Pro
    tableNameText->Nome da tabela a remover
    optionsInteger->Opções adicionais
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP REMOVE TABLE remove uma tabela que criou com VP CREATE TABLE.

    Em vpAreaName, passe o nome da área onde a tabela a ser removida está localizada.

    Em tableName, passe o nome da tabela para remover.

    Em opções, você pode especificar o comportamento adicional. Valores possíveis:

    ParâmetrosValorDescrição
    vk table remove all0Remover tudo, incluindo o estilo e os dados
    vk table remove style1Remover o estilo, mas manter os dados
    vk table remove data2Remover dados, mas manter o estilo

    Os nomes das tabelas são definidos ao nível da folha. Você pode especificar onde a tabela está localizada usando um parâmetro opcional sheet (indexação começa em 0).

    Exemplo

    Para remover a tabela "pessoas" na segunda folha e manter os dados nas células:

    VP REMOVE TABLE("ViewProArea"; "people"; vk table remove style; 2)

    Veja também

    VP CREATE TABLE

    VP REMOVE TABLE COLUMNS

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP REMOVE TABLE COLUMNS ( vpAreaName : Text ; tableName : Text ; column : Integer {; count : Integer {; sheet : Integer }}} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    columnInteger->Índice na tabela da coluna inicial a remover
    countText->Número de colunas a remover (tem de ser >0)
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP REMOVE TABLE COLUMNS remove uma ou count coluna(s) no tableName especificado no índice especificado coluna. O comando remove valores e estilos.

    O comando remove colunas da tabela tableName , NÃO da planilha. O número total de colunas da folha não é impactado pelo comando. The total number of columns of the sheet is not impacted by the command.

    Se tableName não existir, não acontece nada.

    Exemplo

    Para remover duas colunas da 3.ª coluna da tabela "dataTable":

    VP REMOVE TABLE COLUMNS("ViewProArea"; "dataTable"; 3; 2)

    Veja também

    VP INSERT TABLE COLUMNS
    VP REMOVE TABLE ROWS

    VP REMOVE TABLE ROWS

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP REMOVE TABLE ROWS ( vpAreaName : Text ; tableName : Text ; row : Integer {; count : Integer {; sheet : Integer }}} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    rowInteger->Índice na tabela da linha inicial a remover
    countText->Número de linhas a remover (tem de ser >0)
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    removes one or count row(s) from the specified tableName at the specified row index O comando VP REMOVE TABLE ROWS. O comando remove valores e estilos.

    Este comando remove linhas da tabela nome da tabela , não da folha. O número total de linhas da folha não é impactado pelo comando. Dados presentes abaixo da tabela (se houver) são movidos automaticamente de acordo com o número de linhas removidas.

    Se a tabela tableName está vinculada a um contexto de dados, o comando remove o(s) elemento(s) da coleção.

    Se tableName não existir, não acontece nada.

    Exemplo

    Para remover duas linhas da 3.ª linha da tabela "dataTable":

    VP REMOVE TABLE ROWS("ViewProArea"; "dataTable"; 3; 2)

    Veja também

    VP INSERT TABLE ROWS
    VP REMOVE TABLE COLUMNS

    VP RESET SELECTION

    VP RESET SELECTION ( vpAreaName : Text { ; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP RESET SELECTION desmarca todas as células, de modo que não haja seleção atual ou célula ativa visível.

    Uma célula ativa padrão (célula A1) permanece definida para comandos 4D View Pro.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    No parâmetro opcional sheet, pode designar uma folha específica onde o intervalo será definido (a contagem começa em 0). Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante:

    • vk current sheet

    Exemplo

    Se quiser desmarcar todas as células (a célula ativa e as células selecionadas):

    VP RESET SELECTION("myVPArea")

    Veja também

    VP ADD SELECTION
    VP Get active cell
    VP Get selection
    VP SET ACTIVE CELL
    VP SET SELECTION
    VP SHOW CELL

    VP RESIZE TABLE

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP RESIZE TABLE ( rangeObj : Object; tableName : Text )

    ParâmetroTipoDescrição
    rangeObjObject->Nova gama para a tabela
    tableNameText->Nombre da tabela

    |

    Descrição

    O comando VP RESIZE TABLE muda o tamanho tableName com relação ao intervalo rangeObj.

    As regras abaixo são válidas:

    • Cabeçalhos devem permanecer na mesma linha e o intervalo de tabelas resultante deve sobrepor o intervalo de tabela original.
    • Se a contagem de linha da tabela redimensionada é inferior à contagem de linhas inicial, valores dentro de linhas ou colunas cortadas são mantidos se eles não fossem vinculados a um contexto de dados , caso contrário, eles serão excluídos.
    • Se a tabela se expandir nas células que contêm dados:
      • se as linhas forem adicionadas, os dados serão excluídos,
      • se colunas forem adicionadas, dados serão mantidos e exibidos em novas colunas.

    Se tableName não existir, não acontece nada.

    Exemplo

    Você cria uma tabela com um contexto de dados:

    var $context : Object
    $context:=New object()

    $context.col:=New collection
    $context.col.push(New object("name"; "Smith"; "salary"; 10000))
    $context.col.push(New object("name"; "Wesson"; "salary"; 50000))
    $context.col.push(New object("name"; "Gross"; "salary"; 10500)) VP SET DATA CONTEXT("ViewProArea"; $context) VP CREATE TABLE(VP Cells("ViewProArea"; 1; 1; 3; 3); "PeopleTable"; "col")

    Se quiser adicionar uma coluna antes e depois da tabela, bem como duas linhas vazias. Você pode escrever:

    VP RESIZE TABLE(VP Cells("ViewProArea"; 0; 1; 4; 6); "PeopleTable")

    Veja também

    VP CREATE TABLE
    VP Get table range

    VP RESUME COMPUTING

    VP RESUME COMPUTING ( vpAreaName : Text )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário

    |

    Descrição

    O comando VP RESUME COMPUTING reinicia o cálculo das fórmulas em vpAreaName.

    O comando reativa o serviço de cálculo de 4D View Pro. Quaisquer fórmulas afetadas por alterações feitas enquanto os cálculos foram suspensos são atualizadas, e fórmulas adicionadas após RESUME VP CONCLUÍDO são calculadas.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    O serviço de cálculo de 4D View Pro mantém um contador de ações de sugastar/retomar. Portanto, cada execução de VP RESUME COMPUTING deve ser balanceada por uma execução VP SUSPEND COMPUTANDO.

    Exemplo

    Ver exemplo em VP SUSPEND COMPUTING.

    Veja também

    VP RECOMPUTE FORMULAS
    VP SUSPEND COMPUTING

    VP Row

    VP Row ( vpAreaName : Text; row : Integer { ; rowCount : Integer { ; sheet : Integer } } ) : Object

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    rowInteger->Índice de linha
    rowCountInteger->Número de linhas

    |sheet |Integer|->|Sheet index (folha atual, se omitida)| |Result |Object|<-|Range object of row(s)|

    Descrição

    O comando VP Row devolve um novo objeto intervalo que referir-se a uma linha ou linhas específicas.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    O parâmetro row define a primeira linha do intervalo de linhas. Passar o índice da linha (a contagem começa em 0) neste parâmetro. rowCount must be greater than 0.

    O parâmetro rowCount opcional permite que você defina o número total de linhas do intervalo. rowCount tem de ser superior a 0. Se for omisso, o valor será definido como 1 por padrão.

    No parâmetro opcional sheet, pode designar uma folha específica onde o intervalo será definido (a contagem começa em 0). Se não for especificada, a folha de cálculo atual é utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante:

    • vk current sheet

    Exemplo

    Se quiser definir um objeto de intervalo para a linha exibida abaixo (na planilha atual):

    Você pode escrever:

    $row:=VP Row("ViewProArea";9) // linha 10

    Veja também

    VP All
    VP Cell
    VP Cells
    VP Column
    VP Combine ranges
    VP Name

    VP ROW AUTOFIT

    VP ROW AUTOFIT ( rangeObj : Object)

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    |

    Descrição

    O comando VP ROW AUTOFIT dimensiona automaticamente a(s) linha(s) em rangeObj conforme o seu conteúdo.

    No rangeObj, passe um objeto de alcance que contém um intervalo de linhas cujo tamanho será tratado automaticamente.

    Exemplo

    As linhas seguintes não apresentam corretamente o texto:

     VP ROW AUTOFIT(VP Row("ViewProArea";1;2))

    Resultados:

    Veja também

    VP Column autofit

    VP Run offscreen area

    VP Run offscreen area ( parameters : Object) : Mixed

    ParâmetroTipoDescrição
    parametersObject->Objeto que contém os atributos da área fora do ecrã
    ResultadosMixed<-.result propriedade do objeto .onEvent , ou Null se não retorna um valor™️.

    |

    Descrição

    O comando VP Run offscreen area cria uma área offscreen na memória que pode ser usada para processar comandos e funções de 4D View Pro.

    Em parâmetros objeto, passe qualquer uma das seguintes propriedades opcionais. Essas propriedades estarão disponíveis através do Este comando dentro do método onEvent e faça referência à instância:

    PropriedadeTipoDescrição
    areatextO nome da área offscreen. Se omitido ou nulo, um nome genérico é atribuído (por exemplo, "OffscreenArea1").
    onEventobject (fórmula)Um método de callback que será iniciado quando a área fora da tela estiver pronta. Pode ser um ou outro:
  • uma função onEvent de uma classe, ou
  • um objecto Formula
  • Por padrão, o método de callback é chamado nos eventos On VP Ready, On Load, On Unload, On End URL Loading, On URL Loading Error, On VP Range Changed, ou On Timer. O método de callback pode ser usado para acessar a variável de objeto 4D View Pro.
    autoQuitbooleanVerdadeiro (valor padrão) se o comando deve parar a fórmula de execução quando os eventos Na URL Final Carregando ou Na URL carregar erro ocorrem. Se falso, você deve usar o comando CANCEL ou ACEITAR no método noEvent callback.
    timeoutnumberTempo máximo (expresso em segundos) antes que a área seja encerrada automaticamente, se nenhum evento for gerado. Se for definido para 0, não é aplicada qualquer limitação. Valor por padrão: 60
    resultadomistoResultado do processamento (se for caso disso)
    <customProperty>mistoQualquer atributo personalizado a estar disponível no método de callback onEvent.

    A seguinte propriedade é automaticamente adicionada pelo comando, se necessário:

    PropriedadeTipoDescrição
    timeoutReachedbooleanAdicionado com valor true se o tempo limite tiver sido excedido

    A área fora da tela só está disponível durante a execução do comando VP Run fora da área. Ele será destruído automaticamente após o término da execução.

    Os seguintes comandos podem ser utilizados no método de retorno de chamada:

    • ACCEPT
    • CANCEL
    • SET TIMER
    • WA Evaluate JavaScript
    • WA EXECUTE JAVASCRIPT FUNCTION

    Exemplo 1

    Se quiser criar uma zona fora da área da tela do 4D View Pro e ler o valor de uma célula:

    // cs.OffscreenArea class declaration
    Class constructor ($path : Text)
    This.filePath:=$path

    // This function will be called on each event of the offscreen area
    Function onEvent()
    Case of
    :(FORM Event.code=On VP Ready)
    VP IMPORT DOCUMENT(This.area;This.filePath)
    This.result:=VP Get value(VP Cell(This.area;6;22))

    ALERT("The G23 cell contains the value: "+String(This.result))
    End case

    O método de retorno de chamada OffscreenArea:

    $o:=cs. OffscreenArea.new()

    $result:=VP Run offscreen area($o)

    Exemplo 2

    Se quiser carregar um grande documento offscreen, aguardar todos os cálculos para concluir a avaliação e exportá-lo como um PDF:

    //cs. OffscreenArea class declaration Class constructor($pdfPath : Text)
    This.pdfPath:=$pdfPath
    This.autoQuit:=False
    This.isWaiting:=False Function onEvent()
    Case of
    :(FORM Event.code=On VP Ready)
    // Document import
    VP IMPORT DOCUMENT(This.area;$largeDocument4VP)
    This.isWaiting:=True

    // Comece um timer para verificar se todos os cálculos terminaram
    // Se durante este período o intervalo "No VP Alterado" for lançado, o temporizador será reiniciado
    // O tempo deve ser definido de acordo com a configuração do computador.
    SET TIMER(60)

    :(FORM Event.code=On VP Range Changed)
    // Fim de cálculo detectado. Restarts the timer
    If(This.isWaiting)
    SET TIMER(60)
    End if

    :(FORM Event.code=On Timer)
    // To be sure to not restart the timer if you call others 4D View command after this point
    This.isWaiting:=False

    // Stop the timer
    SET TIMER(0)

    // Start the PDF export
    VP EXPORT DOCUMENT(This.area;This.pdfPath;New object("formula";Formula(ACCEPT)))

    :(FORM Event.code=On URL Loading Error)
    CANCEL
    End case

    O método de retorno de chamada OffscreenArea:

    $o:=cs. OffscreenArea.new()

    $result:=VP Run offscreen area($o)

    Veja também

    Blog post: End of document loading

    S

    VP SET ACTIVE CELL

    VP SET ACTIVE CELL ( rangeObj : Object)

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo

    |

    Descrição

    O comando VP SET ACTIVE CELL define uma célula específica como ativa.

    Em rangeObj, passe um intervalo que contenha uma única célula como um objeto (ver VP Cell). Se rangeObj não for um intervalo de células ou contiver vários intervalos, será usada a primeira célula do primeiro intervalo.

    Exemplo

    Para definir a célula na coluna D, linha 5 como a célula ativa:

    $activeCell:=VP Cell("myVPArea";3;4)
    VP SET ACTIVE CELL($activeCell)

    Veja também

    VP ADD SELECTION
    VP Get active cell
    VP Get selection
    VP RESET SELECTION
    VP SET SELECTION
    VP SHOW CELL

    VP SET ALLOWED METHODS

    VP SET ALLOWED METHODS ( methodObj : Object)

    ParâmetroTipoDescrição
    methodObjObject->Métodos permitidos nas áreas 4D View Pro

    |

    Compatibidade

    Para maior flexíbilidade, é recomendado usar o comando VP SET PERSONALIZADOS que permite que você designe fórmulas 4D que podem ser chamadas de 4D View Pro. Assim que VP DET PERSONALIZADO DE FUNÇÕES for chamado, VP SET DE MÉTODOS chamadas são ignoradas. A 4D View Pro também suporta o comando genérico do 4D PERMITIR METHODS se nem o comando VP SET DE FUNÇÕES DO CUSTOM nem VP SET METES são chamados. no entanto não é recomendado usar o comando genérico.

    Descrição

    O comando VP SET ALLOWED METHODS define os métodos do projeto que podem ser chamados em 4D View Pro formulas. Esse comando se aplica a todas as áreas do 4D View Pro inicializadas após sua chamada durante a sessão. Ele pode ser chamado várias vezes na mesma sessão para inicializar diferentes configurações.

    Por padrão, por motivos de segurança, se você não executar o comando VP SET ALLOWED METHODS , nenhuma chamada de método será permitida nas áreas do 4D View Pro - exceto se o comando genérico SET ALLOWED METHODS do 4D tiver sido usado (consulte a nota de compatibilidade). A utilização de um método não autorizado numa fórmula imprime um error #NOME? erro na área 4D View Pro.

    No parâmetro methodObj , passe um objeto no qual cada propriedade é o nome de uma função a ser definida nas áreas do 4D View Pro:

    PropriedadeTipoDescrição
    <functionName>ObjectDefinição da função personalizada. O nome da propriedade <functionName> define o nome da função personalizada a ser exibida nas fórmulas do 4D View Pro (não são permitidos espaços)
    methodText(obrigatório) Nome do método projeto 4D existente para permitir
    parametersUma coleção de objetosColeção de parâmetros (na ordem em que são definidos no método).
    [ ].nameTextNome de um parâmetro a ser exibido para o <functionName>.Observação: Os nomes dos parâmetros não devem conter caracteres de espaço.
    [ ].typeNumberTipo do parâmetro. Tipos suportados:
  • Is Boolean
  • Is date
  • Is Integer
  • Is object
  • Is real
  • Is text
  • Is time
  • Se omitido, por padrão, o valor é enviado automaticamente com seu tipo, exceto os valores de data ou hora que são enviados como um objeto (consulte a seção Parameters). Se o tipo for Is object, o objeto terá a mesma estrutura do objeto retornado por VP Get value.
    resumoTextDescrição da função a ser exibida no 4D View Pro
    minParamsNumberNúmero mínimo de parâmetros
    maxParamsNumberNúmero máximo de parâmetros. Passar um número maior que o comprimento dos parâmetros permite declarar parâmetros "opcionais" com o tipo padrão

    Exemplo

    Pretende permitir dois métodos nas suas áreas 4D View Pro:

    C_OBJECT($allowed)
    $allowed:=New object //parameter for the command

    $allowed. Hello:=New object //create a first simple function named "Hello"
    $allowed. Hello.method:="My_Hello_Method" //sets the 4D method
    $allowed. Hello.summary:="Hello prints hello world"

    $allowed. Byebye:=New object //create a second function with parameters named "Byebye"
    $allowed. Byebye.method:="My_ByeBye_Method"
    $allowed. Byebye.parameters:=New collection
    $allowed. Byebye.parameters.push(New object("name";"Message";"type";Is text))
    $allowed. Byebye.parameters.push(New object("name";"Date";"type";Is date))
    $allowed. Byebye.parameters.push(New object("name";"Time";"type";Is time))
    $allowed. Byebye.summary:="Byebye prints a custom timestamp"
    $allowed. Byebye.minParams:=3
    $allowed. Byebye.maxParams:=3 VP SET ALLOWED METHODS($allowed)

    Depois que esse código é executado, as funções definidas podem ser usadas nas fórmulas do 4D View Pro:

    Nas fórmulas do 4D View Pro, os nomes das funções são automaticamente exibidos em letras maiúsculas.

    Veja também

    4D functions
    VP SET CUSTOM FUNCTIONS

    VP SET BINDING PATH

    Histórico
    ReleaseMudanças
    19 R5Adicionado

    VP SET BINDING PATH ( rangeObj : Object ; dataContextAttribute : Text)

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    dataContextAttributeText->Nome do atributo a associar a rangeObj

    |

    Descrição

    O comando VP SET BINDING PATH liga um atributo do contexto de dados de uma folha a rangeObj. Depois de definir um contexto de dados utilizando o método SET DATA CONTEXT. Quando carregado, se o contexto de dados contiver o atributo, o valor de dataContextAttribute será automaticamente exibido nas células em rangeObj.

    Em rangeObj, passe um objeto que seja um intervalo de células ou um intervalo combinado de células.

    • Se rangeObj for um intervalo com várias células, o comando associará o atributo à primeira célula do intervalo.
    • Se rangeObj contiver vários intervalos de células, o comando associará o atributo à primeira célula de cada intervalo.

    No dataContextAtributo, passe o nome do atributo para vincular ao intervalo e Obj. Se dataContextAtributo é uma string vazia, a função remove a vinculação atual.

    Os atributos do tipo coleção não são suportados. Quando você passar o nome de uma coleção, o comando não faz nada.

    Exemplo

    Defina um contexto de dados e vincule o atributo firstName e lastName às células:

    var $p : Object

    $p:=New object
    $p.firstName:="Freehafer"
    $p.lastName:="Nancy" VP SET DATA CONTEXT("ViewProArea"; $p) VP SET BINDING PATH(VP Cell("ViewProArea"; 0; 0); "firstName")
    VP SET BINDING PATH(VP Cell("ViewProArea"; 1; 0); "lastName")

    Veja também

    VP Get binding path
    VP Get data context
    VP SET DATA CONTEXT

    VP SET BOOLEAN VALUE

    VP SET BOOLEAN VALUE ( rangeObj : Object ; boolValue : Boolean)

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    boolValueParâmetros->Valor booleano a definir

    |

    Descrição

    O comando VP SET BOOLEAN VALUE atribui um valor booleano especificado a um intervalo de células designado.

    Em rangeObj, passe um intervalo da(s) célula(s) (criada(s), por exemplo, com VP Cell ou VP Column) cujo valor você deseja especificar. Se rangeObj incluir várias células, o valor especificado será repetido em cada célula.

    O parâmetro boolValue permite-lhe passar o valor booleano (True ou False) que será atribuído ao rangeObj.

    Exemplo

    //Set the cell value as False VP SET BOOLEAN VALUE(VP Cell("ViewProArea";3;2);False)

    Veja também

    VP SET VALUE

    VP SET BORDER

    VP SET BORDER ( rangeObj : Object ; borderStyleObj : Object ; borderPosObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    borderStyleObjObject->Objeto que contém o estilo da borda
    borderPosObjObject->Objeto que contém a colocação da borda

    |

    Descrição

    O comando VP SET BORDER aplica o(s) estilo(s) de borda definido(s) em borderStyleObj e borderPosObj ao intervalo definido em rangeObj.

    Em rangeObj, passe um intervalo de células em que o estilo de borda será aplicado. Se o rangeObj contiver várias células, as bordas aplicadas com VP SET BORDER serão aplicadas ao rangeObj como um todo (ao contrário do comando VP SET CELL STYLE que aplica bordas a cada célula do rangeObj). Se uma folha de estilo já tiver sido aplicada, VP SET BORDER substituirá as configurações de borda aplicadas anteriormente para o rangeObj.

    O parâmetro borderStyleObj permite que você defina o estilo das linhas da borda. O borderStyleObj oferece suporte às seguintes propriedades:

    PropriedadeTipoDescriçãoValores possíveis
    colortextDefine a cor da margem. Predefinição = black.Sintaxe da cor CSS "#rrggbb" (sintaxe preferencial), sintaxe da cor CSS "rgb(r,g,b)" (sintaxe alternativa), nome da cor CSS (sintaxe alternativa)
    styleIntegerDefine o estilo da borda. Predefinição = vazio.
  • vk line style dash dot
  • vk line style dash dot dot
  • vk line style dashed
  • vk line style dotted
  • vk line style double
  • vk line style empty
  • vk line style hair
  • vk line style medium
  • vk line style medium dash dot
  • vk line style medium dash dot dot
  • vk line style medium dashed
  • vk line style slanted dash dot
  • vk line style thick
  • vk line style thin
  • Você pode definir a posição do borderStyleObj (ou seja, onde a linha é aplicada) com o borderPosObj:

    PropriedadeTipoDescrição
    allbooleanEstilo de linha de fronteira aplicado a todas as fronteiras.
    leftbooleanEstilo de linha de fronteira aplicado à fronteira esquerda.
    topbooleanEstilo de linha da borda aplicado à borda superior.
    direitabooleanEstilo de linha de fronteira aplicado à fronteira direita.
    bottombooleanEstilo da linha de fronteira aplicado à fronteira inferior.
    outlinebooleanEstilo da linha de fronteira aplicado apenas às fronteiras exteriores.
    insidebooleanEstilo da linha de fronteira aplicado apenas às fronteiras interiores.
    innerHorizontalbooleanEstilo de linha da borda aplicado apenas às bordas horizontais interiores.
    innerVerticalbooleanEstilo da borda aplicado apenas a bordas verticais interiores.

    Exemplo 1

    Este código produz uma borda à volta de todo o intervalo:

    $border:=New object("color";"red";"style";vk line style thick)
    $option:=New object("outline";True)
    VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option)

    Exemplo 2

    Esse código demonstra a diferença entre VP SET BORDER e a definição de bordas com o comando VP SET CELL STYLE :

    // Definir margens usando VP SET BORDER
    $border:=New object("color";"red";"style";vk line style thick)
    $option:=New object("outline";True)
    VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option)

    // // Definir margens usando VP SET CELL STYLE
    $cellStyle:=New object
    $cellStyle.borderBottom:=New object("color";"blue";"style";vk line style thick)
    $cellStyle.borderRight:=New object("color";"blue";"style";vk line style thick)
    VP SET CELL STYLE(VP Cells("ViewProArea";4;4;3;3);$cellStyle)

    Veja também

    VP SET CELL STYLE

    VP SET CELL STYLE

    VP SET CELL STYLE ( rangeObj : Object ; styleObj : Object)

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    styleObjObject->Objecto style

    |

    Descrição

    O comando VP SET CELL STYLE aplica o(s) estilo(s) definido(s) no styleObj às células definidas no rangeObj.

    Em rangeObj, passe um intervalo de células em que o estilo será aplicado. Se o rangeObj contiver várias células, o estilo será aplicado a cada célula.

    As bordas aplicadas com VP SET CELL STYLE serão aplicadas a cada célula do intervalo rangeObj, ao contrário do comando VP SET BORDER que aplica bordas ao intervalo rangeObj como um todo.

    O parâmetro styleObj permite que você passe um objeto contendo configurações de estilo. Pode utilizar uma folha de estilos existente ou criar um novo estilo. Se o styleObj contiver uma folha de estilo existente e configurações de estilo adicionais, a folha de estilo existente será aplicada primeiro, seguida pelas configurações adicionais.

    Para remover um estilo e reverter para as configurações de estilo padrão (se houver), passe um valor NULL:

    • O fato de dar ao parâmetro styleObj um valor NULL removerá todas as configurações de estilo do parâmetro rangeObj,
    • Atribuir um valor NULL a um atributo removerá esse atributo específico do rangeObj.

    Para obter mais informações sobre objetos de estilo e folhas de estilo, consulte o parágrafo Style Objects .

    Exemplo

    $style:=New object
    $style.font:="8pt Arial"
    $style.backColor:="Azure"
    $style.foreColor:="red"
    $style.hAlign:=1
    $style.isVerticalText:=True
    $style.borderBottom:=New object("color";"#800080";"style";vk line style thick)
    $style.backgroundImage:=Null //remove a specific attribute VP SET CELL STYLE(VP Cell("ViewProArea";1;1);$style)

    Veja também

    VP ADD STYLESHEET
    VP Font to object
    VP Get cell style
    VP Object to font
    VP SET BORDER
    VP SET DEFAULT STYLE

    VP SET COLUMN ATTRIBUTES

    VP SET COLUMN ATTRIBUTES ( rangeObj : Object ; propertyObj : Object)

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    propertyObjObject->Objeto que contém as propriedades da coluna

    |

    Descrição

    O comando VP SET COLUMN ATTRIBUTES aplica os atributos definidos na propriedade propertyObj às colunas no intervalo rangeObj.

    Em rangeObj, passe um objeto que contenha um intervalo. If the range contains both columns and rows, attributes are applied only to the columns.

    The propertyObj parameter lets you specify the attributes to apply to the columns in the rangeObj. Estes atributos são:

    PropriedadeTipoDescrição
    widthnumberLargura da coluna expressa em píxeis
    pageBreakbooleanTrue para inserir uma quebra de página antes da primeira coluna do intervalo, senão false
    visiblebooleanTrue se a coluna for visível, senão false
    resizablebooleanTrue se a coluna puder ser redimensionada, senão false
    headertextTexto do cabeçalho da coluna

    Exemplo

    Para alterar o tamanho da segunda coluna e definir o cabeçalho, escreve-se:

    C_OBJECT($column;$properties)

    $column:=VP Column("ViewProArea";1) //column B
    $properties:=New object("width";100;"header";"Hello World") VP SET COLUMN ATTRIBUTES($column;$properties)

    Veja também

    VP Column
    VP Get column attributes
    VP Get row attributes
    VP SET ROW ATTRIBUTES

    VP SET COLUMN COUNT

    VP SET COLUMN COUNT ( vpAreaName : Text , columnCount : Integer { , sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    columnCountInteger->Número de colunas
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP SET COLUMN COUNT define o número total de colunas em vpAreaName.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Pass the total number of columns in the columnCount parameter. columnCount deve ser superior a 0.

    In the optional sheet parameter, you can designate a specific spreadsheet where the columnCount will be applied (counting begins at 0). Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante:

    • vk current sheet

    Exemplo

    O código seguinte define cinco colunas na área 4D View Pro:

    VP SET COLUMN COUNT("ViewProArea";5)

    Veja também

    VP Get column count
    VP Get row count
    VP SET ROW COUNT

    VP SET CURRENT SHEET

    VP SET CURRENT SHEET ( vpAreaName : Text ; sheet : Integer)

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    sheetInteger<-Índice da nova folha atual

    |

    Descrição

    sets the current sheet in vpAreaName O comando VP SET CURRENT SHEET . A folha atual é a folha selecionada no documento.

    Em vpAreaName, passe o nome da área 4D View Pro.

    In sheet, pass the index of the sheet to be set as current sheet. If the index passed is inferior to 0 or exceeds the number of sheets, the command does nothing.

    A indexação começa em 0.

    Exemplo

    A folha atual do documento é a primeira folha:

    first-sheet-selected

    Definir a folha atual como a terceira folha:

    VP SET CURRENT SHEET("ViewProArea";2)

    Veja também

    VP Get current sheet

    VP SET CUSTOM FUNCTIONS

    VP SET CUSTOM FUNCTIONS ( vpAreaName : Text ; formulaObj : Object )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    formulaObjObject->Objecto fórmula

    |

    Descrição

    O comando VP SET CUSTOM FUNCTIONS designates the 4D formulas that can be called directly from 4D View Pro formulas. Because custom functions are not stored in the document,VP SET CUSTOM FUNCTIONS must be executed in the On Load form event.

    As fórmulas especificadas por VP SET CUSTOM FUNCTIONS aparecem em um menu pop-up quando a primeira letra de seu nome é inserida. Consulte a página Fórmulas e funções.

    Se VP SET CUSTOM FUNCTIONS for chamado várias vezes para a mesma área, na mesma sessão, apenas a última chamada é tida em conta.

    Passe o nome da área 4D View Pro em vpAreaName. Se passar um nome que não existe, é devolvido um erro.

    In the formulaObj parameter, pass an object containing the 4D formulas that can be called from 4D View Pro formulas as well as additional properties. Each customFunction property passed in formulaObj becomes the name of a function in the 4D View Pro area.

    PropriedadeTipoDescrição
    <customFunction>ObjectDefinição da função personalizada. <customFunction> defines the name of the custom function to display in 4D View Pro formulas (no spaces allowed)
    formulaObjectObjeto fórmula 4D (obrigatório). Ver o comando Formula.
    parametersUma coleção de objetosColeção de parâmetros (pela ordem em que são definidos na fórmula)
    [ ].nameTextNome do parâmetro a mostrar no 4D View Pro
    [ ].typeNumberTipo do parâmetro. Tipos suportados:
  • Is Boolean
  • Is date
  • Is Integer
  • Is object
  • Is real
  • Is text
  • Is time
  • If type is omitted or if the default value (-1) is passed, the value is automatically sent with its type, except date or time values which are sent as an object (see Parameters section). If type is Is object, the object has the same structure as the object returned by VP Get value.
    resumoTextDescrição da fórmula a mostrar no 4D View Pro
    minParamsNumberNúmero mínimo de parâmetros
    maxParamsNumberNúmero máximo de parâmetros. Passing a number higher than the length of parameters allows declaring "optional" parameters with default type

    AVISO

    • AVISO * As soon as VP SET CUSTOM FUNCTIONS is called, the methods allowed by the VP SET ALLOWED METHODS command (if any) are ignored in the 4D View Pro area.
    • As soon as VP SET CUSTOM FUNCTIONS is called, the functions based upon SET TABLE TITLES and SET FIELD TITLES commands are ignored in the 4D View Pro area.

    Exemplo

    You want to use formula objects in a 4D View Pro area to add numbers, retrieve a customer's last name and gender:

    Case of
    :(FORM Event.code=On Load)

    var $o : Object
    $o:=New object

    // Define "addnum" function from a method named "addnum"
    $o.addnum:=New object
    $o.addnum.formula:=Formula(addnum)
    $o.addnum.parameters:=New collection
    $o.addnum.parameters.push(New object("name";"num1";"type";Is Integer))
    $o.addnum.parameters.push(New object("name";"num2";"type";Is Integer))

    // Define "ClientLastName" function from a database field
    $o. ClientLastName:=New object
    $o. ClientLastName.formula:=Formula([Customers]lastname)
    $o. ClientLastName.summary:="Lastname of the current client"

    // Define "label" function from a 4D expression with one parameter
    $o.label:=New object
    $o.label.formula:=Formula(ds. Customers.get($1).label)
    $o.label.parameters:=New collection
    $o.label.parameters.push(New object("name";"ID";"type";Is Integer))

    // Define "Title" function from a variable named "Title"
    $o. Title:=New object
    $o. Title.formula:=Formula(Title)

    VP SET CUSTOM FUNCTIONS("ViewProArea";$o) End case

    Veja também

    VP SET ALLOWED METHODS

    VP SET DATA CONTEXT

    Histórico
    ReleaseMudanças
    19 R5Adicionado

    VP SET DATA CONTEXT ( vpAreaName : Text ; dataObj : Object {; options : Object } {; sheet : Integer} )
    VP SET DATA CONTEXT ( vpAreaName : Text ; dataColl : Collection ; {options : Object } {; sheet : Integer} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    dataObjObject->Objeto dados a carregar no contexto de dados
    dataCollCollection->Recolha de dados a carregar no contexto de dados
    optionsObject->Opções adicionais
    sheetInteger->Índice da folha

    |

    Descrição

    O comando VP SET DATA CONTEXT define o contexto de dados de uma folha. A data context is an object or a collection bound to a worksheet, and whose contents can be used to automatically fill the sheet cells, either by using an autogenerate option or the VP SET BINDING PATH method. On the other hand, the VP Get data context command can return a context containing user modifications.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    In dataObj or dataColl, pass an object or a collection containing the data to load in the data context. As imagens são convertidas em esquemas URI de dados.

    Para passar um valor de tempo em dataObj ou dataColl, encapsule-o em um objeto com as seguintes propriedades (veja o exemplo 4):

    PropriedadeTipoDescrição
    valueInteger, Real, Boolean, Text, Date, NullValor a inserir no contexto
    timeRealValor de hora (em segundos) a introduzir no contexto

    In options, you can pass an object that specifies additional options. As propriedades possíveis são:

    PropriedadeTipoDescrição
    resetObjectTrue to reset the sheet's contents before loading the new context, False (default) otherwise.
    autoGenerateColumnsObjectApenas utilizado quando os dados são uma coleção. True (default) to specify that columns must be generated automatically when the data context is bound. Neste caso, aplicam-se as seguintes regras:
    • Se dataColl for uma coleção de objetos, os nomes dos atributos serão usados como títulos das colunas (veja o exemplo 2).
    • Se dataColl contiver subcoleções de valores escalares, cada subcoleção definirá os valores em uma linha (consulte o exemplo 3). A primeira subcoleção determina o número de colunas criadas.

    In sheet, pass the index of the sheet that will receive the data context. Se nenhum índice for passado, o contexto será aplicado à folha atual.

    If you export your document to an object using VP Export to object, or to a 4DVP document using VP EXPORT DOCUMENT, the includeBindingSource option lets you copy the contents of the current contexts as cell values in the exported object or document. Para obter mais detalhes, consulte a descrição desses métodos.

    Exemplo

    Passa um objeto e associa os dados de contexto às células da primeira linha:

    var $data : Object

    $data:=New object

    $data.firstName:="Freehafer"
    $data.lastName:="Nancy" VP SET DATA CONTEXT("ViewProArea"; $data) VP SET BINDING PATH(VP Cell("ViewProArea"; 0; 0); "firstName")
    VP SET BINDING PATH(VP Cell("ViewProArea"; 1; 0); "lastName")

    Exemplo 2

    Passe uma coleção de objetos e gere colunas automaticamente:

    var $options : Object
    var $data : Collection

    $data:=New collection()
    $data.push(New object("firstname"; "John"; "lastname"; "Smith"))
    $data.push(New object("firstname"; "Mary"; "lastname"; "Poppins"))

    $options:=New object("autoGenerateColumns"; True) VP SET DATA CONTEXT("ViewProArea"; $data; $options)

    Exemplo 3

    data passada como parâmetro é uma coleção que contém subcoleções. Cada subcoleção define o conteúdo de uma linha:

    var $data : Collection
    var $options : Object

    $data:=New collection
    $data.push(New collection(1; 2; 3; False; "")) // 5 columns are created
    $data.push(New collection) // Second row is empty
    $data.push(New collection(4; 5; Null; "hello"; "world")) // Third row has 5 values
    $data.push(New collection(6; 7; 8; 9)) // Fourth row has 4 values

    $options:=New object("autoGenerateColumns"; True) VP SET DATA CONTEXT("ViewProArea"; $data; $options)

    Exemplo 4 - Sintaxe de data e hora

    var $data : Collection
    var $options : Object

    $data:= New collection()

    // Dates can be passed as scalar values
    $data.push(New collection("Date"; Current date))

    // Time values must be passed as object attributes
    $data.push(New collection("Time"; New object("time"; 5140)))

    // Date + time example
    $data.push(New collection("Date + Time"; New object("value"; Current date; "time"; 5140)))

    $options:=New object("autoGenerateColumns"; True)

    VP SET DATA CONTEXT("ViewProArea"; $data; $options)

    Eis o resultado após as colunas serem geradas:

    Veja também

    VP SET BINDING PATH
    VP Get binding path
    VP Get data context

    VP SET DATE TIME VALUE

    VP SET DATE TIME VALUE ( rangeObj : Object ; dateValue : Date ; timeValue : Time {; formatPattern : Text } )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    dateValueDate->Valor date a definir
    timeValueHora->Valor hora a definir
    formatPatternText->Formato do valor

    |

    Descrição

    O comando VP SET DATE TIME VALUE atribui um valor de data e hora especificado a um intervalo de células designado.

    Em rangeObj, passe um intervalo da(s) célula(s) (criada(s), por exemplo, com VP Cell ou VP Column) cujo valor você deseja especificar. Se rangeObj incluir várias células, o valor especificado será repetido em cada célula.

    The dateValue parameter specifies a date value to be assigned to the rangeObj.

    The timeValue parameter specifies a time value (expressed in seconds) to be assigned to the rangeObj.

    The optional formatPattern defines a pattern for the dateValue and timeValue parameters. Para obter informações sobre padrões e caracteres de formatação, consulte a seção Formatos de data e hora.

    Exemplo

    //Set the cell value as the current date and time VP SET DATE TIME VALUE(VP Cell("ViewProArea";6;2);Current time;Current date;vk pattern full date time)


    //Set the cell value as the 18th of December VP SET DATE TIME VALUE(VP Cell("ViewProArea";3;9);!2024-12-18!;?14:30:10?;vk pattern sortable date time)

    Veja também

    4D View Pro cell format
    VP SET DATE VALUE
    VP SET TIME VALUE
    VP SET VALUE

    VP SET DATE VALUE

    VP SET DATE VALUE ( rangeObj : Object ; dateValue : Date { ; formatPattern : Text } )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    dateValueDate->Valor date a definir
    formatPatternText->Formato do valor

    |

    Descrição

    O comando VP SET DATE VALUE atribui um valor de data especificado a um intervalo de células designado.

    Em rangeObj, passe um intervalo dá(s) célula(s) cujo valor pretende especificar. Se rangeObj incluir várias células, o valor especificado será repetido em cada célula.

    The dateValue parameter specifies a date value to be assigned to the rangeObj.

    The optional formatPattern defines a pattern for the dateValue parameter. Passe qualquer formato personalizado ou você pode usar uma das seguintes constantes:

    ParâmetrosDescriçãoPadrão predefinido dos EUA
    vk pattern long dateFormato ISO 8601 para a data completa"dddd, dd MMMM yyyy"
    vk pattern month dayFormato ISO 8601 para o mês e o dia"MMMM dd"
    vk pattern short dateFormato ISO 8601 abreviado para a data"MM/dd/yyyy"
    vk pattern year monthFormato ISO 8601 para o mês e o ano"yyyy MMMM"

    Para obter informações sobre padrões e caracteres de formatação, consulte a seção Formatos de data e hora.

    Exemplo

    //Set the cell value to the current date VP SET DATE VALUE(VP Cell("ViewProArea";4;2);Current date))

    //Set the cell value to a specific date with a designated format VP SET DATE VALUE(VP Cell("ViewProArea";4;4);Date("12/25/94");"d/m/yy ")
    VP SET DATE VALUE(VP Cell("ViewProArea";4;6);!2005-01-15!;vk pattern month day)

    Veja também

    4D View Pro cell format
    VP SET DATE TIME VALUE
    VP SET VALUE

    VP SET DEFAULT STYLE

    VP SET DEFAULT STYLE ( vpAreaName : Text ; styleObj : Object { ; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    styleObjObject->Objecto estilo
    sheetInteger->Índice da folha (padrão = folha atual)

    |

    Descrição

    O comando VP SET DEFAULT STYLE defines the style in the styleObj as the default style for a sheet.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    The styleObj lets you pass an object containing style settings. Você pode usar uma folha de estilo existente ou criar um estilo. Para obter mais informações, consulte o parágrafo Objetos estilo.

    In the optional sheet parameter, you can designate a specific spreadsheet where the style will be defined. Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante:

    • vk current sheet

    Exemplo

    $style:=New object
    $style.hAlign:=vk horizontal align left
    $style.font:="12pt papyrus"
    $style.backColor:="#E6E6FA" //light purple color VP SET DEFAULT STYLE("myDoc";$style)

    Veja também

    VP ADD STYLESHEET
    VP Font to object
    VP Get default style
    VP Object to font
    VP SET BORDER
    VP SET CELL STYLE

    VP SET FIELD

    VP SET FIELD ( rangeObj : Object ; field : Pointer { ; formatPattern : Text } )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    campoPonteiro->Referência ao campo na estrutura virtual
    formatPatternText->Formato do campo

    |

    Descrição

    O comando VP SET FIELD atribui um campo virtual do banco de dados 4D a um intervalo de células designado.

    Em rangeObj, passe um intervalo dá(s) célula(s) cujo valor pretende especificar. In rangeObj, pass a range of the cell(s) whose value you want to specify.

    The field parameter specifies a 4D database virtual field to be assigned to the rangeObj. The virtual structure name for field can be viewed in the formula bar. If any of the cells in rangeObj have existing content, it will be replaced by field.

    The optional formatPattern defines a pattern for the field parameter. Você pode passar qualquer formato personalizado válido.

    Exemplo

    VP SET FIELD(VP Cell("ViewProArea";5;2);->[TableName]Field)

    Veja também

    VP SET VALUE

    VP SET FORMULA

    VP SET FORMULA ( rangeObj : Object ; formula : Text { ; formatPattern : Text } )

    | Parâmetro | Tipo | | Descrição | | --------- | ---- | | --------- | | | | | |

    |rangeObj |Object|->|Range object| |formula |Text|->|Formula or 4D method| |formatPattern |Text|->|Format of field|

    Descrição

    O comando VP SET FORMULA atribui uma fórmula ou um método 4D especificado a um intervalo de células designado.

    Em rangeObj, passe um intervalo da(s) célula(s) (criada(s), por exemplo, com VP Cell ou VP Column) cujo valor você deseja especificar. In rangeObj, pass a range of the cell(s) (created for example with VP Cell or VP Column) whose value you want to specify.

    The formula parameter specifies a formula or 4D method name to be assigned to the rangeObj.

    If the formula is a string, use the period . as numerical separator and the comma , as parameter separator. If a 4D method is used, it must be allowed with the VP SET ALLOWED METHODS command.

    The optional formatPattern defines a pattern for the formula.

    You remove the formula in rangeObj by replacing it with an empty string ("").

    Exemplo 1

    VP SET FORMULA(VP Cell("ViewProArea";5;2);"SUM($A$1:$C$10)")

    Exemplo 2

    Para remover a fórmula:

    VP SET FORMULA(VP Cell("ViewProArea";5;2);"")

    Exemplo 3

    VP SET FORMULA($range; "SUM(A1,B7,C11)") //"," para separar parâmetros

    Veja também

    Cell format
    VP Get Formula
    VP SET FORMULAS
    VP SET VALUE

    VP SET FORMULAS

    VP SET FORMULAS ( rangeObj : Object ; formulasCol : Collection )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo de células
    formulasColCollection->Colecção de fórmulas

    |

    Descrição

    O comando VP SET FORMULAS atribui uma coleção de fórmulas que começa no intervalo de células especificado.

    In rangeObj, pass a range of the cell (created with VP Cell) whose formula you want to specify. Se rangeObj incluir vários intervalos, somente o primeiro será usado.

    O parâmetro formulasCol é uma coleção bidimensional:

    • A coleção de primeiro nível contém subcoleções de fórmulas. Cada subcolecção define uma linha.
    • Cada subcoleção define os valores das células para a linha. Values must be text elements containing the formulas to assign to the cells.

    If the formula is a string, use the period . as numerical separator and the comma , as parameter separator. If a 4D method is used, it must be allowed with the VP SET ALLOWED METHODS command.

    You remove the formulas in rangeObj by replacing them with an empty string ("").

    Exemplo 1

    $formulas:=New collection
    $formulas.push(New collection("MAX(B11,C11,D11)";"myMethod(G4)")) // First row
    $formulas.push(New collection("SUM(B11:D11)";"AVERAGE(B11:D11)")) // Second row VP SET FORMULAS(VP Cell("ViewProArea";6;3);$formulas) // Set the cells with the formulas

    myMethod:

    $0:=$1*3.33

    Exemplo 2

    Para remover fórmulas:

    $formulas:=New collection
    $formulas.push(New collection("";"")) // first collection
    $formulas.push(New collection("";"")) // second collection VP SET FORMULAS(VP Cell("ViewProArea";0;0);$formulas) // Assign to cells

    Veja também

    VP Get Formulas
    VP GET VALUESVP SET FORMULA
    VP SET VALUES

    VP SET FROZEN PANES

    VP SET FROZEN PANES ( vpAreaName : Text ; paneObj : Object { ; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    paneObjObject->Objeto que contém as informações sobre as colunas e linhas congeladas
    sheetInteger->Índice da folha (folha atual se omitida)

    Descrição

    O comando VP SET FROZEN PANES sets the frozen status of the columns and rows in the paneObj so they are always displayed in the vpAreaName. Frozen columns and rows are fixed in place and do not move when the rest of the document is scrolled. Uma linha sólida é exibida para indicar que as colunas e linhas estão congeladas. The location of the line depends on where the frozen column or row is on the sheet:

    • Columns on the left or right: For columns on the left of the sheet, the line is displayed on the right side of the last frozen column. For columns on the right side of the sheet, the line is displayed on the left side of the first frozen column.
    • Rows on the top or bottom: For rows at the top of the sheet, the line is displayed below the last frozen row. For rows at the bottom of the sheet, the line is displayed above the first frozen row.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    You can pass an object defining the columns and rows to freeze in the paneObj parameter. Setting the value of any of the column or row properties equal to zero resets (unfreezes) the property. Se uma propriedade for definida para menos de zero, o comando não fará nada. Pode passar:

    PropriedadeTipoDescrição
    columnCountIntegerO número de colunas congeladas à esquerda da folha
    trailingColumnCountIntegerO número de colunas congeladas à direita da folha
    rowCountIntegerO número de linhas congeladas na parte superior da folha
    trailingRowCountIntegerO número de linhas congeladas na parte inferior da folha

    No parâmetro opcional sheet, pode designar uma folha específica onde o intervalo será definido (a contagem começa em 0). Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante:

    • vk current sheet

    Exemplo

    You want to freeze the first three columns on the left, two columns on the right, and the first row:

    C_OBJECT($panes)

    $panes:=New object
    $panes.columnCount:=3
    $panes.trailingColumnCount:=2
    $panes.rowCount:=1 VP SET FROZEN PANES("ViewProArea";$panes)

    Veja também

    VP Get frozen panes

    VP SET NUM VALUE

    VP SET NUM VALUE ( rangeObj : Object ; numberValue : Number { ; formatPattern : Text } )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    numberValueNumber->Valor do número a definir
    formatPatternText->Formato do valor

    |

    Descrição

    O comando VP SET NUM VALUE atribui um valor numérico especificado a um intervalo de células designado.

    Em rangeObj, passe um intervalo da(s) célula(s) (criada(s), por exemplo, com VP Cell ou VP Column) cujo valor você deseja especificar. Se rangeObj incluir várias células, o valor especificado será repetido em cada célula.

    The numberValue parameter specifies a numeric value to be assigned to the rangeObj.

    The optional formatPattern defines a pattern for the numberValue parameter.

    Exemplo

    VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";False))

    //Set the cell value as 2 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";2))

    //Set the cell value as $125,571.35

    Veja também

    Cell format
    VP SET VALUE

    VP SET PRINT INFO

    VP SET PRINT INFO ( vpAreaName : Text ; printInfo : Object { ; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro
    printInfoObject->Objeto que contém atributos de impressão
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP SET PRINT INFO define os atributos a serem usados ao imprimir o vpAreaName.

    Passe o nome da área 4D View Pro a ser impressa em vpAreaName. Se passar um nome que não existe, é devolvido um erro.

    Pode passar um objeto que contenha as definições para vários atributos de impressão no parâmetro printInfo. Para ver a lista completa dos atributos disponíveis, consulte Atributos de impressão.

    No parâmetro opcional sheet , você pode designar uma planilha específica para imprimir (a contagem começa às 0). Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante:

    • vk current sheet

    Exemplo

    O código seguinte imprime uma área 4D View Pro num documento PDF:

    var $printInfo : Object

    //declare print attributes object
    $printInfo:=New object

    //define print attributes
    $printInfo.headerCenter:="&BS. H.I.E.L.D. &A Sales Per Region"
    $printInfo.firstPageNumber:=1
    $printInfo.footerRight:="page &P of &N"
    $printInfo.orientation:=vk print page orientation landscape
    $printInfo.centering:=vk print centering horizontal
    $printInfo.columnStart:=0
    $printInfo.columnEnd:=8
    $printInfo.rowStart:=0
    $printInfo.rowEnd:=24

    $printInfo.showGridLine:=True

    //Add corporate logo
    $printInfo.headerLeftImage:=logo.png
    $printInfo.headerLeft:="&G"

    $printInfo.showRowHeader:=vk print visibility hide
    $printInfo.showColumnHeader:=vk print visibility hide
    $printInfo.fitPagesWide:=1
    $printInfo.fitPagesTall:=1

    //print PDF document VP SET PRINT INFO ("ViewProArea";$printInfo)

    //export the PDF VP EXPORT DOCUMENT("ViewProArea";"Sales2018.pdf";New object("formula";Formula(ALERT("PDF ready!"))))

    O PDF:

    Veja também

    4D View Pro print attributes
    VP Convert to picture
    VP Get print info
    VP PRINT

    VP SET ROW ATTRIBUTES

    VP SET ROW ATTRIBUTES ( rangeObj : Object ; propertyObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Intervalo de linhas
    propertyObjObject->Objeto que contém as propriedades da linhas

    |

    Descrição

    O comando VP SET ROW ATTRIBUTES applies the attributes defined in the propertyObj to the rows in the rangeObj.

    Em rangeObj, passe um objeto que contenha um intervalo. Se o intervalo contiver colunas e linhas, os atributos são aplicados apenas às linhas.

    O parâmetro propertyObj permite-lhe especificar os atributos a aplicar às linhas no rangeObj. Estes atributos são:

    PropriedadeTipoDescrição
    heightnumberAltura da linha expressa em píxeis
    pageBreakbooleanTrue para inserir uma quebra de página antes da primeira linha do intervalo, senão false
    visiblebooleanTrue se a linha for visível, senão false
    resizablebooleanTrue se a linha puder ser redimensionada, senão false
    headertextTexto do cabeçalho da linha

    Exemplo

    Pretende-se alterar o tamanho da segunda linha e definir o cabeçalho:

    var $row; $properties : Object

    $row:=VP Row("ViewProArea";1)
    $properties:=New object("height";75;"header";"June") VP SET ROW ATTRIBUTES($row;$properties)

    Veja também

    VP Get row attributes
    VP get column attributes
    VP SET ROW ATTRIBUTES

    VP SET ROW COUNT

    VP SET ROW COUNT ( vpAreaName : Text ; rowCount : Integer { ; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    rowCountInteger->Número de linhas
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP SET ROW COUNT define o número total de linhas em vpAreaName.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    Passe o número total de linhas no parâmetro rowCount. rowCount tem de ser superior a 0.

    In the optional sheet parameter, you can designate a specific spreadsheet where the rowCount will be applied (counting begins at 0). Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante:

    • vk current sheet

    Exemplo

    O código seguinte define cinco linhas na área 4D View Pro:

    VP SET ROW COUNT("ViewProArea";5)

    Veja também

    VP Get column count
    VP get row-count
    VP SET COLUMN COUNT

    VP SET SELECTION

    VP SET SELECTION ( rangeObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo de células

    |

    Descrição

    O comando VP SET SELECTION defines the specified cells as the selection and the first cell as the active cell.

    In rangeObj, pass a range object of cells to designate as the current selection.

    Exemplo

    $currentSelection:=VP Combine ranges(VP Cells("myVPArea";3;2;1;6);VP Cells("myVPArea";5;7;1;7))
    VP SET SELECTION($currentSelection)

    Veja também

    VP Get active cell
    VP Get selection
    VP RESET SELECTION
    VP SET ACTIVE CELL
    VP ADD SELECTION
    VP SHOW CELL

    VP SET SHEET COUNT

    VP SET SHEET COUNT ( vpAreaName : Text ; number : Integer )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    numberInteger->Número de folhas

    |

    Descrição

    O comando VP SET SHEET COUNT define o número de folhas em vpAreaName.

    In number, pass a number corresponding to how many sheets the document will contain after the command is executed.

    Warning: The command will delete sheets if the previous amount of sheets in your document is superior to the number passed. For example, if there are 5 sheets in your document and you set the sheet count to 3, the command will delete sheets number 4 and 5.

    Exemplo

    O documento tem atualmente uma folha:

    Para definir o número de folhas como 3:

    VP SET SHEET COUNT("ViewProArea";3)

    Veja também

    VP Get sheet count

    VP SET SHEET NAME

    VP SET SHEET NAME ( vpAreaName : Text ; name : Text {; sheet: Integer} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    nameText->Novo nome para a folha
    sheetInteger->Índice da folha a ser renomeada

    |

    Descrição

    O comando VP SET SHEET NAME renomeia uma planilha no documento carregado em vpAreaName.

    Em vpAreaName, passe o nome da área 4D View Pro.

    Em name, introduza um novo nome para a folha.

    Em sheet, passe o índice da folha a ser renomeada.

    A indexação começa em 0.

    If no sheet is passed, the command renames the current sheet.

    O novo nome não pode conter os seguintes caracteres: *, :, [, ], ?,\,/

    O comando não faz nada se:

    • o novo nome contém caracteres proibidos
    • o valor do novo nome está em branco
    • o novo nome já existe
    • the passed sheet does not exist

    Exemplo

    Defina o nome da terceira folha como "Total first quarter":

    VP SET SHEET NAME("ViewProArea";"Total first quarter";2)

    VP SET SHEET OPTIONS

    VP SET SHEET OPTIONS ( vpAreaName : Text; sheetOptions : Object { ; sheet : Integer} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro
    sheetOptionsObject->Opção(ões) de folha a definir
    sheetObject->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP SET SHEET OPTIONS permite definir várias opções de folha da área vpAreaName.

    Passe o nome da área 4D View Pro em vpAreaName. Se passar um nome que não existe, é devolvido um erro.

    Pass an object containing definitions for the options to set in the sheetOptions parameter. To view the full list of the available options, see the Sheet Options paragraph.

    No parâmetro opcional sheet, pode designar uma planilha específica (a contagem começa em 0). Se omitido, a planilha atual será utilizada por padrão. Você pode selecionar explicitamente a planilha atual com a seguinte constante:

    • vk current sheet

    Exemplo 1

    Pretende proteger todas as células exceto o intervalo C5:D10:

    // Activate protection on the current sheet
    var $options : Object

    $options:=New object
    $options.isProtected:=True VP SET SHEET OPTIONS("ViewProArea";$options)

    // mark cells C5:D10 as 'unlocked' VP SET CELL STYLE(VP Cells("ViewProArea";2;4;2;6);New object("locked";False))

    Exemplo 2

    You need to protect your document while your users can resize rows and columns:

    var $options : Object

    $options:=New object
    // Activate protection
    $options.isProtected:=True
    $options.protectionOptions:=New object
    // Allow user to resize rows
    $options.protectionOptions.allowResizeRows=True;
    // Allow user to resize columns
    $options.protectionOptions.allowResizeColumns=True;

    // Apply protection on the current sheet VP SET SHEET OPTIONS("ViewProArea";$options)

    Exemplo 3

    You want to customize the colors of your sheet tabs, frozen lines, grid lines, selection background and selection border:

    var $options : Object

    $options:=New object
    // Customize color of Sheet 1 tab
    $options.sheetTabColor:="Black"
    $options.gridline:=New object("color";"Purple")
    $options.selectionBackColor:="rgb(255,128,0,0.4)"
    $options.selectionBorderColor:="Yellow"
    $options.frozenlineColor:="Gold" VP SET SHEET OPTIONS("ViewProArea";$options;0)

    // Customize color of Sheet 2 tab
    $options.sheetTabColor:="red" VP SET SHEET OPTIONS("ViewProArea";$options;1)

    // Customize color of Sheet 3 tab
    $options.sheetTabColor:="blue" VP SET SHEET OPTIONS("ViewProArea";$options;2)

    Resultados:

    Exemplo

    Pretende ocultar as linhas da grelha, bem como os cabeçalhos das linhas e das colunas.

    var $options : Object

    $options:=New object

    $options.gridline:=New object()
    $options.gridline.showVerticalGridline:=False
    $options.gridline.showHorizontalGridline:=False
    $options.rowHeaderVisible:=False
    $options.colHeaderVisible:=False

    VP SET SHEET OPTIONS("ViewProArea";$options)

    Resultados:

    Veja também

    4D View Pro sheet options
    VP Get sheet options

    VP SET SHOW PRINT LINES

    VP SET SHOW PRINT LINES ( vpAreaName : Text {; visible : Boolean}{; sheet : Integer} )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    visibleParâmetros->Linhas de impressão apresentadas se True (padrão), ocultas se False
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP SET SHOW PRINT LINES define se as linhas de pré-visualização da impressão devem ser apresentadas numa folha..

    Em vpAreaName, passe o nome da área 4D View Pro.

    In visible, pass True to display the print lines, and False to hide them. True é passado por defeito.

    Em sheet, passe o índice da folha de destino. Se nenhum índice for especificado, o comando se aplica à folha atual.

    A indexação começa em 0.

    The position of a spreadsheet's print lines varies according to that spreadsheet's page breaks.

    Exemplo

    O código a seguir exibe linhas de impressão na segunda folha de um documento:

    VP SET SHOW PRINT LINES("ViewProArea";True;1)

    set-show-print-lines

    Com uma quebra de página:

    set-show-print-lines-with-page-break

    Veja também

    4D Get show print lines

    VP SET TABLE COLUMN ATTRIBUTES

    Histórico
    ReleaseMudanças
    18 R6Adicionado

    VP SET TABLE COLUMN ATTRIBUTES ( vpAreaName : Text ; tableName : Text ; column : Integer ; attributes : Object {; sheet : Integer } )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    columnInteger->Índice da coluna na tabela
    attributesObject->Atributo(s) a aplicar à column
    sheetInteger->Índice da folha (folha atual se omitida)

    |

    Descrição

    O comando VP SET TABLE COLUMN ATTRIBUTES aplica os attributes definidos à column na tabela tableName.

    Em vpAreaName, passe o nome da área 4D View Pro.

    In the attributes parameter, pass an object that contains the properties to set:

    PropriedadeTipoDescrição
    dataFieldtextNome da propriedade da coluna da tabela no contexto de dados.
    nametextNome da coluna da tabela. Deve ser único na tabela. If this name already used by another column, it is not applied and a default name is automaticaly used.
    formulatextDefine a fórmula para cada célula da coluna. Veja Structured Reference Formulas na documentação SpreadJS
    footerTexttextValor do rodapé da coluna.
    footerFormulatextFórmula do rodapé da coluna.
    filterButtonVisiblebooleanSets whether the table column's filter button is displayed (default is True when the table is created).

    Em sheet, passe o índice da folha de destino. Se nenhum indice for especcificado ou se passar -1, o comando se aplica a folha atual.

    A indexação começa em 0.

    If tableName is not found or if column is higher than the number of columns, the command does nothing.

    Exemplo

    Você cria uma tabela com um contexto de dados:

    var $context;$options : Object

    $context:=New object()
    $context.col:=New collection()
    $context.col.push(New object("name"; "Smith"; "firstname"; "John"; "salary"; 10000))
    $context.col.push(New object("name"; "Wesson"; "firstname"; "Jim"; "salary"; 50000))
    $context.col.push(New object("name"; "Gross"; "firstname"; "Maria"; "salary"; 10500))
    VP SET DATA CONTEXT("ViewProArea"; $context)

    //Define the columns for the table
    $options:=New object()
    $options.tableColumns:=New collection()
    $options.tableColumns.push(New object("name"; "Last Name"; "dataField"; "name"))
    $options.tableColumns.push(New object("name"; "Salary"; "dataField"; "salary")) VP CREATE TABLE(VP Cells("ViewProArea"; 1; 1; 2; 3); "PeopleTable"; "col"; $options)

    Then you want to insert a column with data from the data context and hide some filter buttons:

        //insert a column VP INSERT TABLE COLUMNS("ViewProArea"; "PeopleTable"; 1; 1)

    var $param : Object
    $param:=New object()
    // Bind the column to the firstname field from the datacontext
    $param.dataField:="firstname"
    // Change the default name of the column to "First name"
    // and hide the filter button
    $param.name:="First Name"
    $param.filterButtonVisible:=False VP SET TABLE COLUMN ATTRIBUTES("ViewProArea"; "PeopleTable"; 1; $param)

    // Hide the filter button of the first column VP SET TABLE COLUMN ATTRIBUTES("ViewProArea"; "PeopleTable"; 0; \
    New object("filterButtonVisible"; False))

    Veja também

    VP CREATE TABLE
    VP Find table
    VP Get table column attributes
    VP RESIZE TABLE

    VP SET TABLE THEME

    Histórico
    ReleaseMudanças
    19 R8Adicionado

    VP SET TABLE THEME ( vpAreaName : Text ; tableName : Text ; options : cs. ViewPro. TableTheme )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    tableNameText->Nome da tabela
    optionscs. ViewPro. TableTheme->Propriedades do tema da tabela a modificar

    |

    Descrição

    O comando VP SET TABLE THEME modifica o tema atual do tableName.

    In vpAreaName, pass the name of the 4D View Pro area and in tableName, the name of the table to modify.

    In the options parameter, pass an object of the cs. ViewPro. TableTheme class that contains the theme properties to modify.

    Exemplo 1

    Pretende-se definir um tema predefinido para uma tabela:

    var $param : cs. ViewPro. TableTheme
    $param:=cs. ViewPro. TableTheme.new()
    $param.theme:="medium2" VP SET TABLE THEME("ViewProArea"; "myTable"; $param)

    Exemplo 2

    Pretende ter esta renderização de coluna alternativa:

    var $param : cs. ViewPro. TableTheme
    $param:=cs. ViewPro. TableTheme.new()

    // Enable the band column rendering
    $param.bandColumns:=True
    $param.bandRows:=False

    // Create the theme object with header and column styles
    $param.theme:=cs. ViewPro. TableThemeOptions.new()

    var $styleHeader; $styleColumn; $styleColumn2 : cs. ViewPro. TableStyle

    $styleHeader:=cs. ViewPro. TableStyle.new()
    $styleHeader.backColor:="Gold"
    $styleHeader.foreColor:="#03045E"
    $param.theme.headerRowStyle:=$styleHeader

    $styleColumn1:=cs. ViewPro. TableStyle.new()
    $styleColumn1.backColor:="SkyBlue"
    $styleColumn1.foreColor:="#03045E"
    $param.theme.firstColumnStripStyle:=$styleColumn1

    $styleColumn2:=cs. ViewPro. TableStyle.new()
    $styleColumn2.backColor:="LightCyan"
    $styleColumn2.foreColor:="#03045E"
    $param.theme.secondColumnStripStyle:=$styleColumn2 VP SET TABLE THEME("ViewProArea"; "myTable"; $param)

    Veja também

    VP CREATE TABLE
    VP Get table theme

    VP SET TEXT VALUE

    VP SET TEXT VALUE ( rangeObj : Object ; textValue : Text { ; formatPattern : Text } )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    textValueText->Valor texto a definir
    formatPatternText->Formato do valor

    |

    Descrição

    O comando VP SET TEXT VALUE atribui um valor de texto especificado a um intervalo de células designado.

    Em rangeObj, passe um intervalo da(s) célula(s) (criada(s), por exemplo, com VP Cell ou VP Column) cujo valor você deseja especificar. Se rangeObj incluir várias células, o valor especificado será repetido em cada célula.

    The textValue parameter specifies a text value to be assigned to the rangeObj.

    The optional formatPattern defines a pattern for the textValue parameter.

    Exemplo

    VP SET TEXT VALUE(VP Cell("ViewProArea";3;2);"Test 4D View Pro")

    Veja também

    Cell Format
    VP SET VALUE

    VP SET TIME VALUE

    VP SET TIME VALUE ( rangeObj : Object ; timeValue : Text { ; formatPattern : Text } )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    timeValueText->Valor hora a definir
    formatPatternText->Formato do valor

    |

    Descrição

    O comando VP SET TIME VALUE atribui um valor de tempo especificado a um intervalo de células designado.

    Em rangeObj, passe um intervalo da(s) célula(s) (criada(s), por exemplo, com VP Cell ou VP Column) cujo valor você deseja especificar. Se rangeObj incluir várias células, o valor especificado será repetido em cada célula.

    The timeValue parameter specifies a time expressed in seconds to be assigned to the rangeObj.

    The optional formatPattern defines a pattern for the timeValue parameter.

    Exemplo

    //Set the value to the current time VP SET TIME VALUE(VP Cell("ViewProArea";5;2);Current time)

    //Set the value to a specific time with a designated format VP SET TIME VALUE(VP Cell("ViewProArea";5;2);?12:15:06?;vk pattern long time)

    Veja também

    Cell Format
    VP SET DATE TIME VALUE
    VP SET VALUE

    VP SET VALUE

    VP SET VALUE ( rangeObj : Object ; valueObj : Object )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    valueObjObject->Valores de células e opções de formato

    |

    Descrição

    O comando VP SET VALUE atribui um valor especificado a um intervalo de células designado.

    The command allows you to use a generic code to set and format the types of values in rangeObj, whereas other commands, such as VP SET TEXT VALUE and VP SET NUM VALUE, reduce the values to specific types.

    Em rangeObj, passe um intervalo da(s) célula(s) (criada(s), por exemplo, com VP Cell ou VP Column) cujo valor você deseja especificar. Se rangeObj incluir várias células, o valor especificado será repetido em cada célula.

    The parameter valueObj is an object that includes properties for the value and the format to assign to rangeObj. Pode incluir as seguintes propriedades:

    PropriedadeTipoDescrição
    valueInteger, Real, Boolean, Text, Date, NullValor a atribuir a rangeObj (exceto - hora). Passar null para apagar o conteúdo da célula.
    timeRealValor hora (em segundos) a atribuir a rangeObj
    formatTextPadrão para propriedade valor/tempo. For information on patterns and formatting characters, please refer to the Cell Format paragraph.

    Exemplo

    //Set the cell value to 2
    VP SET NUM VALUE(VP Cell("ViewProArea";3;2);2)

    //Set the cell value and format it in dollars

    VP SET NUM VALUE(VP Cell("ViewProArea";3;2);12.356;"_($* #,##0.00_)")

    Veja também

    Cell Format
    VP Get values
    VP SET VALUE
    VP SET BOOLEAN VALUE
    VP SET DATE TIME VALUE
    VP SET FIELD
    VP SET FORMULA
    VP SET NUM VALUE
    VP SET TEXT VALUE
    VP SET TIME VALUE

    VP SET VALUES

    VP SET VALUES ( rangeObj : Object ; valuesCol : Collection )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    valuesColCollection->Coleção de valores

    |

    Descrição

    O comando VP SET VALUES atribui uma coleção de valores começando no intervalo de células especificado.

    In rangeObj, pass a range for the cell (created with VP Cell) whose value you want to specify. The cell defined in the rangeObj is used to determine the starting point.

    • If rangeObj is not a cell range, only the first cell of the range is used.
    • If rangeObj includes multiple ranges, only the first cell of the first range is used.

    O parâmetro valuesCol é bidimensional:

    • A coleção de primeiro nível contém subcoleções de valores. Cada subcolecção define uma linha. Passa uma coleção vazia para saltar uma linha.
    • Cada subcoleção define os valores das células para a linha. Os valores podem ser Integer, Real, Boolean, Text, Date, Null ou Object. Se o valor for um objeto, pode ter as seguintes propriedades:
    PropriedadeTipoDescrição
    valueInteger, Real, Boolean, Text, Date, NullValor da célula (exceto - time)
    timeRealValor hora (em segundos)

    Exemplo

    $param:=New collection
    $param.push(New collection(1;2;3;False)) //first row, 4 values
    $param.push(New collection) //second row, untouched
    $param.push(New collection(4;5;Null;"hello";"world")) // third row, 5 values
    $param.push(New collection(6;7;8;9)) // fourth row, 4 values
    $param.push(New collection(Null;New object("value";Current date;"time";42))) //fifth row, 1 value VP SET VALUES(VP Cell("ViewProArea";2;1);$param)

    Veja também

    VP Get formulas
    VP Get value
    VP Get Values
    VP SET FORMULAS
    VP SET VALUE

    VP SET WORKBOOK OPTIONS

    VP SET WORKBOOK OPTIONS ( vpAreaName : Text ; optionObj : Object)

    ParâmetroTipoDescrição
    vpAreaNameText->Nome de objeto formulário área 4D View Pro
    optionObjObject->Objeto que contém as opções do livro a definir

    |

    Descrição

    VP SET WORKBOOK OPTIONS define as opções do livro de trabalho em vpAreaName.

    Em vpAreaName, passe o nome da área 4D View Pro.

    Em optionObj, passe as opções da pasta de trabalho a serem aplicadas a vpAreaName.

    Se optionObj estiver vazio, o comando não fará nada.

    As opções modificadas do livro são guardadas com o documento.

    A tabela seguinte lista as opções de libro disponíveis:

    PropriedadeTipoDescrição
    allowUserDragMergebooleanThe drag merge operation is allowed (select cells and drag the selection to merge cells)
    allowAutoCreateHyperlinkbooleanPermite a criação automática de hiperlinks na planilha.
    allowContextMenubooleanO menu de contexto incorporado pode ser aberto.
    allowCopyPasteExcelStylebooleanStyles from a spreadsheet can be copied and pasted to Excel, and vice-versa.
    allowDynamicArraybooleanPermite arrays dinâmicos em folhas de trabalho
    allowExtendPasteRangebooleanEstende o intervalo colado se o intervalo colado não for suficiente para os dados colados
    allowSheetReorderbooleanÉ permitida a reordenação de folhas
    allowUndobooleanÉ permitido desfazer as edições.
    allowUserDeselectbooleanÉ permitido desmarcar células específicas de uma seleção.
    allowUserDragDropbooleanÉ permitido arrastar e largar dados de intervalo
    allowUserDragFillbooleanÉ permitido o preenchimento por arrastamento
    allowUserEditFormulabooleanAs fórmulas podem ser introduzidas nas células
    allowUserResizebooleanAs colunas e as linhas podem ser redimensionadas
    allowUserZoombooleanÉ permitido fazer zoom (ctrl + roda do rato)
    autoFitTypenumberO conteúdo é formatado para caber em células, ou células e cabeçalhos. Valores disponíveis:
    ParâmetrosValorDescrição
    vk auto fit type cell 0 O conteúdo ajusta-se automaticamente às células
    vk auto fit type cell with header 1 O conteúdo ajusta automaticamente as células e os cabeçalhos
    backColorstringA color string used to represent the background color of the area, such as "red", "#FFFF00", "rgb(255,0,0)", "Accent 5". A cor de fundo inicial fica oculta quando uma backgroundImage é definida.
    backgroundImagestring / picture / fileImagem de fundo para a área.
    backgroundImageLayoutnumberComo é apresentada a imagem de fundo. Valores disponíveis:
    ParâmetrosValorDescrição
    vk image layout center 1 No centro da zona.
    vk image layout none 3 No canto superior esquerdo da área, com seu tamanho original.
    vk image layout stretch 0 Preenche a área.
    vk image layout zoom 2 Mostrado com o seu rácio de aspeto original.
    calcOnDemandbooleanAs fórmulas só são calculadas quando são solicitadas.
    columnResizeModenumberModo de redimensionamento de colunas. Valores disponíveis:
    ParâmetrosValorDescrição
    vk resize mode normal 0 Utilizar o modo de redimensionamento normal (ou seja, as restantes colunas são afetadas)
    vk resize mode split 1 Usar o modo split (ou seja, as colunas restantes não são afetadas)
    copyPasteHeaderOptionsnumberCabeçalhos a incluir quando os dados são copiados ou colados. Valores disponíveis:
    ParâmetrosValorDescrição
    vk copy paste header options all headers3 Includes selected headers when data is copied; overwrites selected headers when data is pasted.
    vk copy paste header options column headers 2 Includes selected column headers when data is copied; overwrites selected column headers when data is pasted.
    vk copy paste header options no headers0 Column and row headers are not included when data is copied; does not overwrite selected column or row headers when data is pasted.
    vk copy paste header options row headers1 Includes selected row headers when data is copied; overwrites selected row headers when data is pasted.
    customListcollectionThe list for users to customize drag fill, prioritize matching this list in each fill. Cada item da coleção é um conjunto de cadeias de caracteres. See on GrapeCity's website.
    cutCopyIndicatorBorderColorstringBorder color for the indicator displayed when the user cuts or copies the selection.
    cutCopyIndicatorVisiblebooleanApresenta um indicador quando se copia ou corta o item selecionado.
    defaultDragFillTypenumberO tipo de preenchimento de arrastamento padrão. Valores disponíveis:
    ParâmetrosValorDescrição
    vk auto fill type auto 5 Preenche automaticamente as células.
    vk auto fill type clear values 4 Limpa os valores das células.
    vk auto fill type copycells 0 Preenche as células com todos os objetos de dados, incluindo valores, formatação e fórmulas.
    vk auto fill type fill formatting only 2 Preenche as células apenas com formatação.
    vk auto fill type fill series 1 Preenche as células com séries.
    vk auto fill type fill without formatting 3 Preenche as células com valores e não com formatação.
    enableAccessibilitybooleanO suporte de acessibilidade está ativado na folha de cálculo.
    enableFormulaTextboxbooleanA caixa de texto da fórmula está activada.
    grayAreaBackColorstringA color string used to represent the background color of the gray area , such as "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", and so on.
    highlightInvalidDatabooleanOs dados inválidos são realçados.
    iterativeCalculationbooleanAtiva o cálculo iterativo. Veja em o site de Grapecity.
    iterativeCalculationMaximumChangenumericQuantidade máxima de variação entre dois valores de cálculo.
    iterativeCalculationMaximumIterationsnumericNúmero de vezes que a fórmula deve ser recalculada.
    newTabVisiblebooleanApresentar um separador especial para permitir que os usuários insiram novas folhas.
    numbersFitModenumberMuda o modo de exibição quando a largura de dados/data é maior que a largura da coluna. Valores disponíveis:
    ParâmetrosValorDescrição
    vk numbers fit mode mask0 Substituir o conteúdo dos dados por "####" e mostra a dica
    vk numbers fit mode overflow 1 Mostra o conteúdo dos dados como uma cadeia de caracteres. Se a célula seguinte estiver vazia, transborda o conteúdo.
    pasteSkipInvisibleRangebooleanColar ou ignorar a colagem de dados em intervalos invisíveis:
    • Falso (padrão): colar dados
    • True: Saltar a colagem em intervalos invisíveis
    Consulte a documentação da Grapecidade para obter mais informações sobre intervalos invisíveis.
    referenceStylenumberEstilo para referências de células e intervalos em fórmulas de células. Valores disponíveis:
    ParâmetrosValorDescrição
    vk reference style A1 0 Utilizar o estilo A1.
    vk reference style R1C1 1 Utilizar o estilo R1C1
    resizeZeroIndicatornumberPolítica de desenho quando a linha ou coluna é redimensionada para zero. Valores disponíveis:
    ParâmetrosValorDescrição
    vk resize zero indicator default 0 Usa a política de desenho atual quando a linha ou coluna é redimensionada para zero.
    vk resize zero indicator enhance 1 Desenha duas linhas curtas quando a linha ou coluna é redimensionada para zero.
    rowResizeModenumberA forma como as linhas são redimensionadas. Os valores disponíveis são os mesmos que columnResizeMode
    scrollbarAppearancenumberAspeto da barra de deslocação. Valores disponíveis:
    ParâmetrosValorDescrição
    vk scrollbar appearance mobile1 Aparência da barra de deslocação móvel.
    vk scrollbar appearance skin (padrão)0 Aparência da barra de deslocação clássica semelhante à do Excel.
    scrollbarMaxAlignbooleanA barra de rolagem se alinha com a última linha e coluna da folha ativa.
    scrollbarShowMaxbooleanThe displayed scroll bars are based on the entire number of columns and rows in the sheet.
    scrollByPixelbooleanAtivar a deslocação de precisão por pixel.
    scrollIgnoreHiddenbooleanA barra de rolagem ignora as linhas ou colunas ocultas.
    scrollPixelintegerDecides scrolling by that number of pixels at a time when scrollByPixel is true. Os pixels de rolagem finais são o resultado de scrolling delta * scrollPixel. For example: scrolling delta is 3, scrollPixel is 5, the final scrolling pixels are 15.
    showDragDropTipbooleanExibir a dica de arrastar e soltar.
    showDragFillSmartTagbooleanExibe a caixa de diálogo de arrastar e preencher.
    showDragFillTipbooleanExibir a dica de preenchimento de arrasto.
    showHorizontalScrollbarbooleanMostrar a barra de deslocação horizontal.
    showResizeTipnumberPosition of the tab strip. Valores disponíveis:
    ParâmetrosValorDescrição
    vk show resize tip both 3 São apresentadas dicas de redimensionamento horizontal e vertical.
    vk show resize tip column 1 Só é mostrada a ponta de redimensionamento horizontal.
    vk show resize tip none 0 Nenhuma dica de redimensionamento é exibida.
    vk show resize tip row 2 Somente a ponta de redimensionamento vertical é exibida.
    showScrollTipnumberPosition of the tab strip. Valores disponíveis:
    ParâmetrosValorDescrição
    vk show scroll tip both 3 São apresentadas dicas de deslocação horizontal e vertical.
    vk show scroll tip horizontal 1 Só é mostrada a ponta de deslocamento horizontal.
    vk show scroll tip none Nenhuma dica de rolagem é exibida.
    vk show scroll tip vertical 2 Só é apresentada a ponta de deslocamento vertical.
    showVerticalScrollbarbooleanMostrar a barra de deslocação vertical.
    tabEditablebooleanThe sheet tab strip can be edited.
    tabNavigationVisiblebooleanDisplay the sheet tab navigation.
    tabStripPositionnumberPosition of the tab strip. Valores disponíveis:
    ParâmetrosValorDescrição
    vk tab strip position bottom 0 A posição da tabulação é relativa à parte inferior da pasta de trabalho.
    vk tab strip position left 2 A posição da tabulação é relativa à esquerda da pasta de trabalho.
    vk tab strip position right 3 A posição da tabulação é relativa à direita da pasta de trabalho.
    vk tab strip position top 1 A posição da tabulação é relativa à parte superior da pasta de trabalho.
    tabStripRationumberPercentage value (0.x) that specifies how much of the horizontal space will be allocated to the tab strip. The rest of the horizontal area (1 - 0.x) will allocated to the horizontal scrollbar.
    tabStripVisiblebooleanDisplay the sheet tab strip.
    tabStripWidthnumberWidth of the tab strip when position is left or right. O padrão e o mínimo são 80.
    useTouchLayoutbooleanSe deve ser usado o layout de toque para apresentar o componente Spread.

    Exemplo

    Para definir a opção allowExtendpasteRange em "ViewProArea":

    var $workbookOptions : Object

    $workbookOptions:= New Object
    $workbookOptions.allowExtendPasteRange:=True VP SET WORKBOOK OPTIONS("ViewProArea";$workbookOptions)

    Veja também

    VP Get workbook options

    VP SHOW CELL

    VP SHOW CELL ( rangeObj : Object { ; vPos : Integer; hPos : Integer } )

    ParâmetroTipoDescrição
    rangeObjObject->Objeto intervalo
    vPosInteger->Posição vertical da vista da célula ou linha
    hPosInteger->Posição horizontal da vista da célula ou linha

    |

    Descrição

    O comando VP SHOW CELL vertically and horizontally repositions the view of the rangeObj.

    In rangeObj, pass a range of cells as an object to designate the cells to be viewed. The view of the rangeObj will be positioned vertically or horizontally (i.e., where rangeObj appears) based on the vPos and hPos parameters. The vPos parameter defines the desired vertical position to display the rangeObj, and the hPos parameter defines the desired horizontal position to display the rangeObj.

    Estão disponíveis os seguintes selectores:

    SelectorDescriçãoDisponível com vPosDisponível com hPos
    vk position bottomAlinhamento vertical para o fundo da célula ou linha.X
    vk position centerAlinhamento com o centro. The alignment will be to the cell, row, or column limit according to the view position indicated:
  • Posição vertical da vista - célula ou linha
  • Posição horizontal da vista - célula ou coluna
  • XX
    vk position leftAlinhamento horizontal à esquerda da célula ou colunaX
    vk position nearestAlinhamento ao limite mais próximo (superior, inferior, esquerda, direita, centro). The alignment will be to the cell, row, or column limit according to the view position indicated:
  • Posição vertical da vista (topo, centro, fundo) - célula ou linha
  • Posição horizontal da vista (esquerda, centro, direita) - célula ou coluna
  • XX
    vk position rightAlinhamento horizontal à direita da célula ou colunaX
    vk position topAlinhamento vertical ao topo da célula ou linhaX

    Este comando só é eficaz se o reposicionamento da vista for possível. For example, if the rangeObj is in cell A1 (the first column and the first row) of the current sheet, repositioning the view will make no difference because the vertical and horizontal limits have already been reached (i.e., it is not possible to scroll any higher or any more to the left). The same is true if rangeObj is in cell C3 and the view is repositioned to the center or the bottom right. A vista mantém-se inalterada.

    Exemplo

    You want to view the cell in column AY, row 51 in the center of the 4D View Pro area:

    $displayCell:=VP Cell("myVPArea";50;50)
    // Move the view to show the cell VP SHOW CELL($displayCell;vk position center;vk position center)

    Resultados:

    The same code with the vertical and horizontal selectors changed to show the same cell positioned at the top right of the 4D View Pro area:

    $displayCell:=VP Cell("myVPArea";50;50)
    // Move the view to show the cell VP SHOW CELL($displayCell;vk position top;vk position right)

    Resultados:

    Veja também

    VP ADD CELL
    VP Get active cell
    VP Get selection
    VP RESET SELECTION
    VP SET ACTIVE CELL
    VP SET SELECTION

    VP SUSPEND COMPUTING

    VP SUSPEND COMPUTING ( vpAreaName : Text )

    ParâmetroTipoDescrição
    vpAreaNameText->Nome da área 4D View Pro no formulário

    |

    Descrição

    O comando VP SUSPEND COMPUTING para o cálculo de todas as fórmulas em vpAreaName. This command is useful when you want to suspend calculations in this 4D View Pro area so you can manually make modifications to formulas without encountering errors before you've finished making the changes.

    O comando pausa o serviço de cálculo no 4D View Pro. Formulas that have already been calculated remain unchanged, however any formulas added after VP SUSPEND COMPUTING command is executed are not calculated.

    Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

    O serviço de cálculo de 4D View Pro mantém um contador de ações de sugastar/retomar. Therefore, each execution of VP SUSPEND COMPUTING command must be balanced by a corresponding execution of the VP RESUME COMPUTING command. Any formula impacted by modifications made while calculations are suspended will be recalculated when the command is executed.

    Exemplo

    You've added two buttons to the form so that the user can suspend/resume calculations:

    O código do botão Suspend Computing:

     //pause calculations while users enter information
    If(FORM Event.code=On Clicked)

    VP SUSPEND COMPUTING("ViewProArea")

    End if
    If(FORM Event.code=On Clicked)

    VP RESUME COMPUTING("ViewProArea") End if

    Veja também

    VP RECOMPUTE FORMULAS
    VP RESUME COMPUTING