Diese Ausgabe der Kolumne widmet sich wieder einem häufig in unserem Forum angesprochenen Thema, nämlich der API-Programmierung. Bei der Verwendung von API-Funktionen müssen häufig eigene Typen deklariert werden, die von den Funktionen benötigt werden. Bei den Funktionen des Windows-API sind die Deklarationen und die dazugehörigen Typdefinitionen meist bekannt. Einerseits kann man die C-Versionen im SDK nachlesen, andererseits gibt es zu diesem Zweck einige interessante Web-Seiten, auf denen die Deklarationen sowie die dazugehörigen Konstanten und Typen angegeben werden.

Will man nun eine API-Funktion aus dem Windows-API in seiner Anwendung benutzen, so kann man auf die Arbeit anderer zurückgreifen und die erforderlichen Deklarationen mit "Copy and Paste" in die eigenen Quellcodedateien einfügen.

Es gibt allerdings auch einige DLLs, bei denen die Funktionen und die von ihnen verwendeten Typen nicht bekannt sind. Dies ist bei einigen Windows-DLLs, aber vor Allem bei DLLs anderer Hersteller oft der Fall. In vielen Fällen findet man dann Beispiele für die Verwendung der DLL in einem C-Programm, der VB-Programmierer mit einem geringen Wissensstand auf dem Bereich der Programmiersprache C oder C++ wird jedoch seine Probleme haben, den Code nach VB zu konvertieren.

Vor einiger Zeit gab es auf einer deutschen Internetseite mit dem Namen vbSource.de ein Tool, das einem die Arbeit der Umwandlung von C-Deklarationen nach VB-Code abnehmen konnte. Leider gibt es diese Seite nicht mehr und das Tool ging für die Entwicklergemeinde verloren. Jedoch gibt es auf Planet-Source-Code.com ein entsprechendes Beispiel zu finden: C2VB.

Wenn man eine unbekannte C++-API-Funktion oder eine unbekannte C++-Struktur hat, muss man manchmal selber die Konvertierung in Visual Basic Code in die Hand nehmen. Dafür muss man allerdings wissen wie: Im Prinzip ganz einfach, wenn man die folgende Tabelle hat:

Tabelle 1: Konvertieren von C++-Standardtypen

Tabelle 2: Konvertieren von Erweiterten C++-Typen

Sonderfälle

Boolsche Variablen

Der C++-Typ bool bzw. BOOL muss als Long in Visual Basic deklariert werden, da VB und C++ verschiedene numerische Werte zur Darstellung von True und False benutzen. Um in VB einer C++-Struktur den Wert True zu übergeben, muss der entsprechende Long-Wert auf 1 gesetzt werden (nicht wie in VB üblich auf -1). False entspricht (genau wie in VB) dem Wert 0.

Zeiger

Alle Zeigertypen (also datenTyp *varName oder erweiterte C++-Typen mit den Anfangsbuchstaben "LP" (für long pointer)) werden mit dem Long-Datentyp in Visual Basic implementiert (Ausnahme ist char*). Der Visual Basic Variable muss dann mit der VarPtr-Funktion die Speicheradresse der zuzuweisenden VB-Variablen zugewiesen werden.

Arrays

C++-Arrays werden zwar in VB auch als Arrays implementiert, jedoch ist dabei zu beachten, dass die Arraygrenze um 1 dekrementiert wird, denn in C++ bedeutet int myint[5] ein Array mit 5 Elementen (Indizes 0-4); in VB hingegeben bedeutet Dim lngArray(5) As Long ein Array mit 6 Elementen (Indizes 0-5).

typedef struct _devicemode {
    BCHAR  dmDeviceName[CCHDEVICENAME];
    WORD   dmSpecVersion;
    WORD   dmDriverVersion;
    WORD   dmSize;
    WORD   dmDriverExtra;
    DWORD  dmFields;
    short  dmOrientation;
    short  dmPaperSize;
    short  dmPaperLength;
    short  dmPaperWidth;
    short  dmScale;
    short  dmCopies;
    short  dmDefaultSource;
    short  dmPrintQuality;
    short  dmColor;
    short  dmDuplex;
    short  dmYResolution;
    short  dmTTOption;
    short  dmCollate;
    BCHAR  dmFormName[CCHFORMNAME];
    WORD   dmLogPixels;
    DWORD  dmBitsPerPel;
    DWORD  dmPelsWidth;
    DWORD  dmPelsHeight;
    DWORD  dmDisplayFlags;
    DWORD  dmDisplayFrequency;
} DEVMODE;

Listing 1: C++-Strukturdefinition

... wird zu...

Private Type DEVMODE
    dmDeviceName As String * CCHDEVICENAME
    dmSpecVersion As Integer
    dmDriverVersion As Integer
    dmSize As Integer
    dmDriverExtra As Integer
    dmFields As Long
    dmOrientation As Integer
    dmPaperSize As Integer
    dmPaperLength As Integer
    dmPaperWidth As Integer
    dmScale As Integer
    dmCopies As Integer
    dmDefaultSource As Integer
    dmPrintQuality As Integer
    dmColor As Integer
    dmDuplex As Integer
    dmYResolution As Integer
    dmTTOption As Integer
    dmCollate As Integer
    dmFormName As String * CCHFORMNAME
    dmUnusedPadding As Integer
    dmBitsPerPel As Integer
    dmPelsWidth As Long
    dmPelsHeight As Long
    dmDisplayFlags As Long
    dmDisplayFrequency As Long
End Type

Listing 2: Die vorige Struktur in VB

typedef struct tagCREATESTRUCT {
    LPVOID    lpCreateParams;
    HINSTANCE hInstance;
    HMENU     hMenu;
    HWND      hwndParent;
    int       cy;
    int       cx;
    int       y;
    int       x;
    LONG      style;
    LPCTSTR   lpszName;
    LPCTSTR   lpszClass;
    DWORD     dwExStyle;
} CREATESTRUCT;

Listing 3: C++-Strukturdefinition

... wird zu...

Private Type CREATESTRUCT
    lpCreateParams As Long
    hInstance As Long
    hMenu As Long
    hWndParent As Long
    cy As Long
    cx As Long
    y As Long
    x As Long
    style As Long
    lpszName As String
    lpszClass As String
    dwExStyle As Long
End Type

Listing 4: Die vorige Struktur in VB

typedef struct _RECT {
    LONG left;
    LONG top;
    LONG right;
    LONG bottom;
} RECT;

Listing 5: C++-Strukturdefinition

... wird zu...

Private Type RECT
    Left As Long
    Top As Long
    Right As Long
    Bottom As Long
End Type

Listing 6: Die vorige Struktur in VB

Dieser kurze Artikel soll das Grundwerkzeug auf den Weg mitgeben, das man braucht, um Deklarationen übersetzen zu können. Ein weiterer interessanter Artikel zu diesem Thema von Ben Baird in englischer Sprache ist unter How to read C++ zu finden.