home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Programming Tool Box
/
SIMS_2.iso
/
vb_tools
/
vbit11
/
readme_n.win
< prev
next >
Wrap
Text File
|
1995-01-22
|
22KB
|
431 lines
_____________________________________________________________________________
IDBTOOLS 1.1 FOR VISUAL BASIC ENGLISH TEXT: SEE README.WIN
_____________________________________________________________________________
> HVA ER IDBTOOLS ? +-----+
ªMICROª
IdbTools er et bibliotek med en rekke nyttige og tidsbesparende +-----+
rutiner som vil gj°re livet enklere for enhver Visual Basic ª I ª
programmerer. ª D ª
ª B ª
Av innholdet kan vi nevne: +-----+
ªADEPTª
+ Enkle, men svµrt slagkraftige rutiner for manipulering av +-----+
tekst-strenger.
+ Betydelig enklere og tryggere lesing/skriving av INI-filer
sammenlignet med API-kall.
+ Rutiner for σ lese informasjon om systemet, som f.eks. ledig
diskplass, tilgjengelig hukommelse, skjermoppl°sning, m.m.
+ Dynamiske en/to-dimensjonale tabeller (matriser) av dynamiske
tekst-strenger lar deg operere med betydelig st°rre datamenger
i internhukommelsen enn Visual Basic alene kan takle. Smart
sortering, s°king, lesing fra fil, skriving til fil, kobling
mot regneark, m.m.
+ Krypteringsrutiner (uten "bakd°r") gir deg pσ en enkel mσte
muligheten til σ beskytte dine data mot innsyn fra uvedkommende.
+ Rutiner som gj°r det mulig σ kopieringsbeskytte dine
applikasjoner pσ en elegant mσte. Denne pakken bruker
samme teknikken selv, sσ pr°v, se og vurder dette !
IdbTools er et produkt fra IDB MICRO ADEPT AS. Denne pakken er laget
for Visual Basic, men det finnes ogsσ en tilsvarende pakke for C++.
For detaljert beskrivelse av rutinene i denne pakken, se filen
IDBTOOLS.WRI og IDBTABLE.WRI (standard Windows 3.1 Write format -
kan ogsσ leses av MS-Word).
Denne pakken distribueres som "shareware" (se under for nµrmere info),
og vi regner med σ komme med hyppige oppdateringer i tiden som kommer.
Hold derfor utkikk etter nye versjoner slik at du alltid har den nyeste.
Dersom denne filen er mer enn et par mσneder gammel (se fil-dato), er
det sannsynlig at det finnes en nyere versjon i oml°p.
Dersom du har kommentarer og/eller forslag, kan du sende post/email til:
Idb Micro Adept AS idb@vestnett.no
Strandgaten 207 """""""""""""""
5004 Bergen
_____________________________________________________________________________
NB: Denne filen inneholder spesialtegn basert paa WINDOWS (Ansi) tegnsett.
Dersom du bruker et DOS program for aa lese dette, blir disse tegnene
feil, og eksemplene blir meningsloese. I saa fall, les i stedet filen
README_N.TXT, som inneholder denne teksten basert paa Ascii tegnsett.
_____________________________________________________________________________
_____________________________________________________________________________
> TABELLER
En tabell er en matrise av tekststrenger som kan sees pσ som et usynlig
regneark i internhukommelsen. Tabellene dimensjoneres etter behov, og man
kan endre st°rrelse dynamisk. Man kan lese tabeller direkte fra en rekke
fil-formater, og tabellene dimensjoneres da automatisk ut fra innholdet i
filene som leses. Tilsvarende automatikk gjelder ved skriving av tabeller
til forskjellige fil-formater.
Lesing og skriving av data fra/til tabell er lynraske operasjoner. Det
samme gjelder s°king og sortering.
Sorteringsrutinen for tabellverket er helt unik. Det er den eneste kjente
sorteringsrutine som gir en logisk sortering av tekst som inneholder tall.
Eksempel: Vanlig sortering IDBTOOLS SmartSort
Nr 1 av 100 Nr 1 av 100
Nr 10 av 100 Nr 2 av 100
Nr 100 av 100 Nr 10 av 100
Nr 2 av 100 Nr 20 av 50
Nr 20 av 100 Nr 20 av 100
Nr 20 av 50 Nr 100 av 100
Sortering av spesialtegn takles bedre enn i de fleste andre sorterings-
rutiner. Tegn som /E/╔/e/Θ/Φ/δ/Ω/ behandles som nyanser av samme tegn.
Det vil si at forskjellen kun fσr betydning for rekkef°lgen nσr resten
av linjen er identisk.
Eksempel pσ tekst sortert med IdbTools SmartSort:
Sortering 1
SortΦring 2
Sortering 3
SortΦring 3
SortΦring 4
SortΘring 5
SortΘring 6
Mellom linje 1 og 2 vil ikke forskjellen "e"/"Φ" bety noe siden resten av
teksten er forskjellig. Det samme gjelder mellom linje 2 og 3. Eneste
forskjell mellom linje 3 og 4 er "e"/"Φ", og da vil linjen med "e" bli
sortert foran den andre, siden "e" er definert foran "Φ".
Du vil kanskje si dette ser helt trivielt ut, men du endrer kanskje
oppfatning nσr du ser hvordan de fleste andre programmer takler sortering
av de samme linjene:
Sortering 1
Sortering 3
SortΘring 5
SortΘring 6
SortΦring 2
SortΦring 3
SortΦring 4
Det finnes flere s°kerutiner for σ finne data i en tabell, som eksakt
s°king, joker-s°king (*data*) og binµr-s°king (data* i sortert tabell).
_____________________________________________________________________________
> STRENGBEHANDLING / INI-FILER
Et problem som de fleste Visual Basic programmerere f°r eller senere st°ter
pσ, er at hjelperutiner som returnerer strenger forutsetter at det kallende
programmet setter av plass til den returnerte stengen. Som et eksempel kan
vi vise hvordan man leser fra en INI-fil pσ tradisjonell mσte (via API) og
med IDBTOOLS:
' Skal lese navn pσ oppstartsprogram for Windows fra SYSTEM.INI:
Declare Function GetPrivateProfileString% Lib "Kernel" (ByVal pAppName$,
ByVal pKeyName$, ByVal pDefault$,
ByVal pReturnedString$, ByVal nSize%, ByVal pFileName$)
txt$ = String$(80, " ") ' Setter av plass til 80 tegn
ant% = GetPrivateProfileString("boot","shell","",txt$,80,"SYSTEM.INI")
StartProg$ = Left$(txt$, ant%) ' Vil normalt vµre "progman.exe"
' Samme med IDBTOOLS (IDBTOOLS.BAS inkluderes i prosjektet):
StartProg$ = IniFileGetString("SYSTEM.INI", "boot", "shell")
Det burde ikke vµre noen tvil om hvilket av disse alternativene som er
enklest σ programmere, vedlikeholde og ikke minst σ forstσ.
IdbTools inneholder en rekke andre kraftige streng-hσndterings-rutiner
som "mangler" i Visual Basic. Vi kan nevne rutiner for σ plukke ut ord
fra strenger, bytte ut delstrenger, formatering av data, oversette mellom
Dos og Windows tegnsett, og mye mer. Se IDBTOOLS.WRI for komplett
oversikt og detaljert dokumentasjon.
_____________________________________________________________________________
> SYSTEMINFORMASJON
Rutiner som pσ en enkel mσte gir informasjon om systemet, som skjerm-
oppl°sning, antall farger, ledig disk-plass, tilgjengelig internhukommelse,
disk(ett)-stasjon status m.m. Detaljer om f.eks. environment og fil-
informasjon kan leses direkte inn i tabeller.
_____________________________________________________________________________
> KRYPTERING
Dersom man °nsker σ beskytte sine data mot innsyn fra uvedkommende, kan man
bruke krypteringsrutinene i IDBTOOLS. Disse rutinene er ikke basert pσ noen
standard algorime etter spesifikasjoner fra "StoreBror", og har f°lgelig
ingen "bakd°r" som σpner for innsyn. Det er ganske enkelt umulig σ finne ut
hva en kryptert streng inneholder uten korrekt n°kkel - selv for oss som
har laget programmet og kjenner krypteringsalgoritmen ut og inn.
Rutinene er svµrt enkle σ bruke. Man angir teksten som skal krypteres
sammen med en "hemmelig n°kkel" og fσr som resultat en ubegripelig
tekststreng. Nσr man vil dekode teksten, angir man den ubegripelige
strengen sammen med den samme "hemmelige n°kkel" og fσr den opprinnelige
tekststrengen som resultat. Dersom man angir feil n°kkel, vil resultatet
bli bare tull.
Eksempel:
TekstInn$= "Privat informasjon..."
Secret$ = "Sesam$╔zaM"
Krypt$ = Encrypt (TekstInn$, Secret$)
TekstUt$ = Decrypt (Krypt$, Secret$)
' TekstUt$ og TekstInn$ vil vµre identiske, og Krypt$ vil
' inneholde en helt ubegripelig tekststreng.
_____________________________________________________________________________
> KOPIERINGSBESKYTTELSE
Programbiblioteket IDBTOOLS.DLL er kopieringsbeskyttet. Dette er gjort pσ
den mσten at dersom man ikke har gyldig lisens, vil man stadig vekk fσ opp
en meldingsboks som minner om at man b°r skaffe seg en lisens for
programmet. De fleste rutinene kan brukes uhindret, men nσr man tar i
bruk tabeller eller krypteringsrutiner, aktiviseres testing pσ lisens.
For σ fjerne de irriterende meldingsboksene som stadig vekk minner om
manglende lisens, mσ man skaffe seg en lisenskode fra IDB. Man fσr da en
kode som bestσr av 6 bokstaver/tall som kun vil fungere sammen med det navn
som lisensen skal gjelde for. Lisensnavnet og den tilh°rende koden mσ
legges inn i de programmene som bruker IDBTOOLS:
status% = LicenseIdbTools("Bruker Navn, Adresse", "KODE01")
Denne koden legges f.eks. i Form Load for oppstartsbildet.
Alle som lager program som benytter IDBTOOLS, mσ ha lisens for det navnet
som holder copyright for det gjeldende programmet. IDBTOOLS.INI vil vise
navn pσ alle program som bruker IDBTOOLS, samt copyright informasjon for
alle program som bruker IDBTOOLS med gyldig lisens. Dette betyr at dersom
noen urettmessig bruker en annens lisens, vil den som har gyldig lisens
fremstσ som copyright-innehaver av det programmet som er basert pσ ulovlig
bruk av IDBTOOLS. Man kan ikke pσberope seg σ ha handlet i god tro dersom
man aktivt har programmert inn kall til LicenseIdbTools med en annens navn/
lisenskode.
En tilsvarende kopieringsbeskyttelse er tilgjengelig for den enkelte
applikasjon som bruker IDBTOOLS (med gyldig lisens):
Med kallet kode$ = LicenseGetCode("Bruker Navn","N╪KKEL")
vil man fσ returnert en kode som kun vil fungere sammen med angitt
brukernavn og "n°kkel". Dette kallet legges ikke inn i applikasjonen,
men i et eget program for intern bruk.
I applikasjonen legges kallet:
status% = LicenseProgram(BrukerNavn$, Kode$, "N╪KKEL")
Ved σ teste pσ variabelen status% (som gjerne defineres som Global), kan
din applikasjon legge inn begrensninger i programmet nσr koden ikke
stemmer. Dette kan gj°res i form av irritasjonsmomenter som stadige
pσminnelser med meldingsbokser og lydsignaler, eller man kan rett og slett
avslutte programmet - alt etter hva man °nsker σ oppnσ. Det enkleste
alternativet er σ fσ selve IDBTOOLS til σ oppf°re seg som en ulisensiert
versjon ved σ kalle LicenseIdbTools med en ugyldig kode.
"N╪KKEL" er her brukt som eksempel pσ en "magisk" tekststreng som angir en
n°kkel som bare den som lager applikasjonen kjenner til. Pσ denne mσten
vil det vµre umulig for andre σ generere gyldige lisenskoder for din
applikasjon - selv om de skulle ha fσtt tak i din lisenskode for IDBTOOLS.
For σ unngσ at "hackers" skal kunne finne ut hva denne n°kkelen inneholder,
kan du "bygge den" runtime ved f.eks. σ slσ sammen flere strenger, lese
delstrenger fra filer og evt. kj°re det hele gjennom krypterings-
algoritmene som er beskrevet over.
BrukerNavn$ og Kode$ er tekststrenger som bruker mσ taste inn f°rste gang
applikasjonen kj°res - evt. hver gang programmet startes uten gyldig
lisens. Nσr gyldig kode er angitt, b°r applikasjonen lagre denne
informasjonen - gjerne kryptert - slik at bruker slipper σ taste det
inn hver gang.
Nσr LicenseProgram er kalt med gyldig kode, vil angitt brukernavn bli
lagt inn i IDBTOOLS.INI sammen med navnet pσ din applikasjon under gruppen
[License].
Du har sikkert tenkt pσ at man kan lage et lite program som kan gσ gjennom
alle kombinasjoner av bokstaver og tall for σ "knekke" kodene. Det er helt
riktig, men det vil ta litt tid. Der er over en milliard mulige
kombinasjoner, og det vil gjennomsnittlig ta mer enn 5 σr σ knekke en slik
kode. Dersom noen har en slik tσlmodighet, fortjener de nesten σ lykkes.
_____________________________________________________________________________
> SHAREWARE: REGLER FOR BRUK OG KOPIERING
IdbTools distribueres som "shareware". Dette mσ ikke forveksles med
"Freeware" eller "Public domain". "SHAREWARE" er en metode for distribusjon
av programvare som er beskyttet av COPYRIGHT pσ samme mσte som all annen
kommersiell programvare.
"Shareware" - konseptet gir potensielle brukere mulighet for σ teste
programvaren f°r de evt. bestemmer seg for σ kj°pe bruksrett for den.
I dette ligger at man fullt lovlig kan bruke programmet for testformσl
i en periode. En rimelig test-periode antas σ vare ca. 30 dager. Dersom
man fortsetter σ bruke programvaren utover en rimelig test-periode, eller
benytter den i et kommersielt produkt, uten σ betale lisensavgift, blir
dette sett pσ som brudd pσ copyright-beskyttelsen til produsenten.
Et viktig poeng er at "shareware" skal gi brukeren mulighet til σ teste
alle deler av programvaren. Programvare som bare fungerer delvis, eller
bevisst legger inn feil i test-versjoner, betegnes gjerne som
"crippleware", og regnes ikke som "shareware". En god del "shareware"-
programmer, bl.a. IdbTools, bruker "pop-up"-bilder som minner om at
lisens mangler, men fungerer ellers 100% som en lisensiert versjon.
Disse betegnes ofte som "nagware", men er likevel fullverdig "shareware".
IDBTOOLS kan distribueres fritt pσ f°lgende vilkσr:
- Alle filer i denne pakken mσ vµre inkludert (se PACKING.LST).
- Ingen av filene mσ vµre endret.
Arkiv-filnavn mσ inneholde versjonsnr. (f.eks. VBIT11.ZIP: ver 1.1)
Filenes dato/tid mσ ikke endres. Klokkeslett b°r tilsvare versjonsnr.
- Ingen filer kan legges til pakken, med unntak av en kort tekst-fil
som identifiserer den BBS som distribuerer programvaren.
- Det mσ ikke tas sµrskilt betaling for distribusjon av denne pakken
uten etter skriftelig avtale om dette med IDB MICRO ADEPT AS.
Dersom du synes dette er nyttig programvare, oppfordres du til σ spre
kopier til venner og kollegaer, og gjerne laste opp en kopi til dine
favoritt-BBS-er hvis pakken ikke allerede finnes der.
_____________________________________________________________________________
> COPYRIGHT / ANSVARSFRASKRIVELSE / BETINGELSER FOR BRUK
! IDBTOOLS Copyright (C) 1995 IDB MICRO ADEPT AS, BERGEN, NORWAY !
! ________________________________________________________________ !
! Bruk av denne programvaren forutsetter at f°lgende aksepteres: !
! """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" !
! PROGRAMVAREN IDBTOOLS OG TILH╪RENDE DOKUMENTASJON LEVERES SOM !
! DEN ER, UTEN NOEN FORM FOR GARANTIER. ALL BRUK ER P┼ EGET ANSVAR. !
! IDB MICRO ADEPT AS KAN IKKE GJ╪RES ANSVARLIG FOR SKADE SOM F╪LGE !
! AV FEIL BRUK, FEIL I DOKUMENTASJON ELLER FEIL I PROGRAMVARE. !
! INNEHAVER AV GYLDIG LISENSKODE FOR IDBTOOLS FORPLIKTER SEG TIL ┼ !
! HOLDE DENNE KODEN UTILGJENGELIG FOR UVEDKOMMENDE. BEVISST !
! SPREDNING AV LISENSKODE VIL BLI SETT P┼ SOM ET GROVT BRUDD P┼ !
! LISENSBETINGELSENE OG EN KRENKING AV IDB'S COPYRIGHT. GROVE !
! TILFELLER VIL BLI FORFULGT RETTSLIG. !
_____________________________________________________________________________
> LISENS-KODER / PRIS
For σ bli kvitt de stadige "pop-up"-bildene som minner om at du trenger
en lisens, mσ du kontakte IDB MICRO ADEPT AS for σ fσ en gyldig lisens-
kode. For dette betaler du et engangsbel°p. Gjeldende priser er:
I Norge: NOK 425 inkl. M.V.A. (REG: NO865975392MVA)
Alle andre land: US $ 55 evt. omgjort til NOK etter dagens kurs
Gyldig lisenskode gir deg rett til σ distribuere IDBTOOLS.DLL sammen med
dine programmer.
------------------------
* TIDSBEGRENSET TILBUD *
------------------------
Ved kj°p av lisens for IdbTools f°r 1. mars 1995, vil man uten ekstra
kostnader ogsσ fσ rett til bruk og distribusjon av IDBVTSS.DLL. Denne
modulen gj°r det mulig σ utveksle data mellom tabeller og regnearket
Formula One fra Visual Tools. Dette produktet er sµrdeles godt egnet
for presentasjon av tabeller, og gir indirekte mulighet til σ lese og
skrive tabeller fra/til Excel-filer (ver 4.0).
IDBVTSS vil i senere versjoner bli solgt som et separat tilleggsprodukt.
_____________________________________________________________________________
> BESTILLING / BETALING SENDES TIL:
Idb Micro Adept AS
Strandgaten 207
N-5004 Bergen, Norge
___________________________________________________________________________
| |
| F°lgende informasjon mσ sendes inn sammen med betaling: |
| ======================================================= |
| |
| Navn _________________________________________________________|
| |
| Adresse _________________________________________________________|
| |
| Postnr _________________________________________________________|
| |
| Poststed _________________________________________________________|
| |
| Land _________________________________________________________|
| |
| Dato ___________________________ Telefon: ____________________|
| |
| Har betalt ___________ for IdbTools lisens (se PRIS over): |
| _ |
| [_] Sjekk vedlagt |
| [_] BankGiro: 9521.05.69325 (A/S Bergens Skillingsbank) |
| [_] PostGiro: 0826.02.47787 (CCP du bΘnΘficiaire |
| NorvΦge Service des |
| chΦques postaux) |
| _ |
| ╪nsker σ fσ tilsendt lisenskode [_] via E-mail: ____________________|
| [_] via post. |
| [_] via Fax: ____________________|
| IdbTools versjon: ________ |
| |
| Hvor du fant IdbTools: _____________________________________________|
|_________________________________________________________________________|
Ved betaling direkte til giro-konto, kan informasjonen over med fordel
sendes som E-mail via internet til: idb@vestnett.no
Koden sendes sσ snart innbetaling er verifisert. Pengene f°rst, sσ kommer
koden - ingen unntak. Dette gir minimale administrasjonsutgifter og dermed
lavere pris for programvaren; du fσr mer for pengene.
_____________________________________________________________________________
> DOKUMENTASJON - SPR┼K
Denne teksten er tilgjengelig pσ f°lgende sprσk:
Norsk README_N.WIN (Windows: README_N.WIN)
Engelsk README.TXT (Windows: README.WIN)
Dokumentasjonen (IDBTOOLS.WRI og IDBTABLE.WRI) er inntil videre kun pσ
engelsk.
Dersom ditt sprσk ikke er Engelsk eller Norsk, og du °nsker σ bidra til at
denne teksten og/eller dokumentasjonen blir tilgjengelig pσ ditt sprσk,
kontakt oss for nµrmere diskusjon om samarbeid.
_____________________________________________________________________________
> TILBAKEMELDING
Dersom du har kommentarer, feilrapporter eller forslag til forbedringer/
utvidelser, skriv til:
Idb Micro Adept AS idb@vestnett.no
Strandgaten 207 ^^^^^^^^^^^^^^^
N-5004 Bergen, Norge
_____________________________________________________________________________
_______________________________END_OF_README_________________________________