Visual basic

API چیست ؟

vb-6 — Sun, 15 Mar 2009 13:25:18 GMT

API مخفف Application Programming Interface مي‌باشد كه به معناي رابط برنامه‌سازي كاربردي است.

نام API به توابعي اطلاق مي‌شود كه در فايلهاي مختلف ويندوز مانند Advapi32.dll ، User32dll ، Ole32.dll ، Kernel32.dll ، Winmm.dll ، Winspool.drr ، Gdi32.dll ، Mpr.dll ، Netapi32.dll ، Sheu32.dll ، Rasapi32.dll ، Version.dll ، Wsock32.dll ، Comdlg32.dll، وجود دارند.

ويندوز براي صدها كار مختلف خود از اين تابع‌ها استفاده مي‌كند و برنامه‌هاي كاربردي نيز به طور متعدد از اين توابع استفاده مي‌كنند. به عنوان مثال در زبان برنامه‌نويسي ويژوال بيسيك هر خط كد را كه تايپ مي‌‌كنيد و بعد برنامه را Run مي‌كنيد، توسط توابع API كنترل مي‌شوند. هنگامي كه دستور Form1.Print را براي نمايش يك پيغام بر روي فرم صادر مي‌كند، در واقع ويژوال بيسيك در پشت صحنه از تابع API، Textout جهت نمايش اين پيغام استفاده مي‌كند و يا هنگامي كه از توابع رسم بيضي استفاده مي‌كنيد، درحقيقت از تابع API، Elliptic استفاده مي‌شود.

و همچنين توابع ديگر، حركت ماوس، صفحه كليد، رنگها، دكمه‌ها، منوها و صدها عمليات ديگر.

علت استفاده از توابع API در برنامه‌نويسي

دلايل استفاده از توابع API در زبانهاي مختلف برنامه‌نويسي مي‌تواند اين باشد كه:

1. APIتوابع به دليل آنكه در فايلهاي dll هر سيستم عامل ويندوز مي‌باشد و در هر مكان مانند يكديگر مي‌باشند پس نيازي به ارائه آن فايل dll در نسخه برنامه نمي‌باشد و درنتيجه حجم نسخه كم مي‌شود و درضمن سنديت برنامه نيز بيشتر مي‌شود و مي‌توان گفت كه شما از منابع ويندوز به نحو احسن استفاده كرده‌ايد.

2. نسخه‌هاي ويندوز به طور مداوم تغيير مي كند ولي به دليل آنكه سازندگان هميشه حالتي را در نظر مي‌‌گيرند كه نسخه‌هاي قبلي را نيز پشتيباني كند. درنتيجه اگر شما برنامه‌اي را به كمك توابع API بنويسيد با تغیير نسخه ويندوز نيازي به تغيیر جدي در توابع API نمي‌باشد.

