NUMBER %EDITSEL%
Scopo: consente di modificare/generare
un file di selezione
| Sintassi: | |||
| %NUMBER% | %EDITSEL% | (%NUMBER% | optcode, |
| %STRING%* | data) | ||
Descrizione: Tramite questa funzione è possibile
creare o modificare una file di selezione.
opcode seleziona il tipo di operazione da compiere.
data contiene eventuali dati di ingresso / uscita.
I dati numerici vanno espressi, e vengono ritornati, in forma binaria (vedi
%ITOM%/%MTOI% per le modalità di
scrittura / lettura di dati binari su un oggetto %STRING%).
La selezione su cui operare può essere omessa in ingresso nel caso in cui
sia stata impostata una selezione corrente; in questo caso si ha lo stesso
effetto impostandone il valore a %CURSELPATH%.
La tabella che segue descrive l'impostazione dei dati in ingresso e i
valori restituiti in uscita in funzione del tipo di operazione richiesta.
| opcode | data | descrizione | |
| ingresso | uscita | ||
| 0 | nessuno | selezione | crea una selezione vuota; in uscita il secondo parametro contiene il nome del file di selezione creato |
| 1 | totale numero doc [...] [selezione] |
nessuno | aggiunge uno o più documenti a un file di selezione; in ingresso il secondo parametro contiene in forma binaria il totale dei documenti da aggiungere alla selezione, il numero fisico di ogni documento da aggiungere, e opzionalmente il nome del file di selezione da modificare |
| 2 | [selezione] | totale numero doc [...] |
torna l'elenco dei documenti apparteneti ad una selezione; in ingresso va indicato opzionalmente il nome del file di selezione da leggere; in uscita il secondo parametro contiene in forma binaria il totale dei documenti nella selezione e a seguire il numero fisico di ogni documento appartenente alla stessa |
| 4 | numero doc [selezione] |
totale numero doc [...] |
cerca in una selezione il progressivo corrispondente
a un documento dato (base 1);
in ingresso va indicato il numero fisico del documento da cercare e opzionalmente il nome del file di selezione da leggere; in uscita il secondo parametro contiene in forma binaria il totale dei documenti nella selezione e a seguire il numero fisico di ogni documento appartenente alla stessa; il valore di ritorno se maggiore di 0 fornisce il progressivo cercato. |
| 0x7f | indice doc [selezione] |
nessuno | elimina un documento da una selezione; il secondo parametro in ingresso deve contenere l'indice nella selezione del documento da scartare in forma binaria e a seguire opzionalemnte il nome del file di selezione |
| 0x80 | [selezione] | nessuno | se usato in OR con uno dei valori precedenti di opcode
imposta la selezione creata o modificata come corrente; se usato come opcode prevede come unico parametro in ingresso il nome del file di selezione da impostare come selezione corrente |
Valore restituito: valore numerico
Torna 0 in caso di errore generico o parametro non valido.
Torna >= 1 in caso di operazione riuscita.