HAMMAP DDE-Interface                                        HAMMAP V5.0b
====================                                        Gerhard Berg
Fil: HM-DDE.TXT                                             DJ6FM
Oversatt av Hans Utne / LA6IM (20 april 1994)

HAMMAP for Windows inneholder et DDE interface for program-utvidelse.
DDE interface kan brukes av andre program under flgende betingelser:

- Programmet m vre Public Domain og ikke kommersielt distribuert.
- HAMMAP som sdan skal IKKE distribueres sammen med programmet uten
  godkjenning av HAMMAP's forfatter.
- En kopi av programmet skal sendes til HAMMAP's forfatter.
- Forfatteren av HAMMAP hefter ikke for eventuelle skader som oppstr
  ved bruk av HAMMAP.


Tekniske definisjoner
=====================

HAMMAP er en DDE-Source (Server).

Applikasjon: HMWIN
Emne:        MAP
Del:         RESULT  (inneholder resultat av kommando)
             STATION (inneholder valgt stasjon)


Kommando syntaks (Link-Execute):
================================

Informasjons-kommando:
----------------------
GetStn[:[n][,Mode]]             - Hent call for n'te [neste] stasjon
                                  i aktuelt omrde
                                  Mode: 0=uten Filter, 1=med Filter
GetStnLines:Call                - Hent tilgjengelige linjer (0...9)
                                  for spesifisert stasjon
GetStnInfo:Call[,[Line][,Mode]] - Hent Info for spesifisert stasjon
GetLinks:Call[,Mode]            - Hent Link for spesifisert stasjon
                                  Mode: 0=uten Filter, 1=med Filter
GetLinkInfo:Call1,Call2[,Mode]  - Hent Info for spesifisert Link
GetRoute:Call1,Call2            - Hent Route mellom spesifiserte stasjoner
GetCoord                        - Hent aktuelle koordinat
                                  (xmin,ymin,xmax,ymax)
GetSize                         - Hent MapWidth,MapHeight,
                                  WindowWidth,WindowHeight,
                                  PrintWidth,PrintHeight
CopyMap                         - Kopier kart til Utklippstavle


Mode=0: Hent Status,Type,Hardware,Software som 2 karakterers forkortelse
        Hent dato som MM
Mode=1: Hent Status,Type,Hardware,Software med full tekst
        Hent dato som MM.


Tegne-kommando:
---------------
SelStn:Call                           - Velg stasjon
DrawStn:Call[,Color]                  - Tegn stasjon
MarkStn:Call[,Color]                  - Merk stasjon (skriv Callsign)
DrawLink:Call1,Call2[,Color,Pattern]  - Tegn link
DrawMap[:xmin,ymin,xmax,ymax]         - Tegn kart
                                        (default: aktuelt koordinat)
PrintMap[:xmin,ymin,xmax,ymax]        - Print Map
                                        (default: aktuelt koordinat)

Color:   Farge nr 0...15 (default: HAMMAP farge)
Pattern: Mnster nr 0...6 (se Visual Basic DrawStyle Property)


System-kommando:
----------------
Noop                            - No Operation (for  teste link)
Test:String                     - Test: Hent spesifisert streng
GetVer                          - Hent HAMMAP-versjon (f.eks 5.0)
GetStnAbv:n                     - Hent stasjons-forkortelser (n=1-5)
                                  1=Stasjons-Status, 2=Stasjons-Type
                                  3=Software, 4=Hardware, 5=Link-Status
GetMsg:MsgNr                    - Hent spesifisert melding
GetMsgFile                      - Hent melding fil-navn
GetHlpFile                      - Hent hjelp fil-navn
GetParFile                      - Hent parameter fil-navn
GetPar:ParName[,Id]             - Hent verdi p spesifisert parameter
SetPar:ParName=Value            - Sett parameter til spesifisert verdi

SETPAR-kommando skal kun brukes ved full forstelse av HAMMAP-programmet,
da enkelte parameter ikke m endres via DDE interface.
Parameter-tildelinger kan endres i fremtidige versjoner av HAMMAP. 


Retur-verdier:
--------------
Hvis det ikke er feil, vil HAMMAP returnere en positiv bekreftelse og det
spesifiserte resultat (hvis noe), eller en tom streng.
Hvis feil vil HAMMAP returnere en negativ bekreftelse og en av flgende
feil-koder:

-4 - Kommando-feil
-3 - Parameter-feil (utenfor omrde)
-2 - I/O-feil
-1 - Opptatt
0  - Ok (eller tom streng)
1  - QTH til stasjon ikke i aktuelt omrde
2  - Ukjent QTH
3  - Stasjon ikke funnet
4  - Feil i kallesignal-format
5  - Link ikke funnet
6  - Ingen Route funnet


Demo Program
============
Programmet HM-DDE kan brukes for  underske HAMMAP's DDE interface.
