VB'de API Tanımı

VB'de API Tanımı

VB'de API'ler iki şekilde tanımlanabilir. Fonksiyon veya altprogram olarak. Fonksiyon olarak tanımlanan API'lerden geriye bir değer dönerken, altprogram olarak tanımlananlardan bir değer geri dönmez.

Alt program olarak API tanımı:
Private/Public Declare Sub isim Lib "libname" [([parametreler])]
Fonksiyon program olarak API tanımı:
Private/Public Declare Function isim Lib libname [([parametreler])] [As tip]
Burada isim fonksiyonun ismidir ve programda API bu isimle çağrılır. Libname kullanılan kütüphanenin ismi, parametreler; fonksiyona giren parametreler, As tip; fonksiyondan dönen değerin tipidir.

API'nin tanımlanacağı yer formun veya modülün General-Declerations kısmıdır. API'yi bir formun decleration kısmında tanımlarsanız API'yi yalnız o formun altprogramlarından çağırabilirsiniz. Bir modülde tanımlarsanız programınızın her yerinde kullanabilirsiniz.

API'yi doğru olarak tanımladığınız halde VB, ilgili dosyada böyle bir API bulunmadığını söylüyorsa veya API ile aynı isme sahip bir VB komutu var ise bu durumda Alias isimleri kullanmanız gerekir.
Private/Public Declare Function/Sub isim Lib libname Alias "isim" [([parametreler])] [As tip]
API'yi doğru olarak tanımladığınız halde VB, ilgili dosyada böyle bir API bulunmadığını söylüyorsa API isminin sonuna A ekleyerek Alias ismi olarak vermeniz gerekir. Bunun sebebi Windows işletim sisitemi farklı dilleri desteklemektedir. ANSI karakter setini destekleyen ülkler için sonuna A harfi, UniCode veya iki karekter genişliğini kullanan ülke seti için ise sonuna W harfi eklemeniz gerekir.

API tanımı yaparken kullanacağınız tiplerin isimlerini ise C'den VB'ye çevirmeniz gerekir. Genel olarak tip karşılıkları şöyledir.

	C	Visual Basic
	atom	ByVal değişken AS integer
	bool	ByVal değişken As Long
	byte	ByVal değişken As Byte
	char	ByVal değişken As Byte
	colorref	ByVal değişken As Long
	dword	ByVal değişken As Long
	hwnd,hdc,hmenu vb	ByVal değişken As Long
	int,uint	ByVal değişken As Long
	long	ByVal değişken As Long
	lparam	ByVal değişken As Long
	lpdword	değişken As Long
	lpint,lpuint	değişken As Long
	Iprect	değişken As type
	Ipstr,Ipcstr	ByVal değişken As String
	Ipvoid	değişken As Any
	lpword	değişken As Integer
	lresult	ByVal değişken As Long
	null	değişken As Any veya ByVal değişken As Long
	short	ByVal değişken As Integer
	void	Sub procedure
	word	ByVal değişken As Integer
	wparam	ByVal değişken As Long
	16 bit	ByVal değişken As Integer
	32 bit	ByVal değişken As Long
	float	ByVal değişken As Single
	double	ByVal değişken As Double

Parametrelerden biri iki farklı tipte değer alabiliyorsa bunu As Any olarak tanımlamanız gerekir. Hangi parametrenin Any olarak tanımlanması gerektiğine ancak dosyadaki bilgileri okuyarak anlayabilirsiniz. Örneğin bir parametre hem string içerebiliyor ve hemde Null içerebiliyorsa bu parametre Any olarak tanımlanmalıdır.

Yaptıkları işlere göre API'lerin bulundukları dosyalar ise şunlardır :

	DLL	Fonksiyonları
	Advapi32.dll	Şifre ve Kayıt dosyası işlemleri gibi gelişmiş bir çok API'ler
	Comdlg32.dll	Diyalog pencereleri ile ilgili API'ler
	Gdi32.dll	Grafik API'leri
	Kernel32.dll	Çekirdek Windows API'leri
	Lz32.dll	32 bit skıştırma API'leri
	Mpr.dll	Multiple Provider Router API'leri
	Netapi32.dll	32-bit Network API'leri
	Shell32.dll	32-bit Shell API'leri
	User32.dll	Kullanıcı arabirimi API'leri
	Version.dll	Versiyon işlemleri API'leri
	Winmm.dll	Multimedia API'leri
	Winspool.drv	Print spooler API'leri