EDIT ITEM
EDIT ITEM ( {* ;} objeto {; item} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | Se especificado, objeto é um nome de objeto (string), se omitido, objeto é uma variável |
| objeto | any | → | Nome de objeto (se * é especificado) ou Tabela ou Variável (se * é omitido) |
| item | Integer | → | Número do item |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando EDIT ITEM lhe permite editar o elemento atual ou o elemento de número item do array ou a lista designada pelo parâmetro objeto.
Isto significa que o elemento selecionado pode ser modificado; a entrada de um caractere substituirá totalmente o conteúdo do elemento.
Se passar o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (neste caso, passe uma string em objeto). Se não passa o parâmetro, indica que o parâmetro objeto é uma tabela ou uma variável. Neste caso, não passa uma string sem uma referência de uma tabela ou variável.
Este comando aplica aos seguintes objetos editáveis:
- Listas hierárquicas
- Colunas de List boxes
- Subformulários (neste caso, só um nome de objeto, ou subformulário, pode ser passada em objeto),
- Formulários listados mostrados utilizando os comandos DISPLAY SELECTION ou MODIFY SELECTION.
Se o comando é utilizado com um objeto editável que não estiver na lista, age da mesma forma que o comando GOTO OBJECT.
O comando não faze nada se a lista ou o array estão vazios ou são invisíveis. Igualmente, se a lista ou o array não são editáveis, ou comando só seleciona o elemento especificado sem mudar ao modo edição. No caso das list boxes, se a coluna não permite a entrada de texto (entrada por caixas de seleção ou por listas suspensas unicamente), o elemento especificado toma o foco.
O parâmetro opcional item lhe permite designar a posição do elemento (lista hierárquica) ou o número de linha (list box, formulários listados e subformulário em modo “seleção múltipla”) para mudar a modo de edição. Se não passar este parâmetro, o comando é aplicado ao elemento atual de objeto. Se não houver um elemento atual, o primeiro elemento de objeto modifica a modo edição.
Notas:
- Em subformulários e formulários listados, o comando passa a modo edição o primeiro campo da fila especificada, na ordem de entrada.
- Em listboxes mostrados em modo hierárquico, se o elemento objetivo pertence a um nível hierárquico colapsado, este nível (como também os possíveis níveis pais) são suspensos automaticamente para que a linha seja visível.
Exemplo 1
Este comando pode ser particularmente útil quando cria um novo elemento em uma lista hierárquica. Quando sechama o comando, o último elemento adicionado ou inserido na lista se converte automaticamente em editável, sem que o usuário tenha que realizar alguma ação específica.
O seguinte código pode ser o método de um botão que lhe permite inserir um novo elemento nuna lista existente. O texto automaticamente “Novo_elemento” está pronto automaticamente para ser modificado:
vlUniqueRef:=vlUniqueRef+1
INSERT LIST ITEM(hList;*;"Novo_elemento";vlUniqueRef)
EDIT ITEM(*;"MinhaLista")
Exemplo 2
Dadas duas colunas em una list box onde os nomes das variáveis são “Array1” e “Array2” respectivamente. O seguinte exemplo insere um novo elemento em dois arrays e passa o novo elemento de Array2 a modo edição:
$vlRowNum:=Size of array(Array1)+1
LISTBOX INSERT ROWS(*;"MyListBox";$vlRowNum)
Array1{$vlRowNum}:="New value 1"
Array2{$vlRowNum}:="New value 2"
EDIT ITEM(Array2;$vlRowNum)