3. بيشتر زبانهاي برنامه‌نويسي (به‌خصوص زبانهاي تحت ويندوز كه خود به صورت پنهان از توابع API استفاده مي‌كنند، ممكن است به علت محدوديتهایي نتوانند تمام امكانات توابع را در اختيار قرا دهند. شما با دسترسي مستقيم به توابع مي‌توانيد از حداكثر قابليتهاي تابع استفاده كنيد.

4. در بعضي از زبانهاي برنامه‌نويسي براي آنكه بتوان يك حالت را بوجود آورد و يا كار مشخصي را انجام داد، بايد كدهای زيادي بنويسيم و يا در زمان خطاگيري مدت زيادي را صرف كنيم و به طور حتم كاربر استفاده‌كننده از برنامه شما نيز بايد زمان بيشتري را براي گرفتن جواب صرف كند. اين موارد ذكر شده هر كدام به نوبه خود مي‌توانند از محبوبيت، قدرتمند و خوانابودن برنامه بكاهند. ولي توابع API به دليل آنكه روتين شده و از قبل نوشته شده مي‌باشند پس فقط كافيست تابع را فراخواني كنيم و به آن ورودي دهيم و خروجي مورد نظر خود را دريافت كنيم.

5. همانطور كه در توابع اين كتاب نيز خواهيد ديد، بيشتر توابع كارهايي را انجام مي‌دهند كه زبانهاي برنامه‌نويسي قادر به انجام آن نمي‌باشند. به عنوان مثال به تابع SetlateradwindowAttributes مراجعه كنيد كه باعث مي‌‌شود يك پنجره (فرم و يا كنترلهاي داخل آن) و با يك رنگ مشخص در آنها به مقدار دلخواه به حالت شفاف و Transparent تبديل شوند. و يا توابع ديگر مانند StretchBlt , TransparentBlt , LokworkStation , TimGetTim , SHShutDownDialog و ...

6. و چندين علت ديگر....

توابع API

vb-6 — Wed, 18 Feb 2009 20:00:18 GMT

^{توابع API به وسیله زبان C نوشته شده است و به وسیله API TEXT VIEWER استفاده میشود}

^{ویندوز شامل هزاران تابع APIاست}

^{از دستور Public در کد ماژول استفاده میکنیم}

^{دستور Declare برای فراخوانی توابع خارج از وی بی استفاده میشود}

^{دستور Alias به عنوان لقب تابع استفاده میشود}

^مثا^{ل اول}^{:Public Declare Function ShowCursor Lib "user32" Alias "ShowCursor" (ByVal bShow As Long) As Long}^{مثال دوم:}

^{اطلاعات پارامتر:
Declare Function EnumDisplaySettings Lib "user32" Alias "EnumDisplaySettingsA" (ByVal lpszDeviceName As Long, ByVal iModeNum As Long, lpDevMode As Any) As Boolean

· lpszDeviceName
Pointer to a null-terminated string that specifies the display device whose graphics mode the function will obtain information about.
This parameter can be NULL. A NULL value specifies the current display device on the computer that the calling thread is running on.
If lpszDeviceName is not NULL, the string must be of the form \\.\DisplayX, where X can have the values 1, 2, or 3.
Windows 95: lpszDeviceName must be NULL.

· iModeNum
Index value that specifies the graphics mode for which information is to be obtained.
Graphics mode indexes start at zero. To obtain information for all of a display device’s graphics modes, make a series of calls to EnumDisplaySettings, as follows: Set iModeNum to zero for the first call, and increment iModeNum by one for each subsequent call. Continue calling the function until the return value is FALSE.
When you call EnumDisplaySettings with iModeNum set to zero, the operating system initializes and caches information about the display device. When you call EnumDisplaySettings with iModeNum set to a non-zero value, the function returns the information that was cached the last time the function was called with iModeNum set to zero.

· lpDevMode
Pointer to a DEVMODE structure into which the function stores information about the specified graphics mode.
The EnumDisplaySettings function sets values for the following five DEVMODE members:
dmBitsPerPel
dmPelsWidth
dmPelsHeight
dmDisplayFlags
dmDisplayFrequency

:مثال
Option Explicit
Const WM_DISPLAYCHANGE = &H7E
Const HWND_BROADCAST = &HFFFF&
Const EWX_LOGOFF = 0
Const EWX_SHUTDOWN = 1
Const EWX_REBOOT = 2
Const EWX_FORCE = 4
Const CCDEVICENAME = 32
Const CCFORMNAME = 32
Const DM_BITSPERPEL = &H40000
Const DM_PELSWIDTH = &H80000
Const DM_PELSHEIGHT = &H100000
Const CDS_UPDATEREGISTRY = &H1
Const CDS_TEST = &H4
Const DISP_CHANGE_SUCCESSFUL = 0
Const DISP_CHANGE_RESTART = 1
Const BITSPIXEL = 12

Private Type DEVMODE
dmDeviceName As String * CCDEVICENAME
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 * CCFORMNAME
dmUnusedPadding As Integer
dmBitsPerPel As Integer
dmPelsWidth As Long
dmPelsHeight As Long
dmDisplayFlags As Long
dmDisplayFrequency As Long
End Type

Private Declare Function EnumDisplaySettings Lib "user32" Alias "EnumDisplaySettingsA" (ByVal lpszDeviceName As Long, ByVal iModeNum As Long, lpDevMode As Any) As Boolean
Private Declare Function ChangeDisplaySettings Lib "user32" Alias "ChangeDisplaySettingsA" (lpDevMode As Any, ByVal dwFlags As Long) As Long
Private Declare Function ExitWindowsEx Lib "user32" (ByVal uFlags As Long, ByVal dwReserved As Long) As Long
Private Declare Function GetDeviceCaps Lib "gdi32" (ByVal hdc As Long, ByVal nIndex As Long) As Long
Private Declare Function CreateDC Lib "gdi32" Alias "CreateDCA" (ByVal lpDriverName As String, ByVal lpDeviceName As String, ByVal lpOutput As String, ByVal lpInitData As Any) As Long
Private Declare Function DeleteDC Lib "gdi32" (ByVal hdc As Long) As Long
Private Declare Function SendMessage Lib "user32" Alias "SendMessageA" (ByVal hwnd As Long, ByVal wMsg As Long, ByVal wParam As Long, lParam As Any) As Long
Dim OldX As Long, OldY As Long, nDC As Long

Sub ChangeRes(X As Long, Y As Long, Bits As Long)
Dim DevM As DEVMODE, ScInfo As Long, erg As Long, an As VbMsgBoxResult
'Get the info into DevM
erg = EnumDisplaySettings(0&, 0&, DevM)
'This is what we're going to change
DevM.dmFields = DM_PELSWIDTH Or DM_PELSHEIGHT Or DM_BITSPERPEL
DevM.dmPelsWidth = X 'ScreenWidth
DevM.dmPelsHeight = Y 'ScreenHeight
DevM.dmBitsPerPel = Bits '(can be 8, 16, 24, 32 or even 4)
'Now change the display and check if possible
erg = ChangeDisplaySettings(DevM, CDS_TEST)
'Check if succesfull
Select Case erg&
Case DISP_CHANGE_RESTART
an = MsgBox("You've to reboot", vbYesNo + vbSystemModal, "Info")
If an = vbYes Then
erg& = ExitWindowsEx(EWX_REBOOT, 0&)
End If
Case DISP_CHANGE_SUCCESSFUL
erg = ChangeDisplaySettings(DevM, CDS_UPDATEREGISTRY)
ScInfo = Y * 2 ^ 16 + X
'Notify all the windows of the screen resolution change
SendMessage HWND_BROADCAST, WM_DISPLAYCHANGE, ByVal Bits, ByVal ScInfo
MsgBox "Everything's ok", vbOKOnly + vbSystemModal, "It worked!"
Case Else
MsgBox "Mode not supported", vbOKOnly + vbSystemModal, "Error"
End Select
End Sub

Private Sub Form_Load()
Dim nDC As Long
'retrieve the screen's resolution
OldX = Screen.Width / Screen.TwipsPerPixelX
OldY = Screen.Height / Screen.TwipsPerPixelY
'Create a device context, compatible with the screen
nDC = CreateDC("DISPLAY", vbNullString, vbNullString, ByVal 0&)
'Change the screen's resolution
ChangeRes 640, 480, GetDeviceCaps(nDC, BITSPIXEL)
End Sub

Private Sub Form_Unload(Cancel As Integer)
'restore the screen resolution
ChangeRes OldX, OldY, GetDeviceCaps(nDC, BITSPIXEL)
'delete our device context
DeleteDC nDC
End Sub}