De Windows API

Letterlijk beteken API "Application Programming Interface." Dit is een zeer vage beschrijving. De Windows API is eigenlijk een verzameling van bestaande functies in windows die je kan uitvoeren om bepaalde taken uit te voeren in de windows werkruimte. Deze functies zitten in meerdere DLL's die meegeleverd zijn met ons 'meest' geliefde besturingssysteem.

Om toegang te verkrijgen tot deze exotische functies, moeten we ze eerst declareren in onze code. De syntax is spijtig genoeg niet zo mooi. Hier is een voorbeeld::

Declare Function sndPlaySound Lib "winmm.dll" Alias "sndPlaySoundA" (ByVal lpszSoundName As String, ByVal uFlags As Long) As Long

Laten we dit eens bekijken. Eerst en vooral zien we dat dit een gedeclareert statement is, dit kan voor sommige van jullie onbekend zijn. De windows help bestanden zegen dat een declaratie is "gebruikt op een module niveau om externe procedures in een dynamic-link library (DLL) op te roepen."
Dat is exact wat wij hier aan het doen zijn, we roepen een procedure aan (eigenlijk een functie in dit geval) binnenin de DLL die "winmm.dll" genoemd is. Dit is het windows multimedia DLL, en hier binnenin zit een functie "sndPlaySound" die ons toelaat om wave bestanden af te spelen.

Het woord "Lib" duid aan dat "een DLL of een andere code bron de procedure bevat die wij aan het declareren(op roepen) zijn" en het woord "Alias" duid aan dat "de procedure die wordt opgeroepen een andere naam heeft binnenin de DLL zelf." De rest van de statement zijn gewoonweg argumenten die aan de functie worden doorgegeven.

Pas Op: Als je van plan bent om een API functie aan te roepen van binnenin een object (zoals een standaard form), moet je het woord "Private" voor je statement plaatsen.

Ok, nu dat we de functie gedeclareerd hebben, kunnen we ze gebruiken in onze code. We kunnen het nu behandelen juist zoals een 'normale' procedure die we zelf gemaakt hebben. Voor een specifiek voorbeeld dat toont hoe je API functies oproept van binnenin je code lees dan Afspelen van Wave Bestanden.

Waar dat dit magisch stukje code vandaan komt? Het kan gevonden worden in de "Winapi" directory van je VB hoofdmap. In het tekst bestand "Win32api.txt" kan je een lijst vinden van procedures en constanten die samen de API vormen. Als je weet wat je zoekt, dan kan dit bestand nuttig zijn, maar het is toch het beste om een boek te lezen over de windows API of je kan ook wat web sites afschuimen.

API aanroepingen over dingen zoals wave output, bitmap tonen, timing loops en meer kan je vinden in andere tutorials op deze site.

Translated by Pieterjan Vandegaer from Eyesight Development.