visual basic. leksykon

8/9/2019 Visual Basic. Leksykon

http://slidepdf.com/reader/full/visual-basic-leksykon 1/233

Mojej Mamie



Spis treści

Wstęp................................................................................................... .................................... 11

Rozdział 1. Podstawy obsługi programu VB ..................................................................... 131.1. Menu programu ......................... ......................... ......................... ......................... ... 13

1.1.1. File ............................................................................................................ 13

1.1.2. Edit ...................... ......................... ......................... ......................... ........... 16

1.1.3. View ........................ ......................... ......................... ......................... ....... 201.1.4. Project ......................... ......................... ......................... ......................... ... 23

1.1.5. Format ......................... ......................... ......................... ......................... ... 25

1.1.6. Debug ...................... ......................... ......................... ......................... ....... 28

1.1.7. Run ..................... .......................... ......................... ......................... ........... 30

1.1.8. Tools................... .......................... ......................... ......................... ........... 31

1.1.9. Add-Ins............... .......................... ......................... ......................... ........... 32

1.1.10 Window....................... ......................... ......................... ......................... ... 33

1.1.11. Help ......................... ......................... ......................... ......................... ....... 34

1.2. Okna w VB ....................... .......................... ......................... ......................... ........... 35

1.2.1. Call Stack ........................ ......................... ......................... ........................ 35

1.2.2. Code ........................ ......................... ......................... ......................... ....... 35

1.2.3. Components................. ......................... ......................... ......................... ... 36

1.2.4. Form ....................... .......................... ......................... ......................... ....... 38

1.2.5. Form Layout ........................ ......................... ......................... .................... 391.2.6. Immediate....... ......................... ......................... .......................... ............... 40

1.2.7. Locals ..................... .......................... ......................... ......................... ....... 40

1.2.8. Object Browser................ ......................... ......................... ........................ 41

1.2.9. Project ......................... ......................... ......................... ......................... ... 42

1.2.10. Properties..................... ......................... ......................... ......................... ... 43

1.2.11. Toolbox ....................... ......................... ......................... ......................... ... 44

1.2.12. Watch ..................... .......................... ......................... ......................... ....... 45

Rozdział 2. Podstawy programowania w VB ..................................................................... 472.1. Instrukcje sterują ce........ .......................... ......................... ......................... ............... 47

2.1.1. Do... ......................... ......................... ......................... ......................... ....... 47

2.1.2. For ....................... ......................... ......................... ......................... ........... 49

2.1.3. If ......................... .......................... ......................... ......................... ........... 50

2.1.4. Select Case ...................... ......................... ......................... ........................ 52

2.2. Funkcje wbudowane...... ......................... .......................... ......................... ............... 54

2.2.1. Daty i czasu ......................... ......................... ......................... .................... 54

2.2.2. Konwertują ce ............................................................................................ 64

2.2.3. Matematyczne ......................... ......................... .......................... ............... 71

2.2.4. Tekstowe ......................... ......................... ......................... ........................ 76



Spis treści 5

5

2.2.5. Testują ce...................... ......................... ......................... ......................... ... 86

2.2.6. Wejścia-wyjścia................... ......................... .......................... ................... 92

2.2.7. Pozostałe.......................... ......................... ......................... ...................... 103

Rozdział 3. Obiekty w VB ................................................................................................. 107

3.1. Kontrolki standardowe............... ......................... ......................... ......................... . 1073.1.1. Animation....... ......................... .......................... ......................... ............. 1073.1.2. CheckBox........................ ......................... ......................... ...................... 1083.1.3. ComboBox ...................... ......................... ......................... ...................... 1093.1.4. CommandButton .......................... ......................... ......................... ......... 1103.1.5. CommonDialog ....................... ......................... .......................... ............. 1113.1.6. Data ......................... ......................... ......................... ......................... ..... 1113.1.7. DBCombo............................ ......................... ......................... .................. 1123.1.7. DBGrid........................ ......................... ......................... ......................... . 1133.1.8. DBList ......................... ......................... ......................... ......................... . 1163.1.9. Debug .......................... ......................... ......................... ......................... . 1173.1.10. DirListBox....................... ......................... ......................... ...................... 1173.1.11. DriveListBox.. ......................... ......................... ......................... .............. 1183.1.12. FileListBox............. ......................... .......................... ......................... ..... 1193.1.13. Form ....................... ......................... .......................... ......................... ..... 120

3.1.14. Frame...................... ......................... .......................... ......................... ..... 1223.1.15. HScroolBar......... ......................... ......................... ......................... .......... 1233.1.16. Image..... .......................... ......................... ......................... ...................... 1243.1.17. Label............... ......................... ......................... ......................... .............. 1253.1.18. Line ........................ ......................... .......................... ......................... ..... 1263.1.19. ListBox.. .......................... ......................... ......................... ...................... 1263.1.20. MDIForm ........................ ......................... ......................... ...................... 127

3.1.21. Menu ...................... ......................... ......................... .......................... ..... 1293.1.22. OLE........................ ......................... ......................... .......................... ..... 1293.1.23. OptionButton....................... ......................... ......................... .................. 1303.1.24. Panel....................... ......................... ......................... ......................... ...... 1313.1.25. PictureBox........................... ......................... ......................... .................. 1313.1.26. Printer......................... ......................... ......................... .......................... . 133

3.1.27. ProgressBar ......................... ......................... ......................... .................. 1343.1.28. Shape ...................... ......................... ......................... ......................... ...... 135

3.1.29. Slider ...................... ......................... ......................... ......................... ...... 1353.1.30. SSTab ......................... ......................... ......................... ......................... .. 1363.1.31. StatusBar ........................ ......................... .......................... ...................... 1373.1.32. TabStrip..... ......................... .......................... ......................... .................. 1383.1.33. TextBox..... ......................... .......................... ......................... .................. 1393.1.34. ToolBar ...................... ......................... ......................... ......................... .. 1413.1.35. Timer ...................... ......................... ......................... ......................... ...... 1423.1.36. UpDown ......................... ......................... ......................... ....................... 1423.1.37. UserControl ........................ ......................... .......................... .................. 1433.1.38. VScrollBar.................. ......................... ......................... ......................... .. 145

3.2. Właściwości kontrolek standardowych...... ......................... ......................... .......... 1453.2.1. Action......................... ......................... ......................... ......................... .. 1453.2.2. ActionControl.... .......................... ......................... ......................... .......... 1463.2.3. ActiveForm..................... ......................... ......................... ....................... 1463.2.4. Align.............. ......................... .......................... ......................... .............. 1473.2.5. Alignment...... ......................... .......................... ......................... .............. 147

3.2.6. Appearance......................... ......................... ......................... ................... 1483.2.7. Archive....................... ......................... ......................... ......................... .. 1483.2.8. AutoRedraw ............................................................................................ 1493.2.9. AutoShowChildren..................... .......................... ......................... .......... 149



6 Visual Basic. Leksykon

6

3.2.10. AutoSize...................... ......................... ......................... ......................... . 1493.2.11. BackColor............................ ......................... .......................... ................. 1503.2.12. BorderColor..................... ......................... ......................... ...................... 1513.2.13. BorderStyle.......................... ......................... .......................... ................. 1523.2.14. BorderWidth............ ......................... ......................... ......................... ..... 153

3.2.15. Cancel............. ......................... ......................... .......................... ............. 1533.2.16. Caption ........................ ......................... ......................... ......................... . 1543.2.17. Checked.. ......................... ......................... ......................... ...................... 1543.2.18. ClipControls ........................ ......................... ......................... .................. 1543.2.19. Columns (DBGrid) ...................... .......................... ......................... ......... 1553.2.20. Columns (ListBox)...................... .......................... ......................... ......... 1553.2.21. Container ......................... ......................... ......................... ...................... 155

3.2.22. ControlBox...................... ......................... ......................... ...................... 1563.2.23. Controls ....................... ......................... ......................... ......................... . 1563.2.24. Count (VB Collections)....... ......................... ......................... .................. 1563.2.25. CurrentX, CurrentY......... ......................... ......................... ...................... 1563.2.26. Database ...................... ......................... ......................... ......................... . 1573.2.27. DatabaseName.... ......................... ......................... .......................... ......... 1573.2.28. DataChanged ....................... ......................... ......................... .................. 1583.2.29. DataField ......................... ......................... ......................... ...................... 158

3.2.30. DataSource ...................... ......................... ......................... ...................... 1583.2.31. Default... .......................... ......................... ......................... ...................... 1583.2.32. DisabledPicture ....................... ......................... ......................... .............. 1593.2.33. DownPicture... ......................... ......................... ......................... .............. 1593.2.34. DragIcon......... ......................... ......................... ......................... .............. 1593.2.35. DragMode........................ ......................... ......................... ...................... 1603.2.36. DrawMode.............. ......................... ......................... .......................... ..... 1603.2.37. DrawStyle....... ......................... ......................... ......................... .............. 1613.2.38. DrawWidth...................... ......................... ......................... ...................... 1613.2.39. Drive............... ......................... ......................... ......................... .............. 1623.2.40. Enabled........... ......................... ......................... ......................... .............. 1623.2.41. FileName ........................ .......................... ......................... ...................... 1623.2.42. FillColor ......................... .......................... ......................... ...................... 1633.2.43. FillStyle ...................... ......................... .......................... ......................... . 1633.2.44. Font ........................ ......................... ......................... ......................... ...... 164

3.2.45. FontBold............. ......................... ......................... ......................... .......... 1643.2.46. FontItalic ........................ .......................... ......................... ...................... 1643.2.47. FontName....................... ......................... .......................... ...................... 1643.2.48. FontSize.................. ......................... ......................... ......................... ...... 1653.2.49. FontStrikethru..................... .......................... ......................... .................. 1653.2.50. FontTransparent........................... ......................... ......................... .......... 1653.2.51. FontUnderline................. ......................... ......................... ....................... 1653.2.52. ForeColor ....................... ......................... ......................... ....................... 1663.2.53. hDC ........................ ......................... ......................... ......................... ...... 1663.2.54. Hidden ........................ ......................... ......................... ......................... .. 1663.2.55. Height ......................... ......................... ......................... ......................... .. 1663.2.56. HelpContextID ....................... .......................... ......................... .............. 1673.2.57. hWnd...................... ......................... ......................... ......................... ...... 1673.2.58. HideSelection ......................... ......................... .......................... .............. 167

3.2.59. Icon................ ......................... ......................... .......................... .............. 1683.2.60. Image..... ......................... ......................... ......................... ....................... 1683.2.61. Index (ActiveX).................. ......................... ......................... ................... 1683.2.62. Index (Control Array)......... ......................... ......................... ................... 1683.2.63. IntegralHeight................. ......................... ......................... ....................... 1693.2.64. Interval ....................... ......................... ......................... ......................... .. 169



Spis treści 7

7

3.2.65. ItemData...................... ......................... ......................... ......................... . 1693.2.66. KeyPreview ......................... ......................... .......................... ................. 1703.2.67. LargeChange ....................... ......................... .......................... ................. 1703.2.68. Left ...................... ......................... ......................... ......................... ......... 1703.2.69. LinkItem...................... ......................... ......................... ......................... . 171

3.2.70. LinkMode........................ ......................... ......................... ...................... 1713.2.71. LinkTimeout....... .......................... ......................... ......................... ......... 1723.2.72. LinkTopic........................ ......................... ......................... ...................... 1723.2.73. List .......................... ......................... ......................... ......................... ..... 1733.2.74. ListCount........ ......................... ......................... .......................... ............. 1733.2.75. ListIndex.............................. ......................... ......................... .................. 1733.2.76. Locked.... ......................... ......................... ......................... ...................... 174

3.2.77. MaskColor...... ......................... ......................... .......................... ............. 1743.2.78. Max ........................ .......................... ......................... ......................... ..... 1743.2.79. MaxButton................... ......................... ......................... ......................... . 1753.2.80. MaxLength ...................... ......................... ......................... ...................... 1753.2.81. MDIChild ........................ ......................... ......................... ...................... 1753.2.82. Min ......................... .......................... ......................... ......................... ..... 1763.2.83. MinButton ....................... ......................... ......................... ...................... 1763.2.84. MouseIcon.. ......................... ......................... ......................... .................. 176

3.2.85. MousePointer ...................... ......................... ......................... .................. 1773.2.86. Moveable......................... ......................... ......................... ...................... 1783.2.87. MultiLine..................... ......................... ......................... ......................... . 1783.2.88. MultiSelect ...................... ......................... ......................... ...................... 1783.2.89. Name ...................... ......................... .......................... ......................... ..... 1793.2.90. Negotiate ......................... ......................... ......................... ...................... 1793.2.91. NegotiateMenus....................... ......................... ......................... .............. 1793.2.92. NegotiatePosition ........................ ......................... .......................... ......... 1793.2.93. NegotiateToolbars ....................... ......................... .......................... ......... 1803.2.94. NewIndex ........................ ......................... ......................... ...................... 1803.2.95. Normal.................... ......................... ......................... .......................... ..... 1803.2.96. OLEDragMode... ......................... ......................... ......................... .......... 1813.2.97. OLEDropMode.................... ......................... ......................... .................. 1813.2.98. Palette ......................... ......................... .......................... ......................... . 1823.2.99. PaletteMode............ ......................... ......................... ......................... ...... 182

3.2.100. Parent...................... ......................... ......................... ......................... ...... 1833.2.101. PasswordChar......... ......................... ......................... ......................... ...... 1833.2.102. Path................. ......................... ......................... ......................... .............. 1833.2.103. Pattern ........................ ......................... ......................... .......................... . 1843.2.104. Picture ........................ ......................... ......................... ......................... .. 1843.2.105. ReadOnly................ ......................... ......................... ......................... ...... 1843.2.106. ScaleHeight ........................ .......................... ......................... .................. 1853.2.107. ScaleLeft......................... ......................... .......................... ...................... 1853.2.108. ScaleMode...................... ......................... .......................... ...................... 1853.2.109. ScaleTop........ .......................... ......................... ......................... .............. 1863.2.110. ScaleWidth ......................... .......................... ......................... .................. 1863.2.111. ScrollBars....................... ......................... ......................... ....................... 1873.2.112. SellCount... ......................... ......................... .......................... .................. 1873.2.113. Selected ...................... ......................... ......................... ......................... .. 188

3.2.114. SelLength ....................... ......................... ......................... ....................... 1883.2.115. SelStart ....................... ......................... ......................... ......................... .. 1883.2.116. SelText ....................... ......................... ......................... ......................... .. 1893.2.117. Shape ...................... ......................... ......................... ......................... ...... 1893.2.118. Shortcut ...................... ......................... ......................... ......................... .. 1903.2.119. ShowInTaskbar................... ......................... .......................... .................. 190




8

3.2.120. SmallChange ....................... ......................... .......................... ................. 1903.2.121. Sorted ...................... ......................... ......................... ......................... ..... 1903.2.122. Stretch ......................... ......................... ......................... ......................... . 1913.2.123. StartUpPosition ........................ ......................... ......................... ............. 1913.2.124. Style......................... ......................... ......................... ......................... ..... 191

3.2.125. System......................... ......................... ......................... ......................... . 1923.2.126. TabIndex.......................... ......................... ......................... ...................... 1933.2.127. TabStop ....................... ......................... ......................... ......................... . 1933.2.128. Tag .......................................................................................................... 1933.2.129. Text ......................... ......................... ......................... ......................... ..... 1933.2.130. ToolTipText ........................ ......................... ......................... .................. 1943.2.131. Top .......................... ......................... ......................... ......................... ..... 194

3.2.132. TopIndex ......................... ......................... ......................... ...................... 1943.2.133. UseMaskColor................. ......................... ......................... ...................... 1953.2.134. UseMnemonic ......................... ......................... .......................... ............. 1953.2.135. Value ...................... .......................... ......................... ......................... ..... 1953.2.136. Visible ......................... ......................... ......................... ......................... . 1963.2.137. WhatsThisButton................. ......................... ......................... .................. 1963.2.138. WhatsThisHelp....... .......................... ......................... ......................... ..... 1963.2.138. WhatsThisHelpID.................... ......................... .......................... ............. 197

3.2.139. Width.......... ......................... ......................... ......................... .................. 1973.2.140. WindowList.... ......................... ......................... .......................... ............. 1973.2.142. WindowState ....................... ......................... ......................... .................. 1983.2.143. WordWrap...... ......................... ......................... ......................... .............. 1983.2.144. X1, Y1 — X2,Y2 .................................................................................... 198

3.3. Zdarzenia kontrolek standardowych ....................... ......................... ...................... 1993.3.1. Activate ....................... ......................... ......................... ......................... . 1993.3.2. Change.................... ......................... .......................... ......................... ..... 1993.3.3. Click ....................... ......................... .......................... ......................... ..... 1993.3.4. DblClick .......................... ......................... ......................... ...................... 2003.3.5. DeActivate.......... ......................... ......................... ......................... .......... 2003.3.6. DragDrop................ ......................... ......................... .......................... ..... 2003.3.7. DragOver........................ .......................... ......................... ...................... 2013.3.8. DropDown...................... .......................... ......................... ...................... 2013.3.9. Error ....................... ......................... ......................... ......................... ...... 202

3.3.10. GotFocus ........................ .......................... ......................... ...................... 2023.3.11. Initialize.................. ......................... ......................... ......................... ...... 2023.3.12. ItemCheck ...................... .......................... ......................... ...................... 2033.3.13. KeyDown ................................................................................................ 2033.3.14. KeyPress............. ......................... ......................... ......................... .......... 2033.3.15. KeyUp ........................ ......................... ......................... .......................... . 2043.3.16. LinkClose ....................... ......................... .......................... ...................... 2043.3.17. LinkError....... .......................... ......................... ......................... .............. 2053.3.18. LinkExecute ....................... .......................... ......................... .................. 2053.3.19. LinkNotify.......................... .......................... ......................... .................. 2063.3.20. LinkOpen................ ......................... ......................... ......................... ...... 2063.3.21. Load........................ ......................... ......................... ......................... ...... 2063.3.22. LostFocus ....................... ......................... .......................... ...................... 2063.3.23. MouseDown ....................... .......................... ......................... .................. 207

3.3.24. MouseMove................ ......................... ......................... ......................... .. 2083.3.25. MouseUp ........................ ......................... ......................... ....................... 2083.3.26. Paint........................ ......................... ......................... ......................... ...... 2093.3.27. PathChange..................... ......................... ......................... ....................... 2093.3.28. PatternChange ......................... ......................... ......................... .............. 2103.3.29. QueryUnload ...................... ......................... .......................... .................. 210



Spis treści 9

9

3.3.30. Reposition............................ ......................... .......................... ................. 2113.3.31. Resize ...................... ......................... ......................... ......................... ..... 2113.3.32. Scroll ....................... ......................... ......................... ......................... ..... 2113.3.33. Terminate ........................ ......................... ......................... ...................... 2123.3.34. Timer ....................... ......................... ......................... ......................... ..... 212

3.3.35. Unload ......................... ......................... ......................... ......................... . 2123.3.36. Validate ....................... ......................... ......................... ......................... . 2133.4. Metody kontrolek standardowych............... ......................... ......................... ......... 213

3.4.1. AddItem................... ......................... ......................... ......................... ..... 2133.4.2. Arrange........... ......................... .......................... ......................... ............. 2143.4.3. Assert........................... ......................... ......................... ......................... . 2143.4.4. Circle ....................... ......................... ......................... ......................... ..... 215

3.4.5. Clear ........................ ......................... ......................... ......................... ..... 2153.4.6. Cls ...................... ......................... .......................... ......................... ......... 2163.4.7. Drag........ ......................... ......................... ......................... ...................... 2163.4.8. EndDoc........... ......................... ......................... .......................... ............. 2163.4.9. GetData ................................................................................................... 2173.4.10. GetFormat........................ ......................... ......................... ...................... 2173.4.11. GetText........... ......................... ......................... .......................... ............. 2183.4.12. Hide ........................ .......................... ......................... ......................... ..... 218

3.4.13. Line ........................ .......................... ......................... ......................... ..... 2183.4.14. LinkExecute ........................ ......................... ......................... .................. 2193.4.15. LinkPoke ......................... ......................... ......................... ...................... 2193.4.16. LinkRequest ........................ ......................... ......................... .................. 2203.4.17. LinkSend ......................... ......................... ......................... ...................... 2203.4.18. Move ...................... .......................... ......................... ......................... ..... 2203.4.19. NewPage...................... ......................... ......................... ......................... . 2213.4.20. OLEDrag ......................... ......................... ......................... ...................... 2213.4.21. PaintPicture ......................... ......................... ......................... .................. 2213.4.22. Point ....................... ......................... .......................... ......................... ..... 2223.4.23. PopupMenu ......................... ......................... ......................... .................. 2223.4.24. Print ........................ ......................... .......................... ......................... ..... 2233.4.25. PrintForm ........................ ......................... ......................... ...................... 2233.4.26. PSet ........................ ......................... .......................... ......................... ..... 2243.4.27. Refresh ....................... .......................... ......................... ......................... . 224

3.4.28. RemoveItem ........................ ......................... ......................... .................. 2243.4.29. Scale ....................... ......................... ......................... .......................... ..... 2253.4.30. ScaleX ........................ ......................... .......................... ......................... . 2253.4.31. ScaleY ........................ ......................... .......................... ......................... . 2263.4.32. SetData ....................... ......................... .......................... ......................... . 2263.4.33. SetFocus ......................... .......................... ......................... ...................... 2273.4.34. SetText ....................... ......................... ......................... .......................... . 2273.4.35. Show............... ......................... ......................... ......................... .............. 2283.4.36. ShowColor.................. ......................... ......................... .......................... . 2283.4.37. ShowFont ....................... ......................... .......................... ...................... 2283.4.38. ShowHelp ....................... ......................... .......................... ...................... 2283.4.39. ShowOpen ...................... ......................... .......................... ...................... 2293.4.40. ShowPrinter........................ .......................... ......................... .................. 2293.4.41. ShowSave ....................... ......................... ......................... ....................... 229

3.4.42. ShowWhatsThis............................... ......................... ......................... ...... 2293.4.43. TextHeight.............. ......................... ......................... ......................... ...... 2303.4.44. TextWidth........................... ......................... .......................... .................. 2303.4.45. WhatsThisMode .......................... ......................... ......................... .......... 2303.4.46. ZOrder ........................ ......................... ......................... ......................... .. 231



11

Wstęp

Wyobraźmy sobie mechanika samochodowego, do którego przyjechał klient z przebi-

tą oponą . Nasz miły fachowiec jest człowiekiem zdolnym, energicznym i pełnym za-

pału — więc posiada cechy jak najbardziej pożą dane w każdym zawodzie. Oczywi-

ście zabrał się od razu za pomoc nowemu klientowi. Lecz zapomniał (!), niestety, że

dopiero co został przyjęty do warsztatu i jeszcze się nawet nie zapoznał z tym „co,

gdzie leży”. Nasz bohater wie, że aby obsłużyć powyższy przypadek, musi z koła wy- jąć dętk ę, następnie zlokalizować miejsce przebicia, potem je zakleić, dętk ę włożyć zpowrotem do opony i ją napompować — nie zapominają c przy tym o zainkasowaniu

należności, oczywiście. Ale nadszedł chyba czas, aby przystopować — wiedzieć, co

trzeba zrobić, a umieć to zrobić, to przecież dwie różne sprawy.

Już zapewne wszyscy wiedzą , do czego zmierzam. Przecież trzeba wiedzieć, jakie wy-korzystać narzędzia i urzą dzenia do efektywnego wykonania poszczególnych czynno-

ści. Oczywiście zaraz ktoś może powiedzieć, że dętk ę można wyjąć za pomocą zwykłe-

go śrubokręta, skleić ją butaprenem, a oponę napompować zwyczajną pompk ą . Racji

odmówić nie można, ale czy byłyby to działania odpowiednie w dobie postępu? Zdecy-dowanie nie! Ale aby wiedzieć, jak dane narzędzie wykorzystać, trzeba dokładnie się

z nim zapoznać. I właśnie temu służyć ma ta książka. Musimy zapoznać i „oswoić się”

z naszym warsztatem pracy, aby prosto, łatwo i przyjemnie z niego korzystać.



13

Rozdział 1.

Podstawy obsługi programu

VB

Aby zabrać się do jakiejkolwiek pracy za pomocą jakiegokolwiek programu kompute-rowego, trzeba umieć się nim posługiwać. Na począ tku musi to być wiedza o charak-terze nawigacyjnym, dopiero potem pogłębiana bardziej szczegółowymi wiadomo-

ściami. Ten rozdział zapewnia sporą dawk ę takiej właśnie wiedzy nawigacyjnej.

1.1. Menu programu

Na począ tek zajmijmy się tym, co „na wierzchu”. Jednym z pierwszych, rzucają -

cych się w oczy, elementów środowiska programistycznego Visual Basic jest jego

menu. I słusznie, ponieważ za jego pomocą można zrobić bardzo wiele pożytecznych

rzeczy. Zapoznanie się z jego funkcjami jest bardzo pomocne w późniejszym, płyn-nym tworzeniu programów.

1.1.1. File

New Project

Opcja ta powoduje rozpoczęcie nowego projektu, od którego w VB wszystko się za-czyna — to właśnie z niego może powstać przyszła aplikacja. Po wybraniu tej opcji

zawsze pojawi się okno wyboru o nazwie New Project , w którym określamy, jakiego

rodzaju będzie tworzony właśnie projekt.

Opcję tę możemy również uruchomić kombinacją klawiszy (Ctrl+N ).




14

Open Project

Służy do otwierania (uruchamiania) projektu już istnieją cego na jakimkolwiek dysku.

Tę opcję można również uruchomić kombinacją klawiszy (CTRL+O).

Add Project...

Za jej pomocą można stworzyć tzw. grupę projektów poprzez dodanie do projektu już ist-nieją cego następnego — tak że już istnieją cego gdzieś na dysku — lub nowego projektu.

Remove Project

Opcja ta usuwa aktywny projekt z grupy projektów. Na szczęście nie niszczy go, lecztylko powoduje, iż jego przynależność do danej grupy zostaje zawieszona.

Save Project lub Save Project Group

Jeżeli chcemy zachować aktualny projekt lub aktualną grupę projektów na dysku— posłużmy się właśnie jedną z tych dwóch opcji. Projekt lub grupa zachowywane są wtedy pod tą samą nazwą i w tym samym miejscu, z którego dokonaliśmy otwarcia.Jedynie podczas próby zapisania nowo utworzonego projektu program zareaguje tak, jakbyśmy uruchomili opcję Save Project As.



Rozdział 1. ♦♦♦♦ Podstawy obsługi programu VB 15

Save Project As lub Save Project Group As

Niejednokrotnie zachodzi potrzeba zapisania projektu lub grupy projektów pod inną na-zwą niż dotychczasowa, np. dla celów archiwizacji. Wtedy posługujemy się właśnie jedną

z tych dwóch opcji. Wraz z konkretną nazwą możemy określić docelową lokalizację.

Save..., Save... As

Zachowuje lub zapisuje pod podaną nazwą plik projektu bą dź grupy projektów, nad

którym aktualnie pracujemy.

Print

Wyświetla okno służą ce do określenia podstawowych opcji wydruku. Pozwala wy-

drukować tylko w przypadku zainstalowanej drukarki — w przeciwnym wypadku

program sygnalizuje błą d stosownym komunikatem.

Print Setup

Pozwala określić ustawienia drukarki, lecz tylko w przypadku, gdy jest zainstalowana

— w przeciwnym wypadku program sygnalizuje błą d stosownym komunikatem.

Make <NAZWA>

Opcja ta umożliwia stworzenie z aktualnego projektu lub grupy projektów pliku wy-

konywalnego (*.exe, *.dll lub *.ocx).

Make Project Group

Za pomocą tej opcji stworzymy pliki wykonywalne z każdego projektu lub wybranej

grupy projektów.

Ta sama operacja zostanie wykonana również podczas użycia komendy Make — gdy

wybierzemy plik *.vbg (grupa projektów).

1 <LOKALIZACJA> lub (i) 2 <LOKALIZACJA>

lub (i) 3 <LOKALIZACJA> lub (i) 4 <LOKALIZACJA>

Każdy z numerów symbolizuje plik projektu lub grupy projektów, nad którym nie-

dawno pracowaliśmy. Inaczej mówią c, stworzona jest swoista lista ostatnio używa-

nych plików.




16

Exit

Wybranie tej opcji powoduje zamknięcie aktualnego projektu lub grupy projektów

i wyjście z programu Visual Basic. W przypadku gdy praca nie została wcześniej za-

chowana, program umożliwia to, wyświetlają c stosowne okno.

1.1.2. Edit

Undo

Opcja przywracają ca stan sprzed ostatniej operacji, takiej jak usuwanie czy wpisanietekstu w oknie kodu. Niestety, operacja ta nie przyniesie oczekiwanego skutku w sto-sunku do kontrolki.

W przypadku edycji tekstu za pomocą tej opcji możemy cofnąć do 20 „stanów”.

Redo

Za jej pomocą możemy wycofać się z operacji Undo, przywracają c to, co wcześniejcofnęliśmy.




W przypadku edycji tekstu za pomocą tej opcji możemy przywrócić do 20 „stanów”.

Cut

Usuwa zaznaczoną kontrolk ę lub tekst z okna projektu, umieszczają c je jednocześniew schowku systemowym.

Copy

Wycina zaznaczoną kontrolk ę lub tekst z okna projektu, umieszczają c je jednocześniew schowku systemowym.

Paste

Wstawia zawartość schowka do projektu.

Paste Link

Wstawia odnośnik do ważnego źródła DDE. Gdy schowek nie zawiera ważnego źródłaDDE i zaznaczona kontrolka nie jest ważnym połą czeniem DDE, opcja jest nieaktywna.

Opcji tej można użyć też do łą czenia danych z innej aplikacji, używają c kontrolki OLE .

Delete

Usuwa aktywną kontrolk ę, tekst lub wyrażenie Watch.

Select All

Zaznacza wszystkie obiekty w oknie Form lub cały tekst w oknie Code.

Find

Wyświetla okno przeznaczone do wpisania poszukiwanego cią gu znaków (tylko w oknieCode). W przypadku odnalezienia szukanego cią gu zostanie on zaznaczony — w prze-ciwnym wypadku wyświetlony zostanie stosowny komunikat.

Find Next

Wyszukuje i zaznacza następne wystą pienie tekstu określonego w okienku Find What

okna dialogowego Find .




18

Replace

Po wybraniu tej opcji pojawi się okienko dialogowe Replace, w którym określamycią g znaków, którego wszystkie wystą pienia mają zostać zamienione na inny, również

określony w tym okienku ci

ą g.

Ident

Polecenie to powoduje przesunięcie wszystkich zaznaczonych fragmentów kodu nanastępną pozycję tabulatora.

Szerokość tabulacji można zmieniać w zakładce Editor okienka dialogowego Options.

Outdent

Polecenie to powoduje przesunięcie wszystkich zaznaczonych fragmentów kodu na

poprzednią pozycję tabulatora.

Szerokość tabulacji można zmieniać w zakładce Editor okienka dialogowego Options.

Insert File

Pozwala wstawić tekst z pliku znajdują cego się na dysku w aktualnym położeniu kursora.

Wyboru pliku źródłowego dokonujemy w okienku Insert File, pojawiają cym się bezpo-

średnio po wyborze tej opcji.

List Properties/Methods

Otwiera okienko wyboru w oknie kodu, zawierają ce właściwości i metody dostępnedla obiektu poprzedzają cego kropk ę (.). Polecenie to wyświetla tak że wszystkie do-

stępne metody, gdy kursor znajduje się w nie zapisanym fragmencie okna Code.

Podczas pisania kodu programu lista ta w razie potrzeby może się otwierać automatycz-

nie — należy w tym celu włą czyć opcję Auto List Members w zakładce Editor okienka

dialogowego Options.

List Constans

Otwiera okienko wyboru w oknie kodu, zawierają ce stałe dostępne dla wypisanejwłaściwości, poprzedzonej znakiem równości (=). Polecenie to działa tak że dla funk-

cji z argumentami, które są stałymi.




Podczas pisania kodu programu lista ta w razie potrzeby może się otwierać automatycz-

nie — należy w tym celu włą czyć opcję Auto List Members w zakładce Editor okienka


Quick Info

Wyświetla składnię dla zmiennej, funkcji, instrukcji, metody lub procedury, którą za-

znaczymy w oknie kodu.

Opcja ta pokazuje składnię dla określonej pozycji i podświetla aktualny parametr.

Dla funkcji i procedur z parametrami podczas pisania parametru jest on zaznaczony

pogrubieniem tak długo, dopóki nie zostanie wpisany przecinek, używany do oddzie-

lenia go od następnego parametru.

Podczas pisania kodu programu pomoc ta w razie potrzeby może się otwierać automa-

tycznie — należy w tym celu włą czyć opcję Auto Quick Info w zakładce Editor okienka


Parameter Info

Pokazuje komunikat w oknie kodu, zawierają cy informację o parametrach pierwszej

funkcji lub instrukcji znajdują cej się przed lub nad kursorem. Jeżeli funkcja lub in-

strukcja zawiera funkcje lub instrukcje jako parametry, Parameter Info pokazuje in-

formacje o pierwszej takiej funkcji lub instrukcji.

Do uzyskania informacji o każdym takim parametrze należy użyć każdorazowo opcji Qu-

ick Info.

Complete Word

Opcja uzupełniają ca pozostałą , nie wpisaną część słowa, o ile na podstawie już wpi-

sanych liter program Visual Basic potrafi zidentyfikować oczekiwane słowo.

Bookmarks

Wyświetla podmenu, za pomocą którego możemy stworzyć lub usunąć zakładk ę w oknie

kodu, przejść do następnej lub poprzedniej zakładki lub wyczyścić wszystkie zakładki.




20

W przypadku dodania zakładki przy wierszu, w którym to zostało zrobione, pojawi się

błękitny prostok ą cik.

Elementy podmenu Bookmarks:

♦ Toggle Bookmark — wstawia lub usuwa zakładk ę,

♦ Next Bookmark — przenosi kursor do wiersza z następną zakładk ą ,

♦ Previous Bookmark — przenosi kursor do wiersza z poprzednią zakładk ą ,

♦ Clear All Bookmarks — usuwa wszystkie zakładki.

1.1.3. View

Code

Wyświetla lub aktywuje okno kodu dla aktualnie zaznaczonego obiektu (kontrolki).

Object

Opcja dostępna tylko wtedy, gdy jesteśmy w oknie kodu projektu i jednocześnie kursorznajduje się na fragmencie kodu zwią zanym z istnieją cym obiektem tegoż projektu.




Definition

Wskazuje lokalizację zdefiniowania zmiennej lub procedury, wskazanej położeniemkursora w oknie kodu projektu.

Last Position

Umożliwia szybkie przeniesienie do ostatnio edytowanego miejsca w kodzie projektu.

Dostępna po wpisaniu jakiegoś tekstu lub po użyciu polecenia Definition, ale tyl-

ko w oknie kodu.

Program Visual Basic pamięta osiem ostatnich ruchów kursora.

Object Browser

Wyświetla okno Object Browser , zawierają ce: biblioteki obiektów, typów, klas, me-tod, właściwości, zdarzeń i stałych, których można użyć w kodzie, a tak że modułówi procedur zdefiniowanych w projekcie.

Immediate Window

Pokazuje okno Immediate, a w nim informacje zwią zane ze sprawdzaniem błędóww kodzie projektu. Za jego pomocą możemy np.:

1. uruchomić wybrany lub właśnie wprowadzony w okienku fragment kodu,

2. uruchomić wybraną procedurę,

3. zmieniać wartości dla zmiennych lub właściwości obiektów.

Locals Window

Wyświetla okno Locals, wyświetlają c wszystkie zmienne znajdują ce się aktualnie nastosie i ich wartości. Okno to jest automatycznie aktualizowane przy każdym punkcie

Break Mode oraz przy każdej zmianie stanu stosu.

Watch Window

Pokazywane jest okienko Watch, pokazują ce wszystkie zdefiniowane w projekcie wy-rażenia Watch. Gdy zostanie zdefiniowane jakieś wyrażenie Watch w projekcie,okienko to pojawia się automatycznie.

Call Stack

Okienko dialogowe Calls dostępne po wybraniu tej opcji wypisuje wszystkie wywo-łane procedury w programie, których wykonania rozpoczęły się, lecz nie zakończyły.




22

Gdy Visual Basic wykonuje procedurę, jest ona dodawana do listy aktualnie wywoła-nych procedur. Jeżeli procedura ta wywoła inną procedurę, to obie są na liście jakoaktualnie wywołane. Za każdym razem gdy procedura wywołuje inną procedurę Sub,Function lub Property, jest ona dodawana do listy. Każda procedura jest usuwana z listy,gdy wykonywanie wraca do procedury wywołują cej. Procedury wywołane z okna

Immediate są tak że dodane do listy wywołań.

Opcja ta dostępna jest tylko w trybie Break Mode.

Project Explorer

Wyświetla okno Project Explorer , w którym pokazana jest hierarchiczna lista aktual-nie otwartych projektów.

Properties Window

Wyświetla okno Properties, w którym wymienione są właściwości dostępne dla za-znaczonej formy, kontrolki, klasy, kontrolki użytkownika, strony właściwości, doku-

mentu użytkownika lub menu.

Opcja nie jest dostępna podczas działań w kodzie projektu.

Form Layout Window

Wyświetla okno Form Layout , w którym można zobaczyć pozycję obiektu lub obiek-tów Form bieżą cego projektu. Dostępny jest też podglą d dla innej rozdzielczości

ekranu niż bieżą ca, poprzez zaznaczenie opcji Resolution Guide w menu podręcznym,dostępnym poprzez naciśnięcie prawego klawisza myszy na miniaturze obiektu Form.

Za pomocą tej opcji dostępne są jedynie rozdzielczości mniejsze od aktualnie ustawionej

dla monitora.

Property Pages

Wyświetla strony właściwości dla kontrolki użytkownika.

Za ich pomocą można zmieniać właściwości kontrolki w czasie projektowania pro-

gramu.




Toolbox

Wyświetla lub ukrywa okno narzędzi, zawierają ce kontrolki i dołą czane obiekty aktu-alnego projektu.

Dostępne tylko w czasie projektowania.

Color Palette

Wyświetla paletę kolorów, za pomocą której możemy określić kolor dla wybranejkontrolki.

Toolbar

Wyświetla podmenu, zawierają ce listę nazw pasków narzędzi: Debug, Edit , Form

Editor , Standard i nazwę paska (pasków) narzędzi użytkownika (jeśli go (je) zdefi-niowano) — można je aktywować lub wyłą czać poprzez kliknięcie na wybranym.

Na końcu listy znajduje się polecenie Customize, dzięki któremu możemy zmodyfi-

kować istnieją cy lub stworzyć własny pasek narzędziowy lub nowe menu.

1.1.4. Project




24

Add Form

Umożliwia wstawienie nowego lub już istnieją cego obiektu Form do projektu.

Add MDIForm

Umożliwia wstawienie nowego obiektu MDIForm do projektu.

Opcja jest nieaktywna, w przypadku gdy projekt posiada już obiekt MDIForm.

Add Module

Wyświetla okienko dialogowe Add Module, za pomocą którego można wstawić nowy

lub istnieją cy moduł do aktywnego projektu.

Add Class Module

Wyświetla okienko dialogowe Add Class Module, za pomocą którego można wstawićnowy lub istnieją cy moduł klasy do aktywnego projektu.

Add User Control

Wyświetla okienko dialogowe Add User Control, za pomocą którego można wstawićnową lub istnieją cą kontrolk ę użytkownika do aktywnego projektu.

Add Property Page

Wyświetla okienko dialogowe Add Property Page, za pomocą którego można wsta-wić nowe lub istnieją ce strony właściwości do aktywnego projektu. Strony właściwo-

ści tworzy się, używają c Property Page Wizard , ale tylko wtedy, gdy tworzymy kon-

trolk ę ActiveX lub gdy już istnieje stworzona przez nas kontrolka.

Add User Document

Wyświetla okienko dialogowe Add User Document , za pomocą którego można wsta-wić nowy lub istnieją cy dokument użytkownika do aktywnego projektu.

Opcja dostępna tylko podczas tworzenia projektu ActiveX EXE lub ActiveX DLL.




Add ActiveX Designer

Wyświetla listę dostępnych ActiveX Designers (projektantów kontrolek ActiveX ),które można dołą czyć do aktywnego projektu.

Opcja jest dostępna po dodaniu konstruktora ActiveX przy użyciu polecenia Components

w menu Project .

Add File

Dodaje istnieją cy plik do bieżą cego projektu z możliwością dzielenia go pomiędzyprojekty. W przypadku dokonania jakichkolwiek zmian w takim udostępnionym pliku

i zapisaniu ich zmiany te będą dotyczyły każdego projektu, który zawiera ten plik.

Remove <NAZWA>

Umożliwia usunięcie aktywnego obiektu z projektu. W przypadku wcześniejszych,nie zapisanych zmian program wyświetli pytanie, czy najpierw je zapisać.

References

Wyświetla okienko dialogowe References, za pomocą którego można dodać bibliote-

k ę obiektów lub bibliotek ę typów lub referencję projektu do aktywnego projektu.

Components

Wyświetla okienko dialogowe Components, za pomocą którego można dodawaćkontrolki, konstruktory lub obiekty wstawialne do okna narzędziowego ToolBox.

<NAZWA> Properties

Wyświetla okienko dialogowe Project Properties, za pomocą którego możemy prze-glą dać właściwości dostępne dla aktywnego projektu.




26

1.1.5. Format

Align

Wyrównuje zaznaczone obiekty według wybranego schematu w stosunku do obiektu

zaznaczonego jako ostatni (którego wskaźniki zmiany rozmiaru są zaznaczone peł-nym kolorem).

Dostępne ustawienia:

♦ Lefts — wyrównuje obiekty w poziomie do lewej krawędzi względem

obiektu zaznaczonego jako ostatni,

♦ Centers — wyśrodkowuje obiekty w poziomie względem obiektu

zaznaczonego jako ostatni,

♦ Rights — wyrównuje obiekty w poziomie do prawej krawędzi względem


♦ Tops — wyrównuje obiekty w pionie do górnej krawędzi względem obiektu

zaznaczonego jako ostatni,

♦ Middles — wyśrodkowuje obiekty w pionie względem obiektu zaznaczonego

jako ostatni,

♦ Bottoms — wyrównuje obiekty w pionie do dolnej krawędzi względem


♦ To Grid — dosuwa lewe górne krawędzie zaznaczonych obiektów na

najbliższej linii siatki.




Make Same Size

Dostosowuje rozmiary zaznaczonych obiektów w stosunku do rozmiaru obiektu za-

znaczonego jako ostatni.


♦ Width — dostosowuje szerokość zaznaczonych obiektów,

♦ Height — dostosowuje wysokość zaznaczonych obiektów,

♦ Both — dostosowuje wysokość i szerokość zaznaczonych obiektów.

Size to Grid

Zmienia rozmiary zaznaczonego obiektu, dopasowują c je do najbliższych linii siatki.

Rozmiary siatki można zmieniać w zakładce General okienka dialogowego Options.

Horizontal Spacing

Zmienia rozmiar poziomej przestrzeni pomiędzy zaznaczonymi obiektami, nie zmie-

niają c położenia obiektów skrajnych.


♦ Make Equal — rozsuwa wszystkie zaznaczone obiekty tak, aby przestrzeńmiędzy nimi była równa,

♦ Increase — zwiększa przestrzeń pomiędzy obiektami o jedną jednostk ę siatki,

♦ Decrease — zmniejsza przestrzeń pomiędzy obiektami o jedną jednostk ę siatki,

♦ Remove — likwiduje poziomą przestrzeń pomiędzy obiektami, tak aby obiekty

te stykały się ze sobą krawędziami.

Vertical Spacing

Zmienia rozmiar pionowej przestrzeni pomiędzy zaznaczonymi obiektami, nie zmie-

niają c położenia obiektów skrajnych.




28


♦ Make Equal — rozsuwa wszystkie zaznaczone obiekty tak, aby przestrzeńmiędzy nimi była równa,

♦ Increase — zwiększa przestrzeń pomiędzy obiektami o jedną jednostk ę siatki,

♦ Decrease — zmniejsza przestrzeń pomiędzy obiektami o jedną jednostk ę siatki,

♦ Remove — likwiduje poziomą przestrzeń pomiędzy obiektami, tak aby obiekty

te stykały się ze sobą krawędziami.

Center in Form

Ustawia zaznaczone obiekty na środku obiektu Form.


♦ Horizontally — ustawia środek zaznaczonych obiektów na poziomej linii,

wyznaczają cej środek obiektu Form,

♦ Vertically — ustawia środek zaznaczonych obiektów na pionowej linii,

wyznaczają cej środek obiektu Form.

Order

Zmienia kolejność zaznaczonych obiektów w formie:


♦ Bring to Front — przesuwa zaznaczone obiekty nad wszystkie inneobiekty,

♦ Send To Back — przesuwa zaznaczone obiekty pod wszystkie inneobiekty.

Lock Controls

Powoduje unieruchomienie wszystkich kontrolek, aby nie uległy przypadkowemuprzesunięciu.




1.1.6. Debug

Step Into

Wykonuje kod programu po kolei — po jednej instrukcji. Użycie tej opcji podczasprojektowania spowoduje rozpoczęcie wykonywania programu i wejście, przed wy-konaniem pierwszej instrukcji, w tryb Break Mode (przerwania).

Step Over

Wykonuje kod programu po kolei — po jednej instrukcji — z wyją tkiem sytuacji, gdytak ą instrukcją jest wywołanie procedury. Wtedy wykonywana jest ona jako jedna in-strukcja — następną wyświetlaną instrukcją jest kolejna instrukcja (lub wywołaniekolejnej procedury) w aktualnej procedurze.

Opcja dostępna tylko w trybie Break Mode (przerwania).

Step Out

Wykonuje pozostałe wiersze funkcji aktualnie wykonywanej.


Run To Cursor

Umożliwia zaznaczenie instrukcji, na której ma zostać zatrzymane wykonywanie

programu. Kod będzie wykonywany od aktualnej instrukcji do instrukcji zaznaczonej,oznaczonej „trójk ą cikiem”.




30


Add Watch

Wyświetla okienko dialogowe Add Watch, za pomocą którego można wprowadzićwyrażenie Watch.

Opcja dostępna tylko w trakcie projektowania lub w trybie Break Mode (przerwania).

Edit Watch

Wyświetla okienko dialogowe Edit Watch, za pomocą którego możemy edytować lubusuwać wyrażenia Watch.

Opcja dostępna tylko w momencie istnienia jakiegoś wyrażenia Watch.

Quick Watch

Wyświetla okienko dialogowe Quick Watch, zawierają ce aktualną wartość zazna-czonego wyrażenia. Polecenia tego można używać do sprawdzenia aktualnej warto-

ści zmiennej, właściwości lub innego wyrażenia, dla którego nie ma zdefiniowane-

go wyrażenia Watch.


Toggle Breakpoint

Ustawia lub usuwa punkt przerwania (fragment kodu, przy którym wykonywanie zo-stanie automatycznie przerwane). Nie można ustawić punktu przerwania przy frag-mencie kodu zawierają cym komentarz, deklarację lub pusty wiersz.

Clear All Breakpoints

Usuwa wszystkie punkty przerwania w kodzie, lecz w przypadku, gdy są ustawione jakieś wyrażenia Watch lub jest zaznaczona opcja Break on All Errors w zakładce

General okienka dialogowego Options — wykonanie może być nadal przerywane.

Polecenia tego nie można cofnąć.




Set Next Statement

Ustawia inny punkt wykonywania programu w wybranym wierszu. Przy użyciu tegopolecenia możemy wybrać wiersz kodu zlokalizowany przed lub po aktualnie zazna-

czonym wierszu. Używa się jej do ponownego uruchomienia instrukcji w aktualnejprocedurze lub ominięcia instrukcji, która ma być pominięta.

Nie można opcji tej używać w stosunku do instrukcji w innych procedurach.

Show Next Statement

Podświetla instrukcję, która będzie wykonywana jako następna.

1.1.7. Run

Start

Uruchamia projekt ustawiony jako Start Up w Project Explorer — standardowo jestto projekt bieżą cy.

Start With Full Compile

Uruchamia projekt, dokonują c wcześniej jego pełnej kompilacji, niezależnie od usta-wień opcji Compile On Demand i Background Compile w zakładce General okienkadialogowego Options — przy czym uruchomienie nie ma wpływu na stan tych opcji.

Szczególnie polecenia tego należy używać do uruchamiania projektów ActiveX , po-nieważ uruchomienie takiego projektu poleceniem Start , przy włą czonej opcji Compi-

le On Demand , może powodować, iż błędy w czasie kompilacji zostaną wykryte do-piero przy zakończeniu testowania działania aplikacji.

Break

Zatrzymuje wykonywanie kodu podczas jego uruchomienia i przełą cza w tryb przerwania.Instrukcja wykonywana podczas wybrania tego polecenia zostanie wyświetlona w okniekodu ze wskaźnikiem zatrzymania na lewym marginesie (w przypadku gdy jest zaznaczo-na opcja Margin Indicator Bar w zakładce Editor Format okienka dialogowego Options).




32

Niektóre zmiany w kodzie, poczynione podczas trybu przerwania, mogą wymagaćponownego wykonania projektu, aby wywołały oczekiwany skutek.

Opcja dostępna tylko w czasie wykonywania kodu projektu.

End

Powoduje zatrzymanie wykonywania kodu projektu i powrót do trybu projektowania.

Opcja dostępna tylko w czasie wykonywania kodu projektu i w trybie przerwania.

Restart

Powoduje ponowne wykonanie kodu projektu. Opcji tej użyć można po każdym rodzaju

przerwania, spowodowanym błędami w trakcie wykonania programu, instrukcją Stop,punktem przerwania ( Break Point ) w kodzie programu lub wyborem polecenia Break .

Opcja dostępna tylko w trybie przerwania.

1.1.8. Tools

Add Procedure...

Wstawia nową procedurę Sub, Function, Property lub Event do aktywnego modułu.

Polecenie to nie jest dostępne, gdy moduł nie jest aktywny.

Procedure Attributes...

Otwiera okienko dialogowe Procedure Attributes, za pomocą którego można ustawićatrybuty dla każdej właściwości i metody określonej dla danej procedury.




Można używać tego polecenia tak że do ustawiania właściwości Value dla klasy.

Menu Editor

Wyświetla okienko dialogowe Menu Editor , za pomocą którego możemy utworzyćmenu użytkownika dla tworzonego właśnie projektu.

Opcja dostępna tylko w trybie projektowania.

Options

Wyświetla okienko dialogowe Options, za pomocą którego możemy ustawić różnewłasności programu Visual Basic.

Opcja dostępna tylko w trybie projektowania.

1.1.9. Add-Ins

Visual Data Manager...

Uruchamia aplikację Visual Data Manager , poprzez którą możemy uzyskać dostęp dodanych i zarzą dzać nimi.

Report Designer...

Wyświetla okienko dialogowe Add-In Manager , za pomocą którego możemy instalo-wać lub usuwać, rozszerzają ce jego standardowe możliwości.

Add-In Manager...

Rozszerzenia dodatkowe Add-Ins. Wymienione są tutaj odnośniki do wszystkich do-

datkowych programów zainstalowanych dla pakietu Visual Basic, rozszerzają cych je-go standardowe możliwości.




34

1.1.10. Window

Split

Dzieli okno kodu na dwie równe części w poziomie. Dzięki tej możliwości możemyobserwować kod w dwóch miejscach równocześnie.

Opcja dostępna tylko w oknie kodu.

Tile Horizontally

Dzieli okno kodu na dwie równe części w poziomie. W pierwszym pokazuje okno ko-du, w drugim zaś okno projektowania.

Tile Vertically

Dzieli okno kodu na dwie równe części w pionie. W pierwszym pokazuje okno kodu,w drugim zaś okno projektowania.

Cascade

Ustawia okno kodu i okno projektowania kaskadowo — jedno pod drugim.

Arrange Icons

W przypadku wcześniejszego przesunięcia miniatury dowolnego okna, po wcześniej-

szym jego zminimalizowaniu, wyrównuje ją do lewego dolnego rogu pola roboczego

programu Visual Basic.

1 <NAZWA>, 2 <NAZWA> itd.

Lista wszystkich otwartych okien w programie Visual Basic.




1.1.11. Help

Microsoft Visual Basic Help Topics

Wyświetla pomoc dla programowania w Visual Basicu.

Books Online...

Uruchamia pomoc Microsoft Visual Basic Books Online.

Obtaining Technical Support...

Uruchamia pomoc Microsoft Product Support Services.

Microsoft on the Web

Wyświetla menu z odnośnikami do internetowych stron firmy Microsoft.

About Microsoft Visual Basic

Wyświetla okienko z ogólnymi informacjami o używanym pakiecie Visual Basic:

numer wersji, prawa autorskie itp. Umożliwia również uzyskanie informacji o syste-mie operacyjnym naszego komputera poprzez naciśnięcie przycisku System Info.

1.2. Okna w VB

Teraz zobaczmy i poznajmy to, co „nieco głębiej”. Zapoznajmy się z ważniejszymioknami w programie Visual Basic. Znajomość ich rozkładu bardzo pomoże w spraw-

nym wykorzystywaniu narzędzi Visual Basic.

1.2.1. Call StackOkienko wyświetlają ce wszystkie wykonywane procedury podczas przejścia z trybuwykonywania kodu do trybu przerwania.




36

Procedura dodawana jest do listy aktualnie wywołanych procedur wtedy, gdy jest onawywoływana podczas wykonywania kodu projektu. W przypadku, gdy procedura ta

wywołuje inną procedurę, to są one obie wymienione na liście procedur okienka Call

Stack . Jest tam dodawana każda z wywołanych procedur.

Jeżeli wykonywanie kodu wraca do procedury wywołują cej, jej procedura podrzędna

usuwana jest z listy. Procedury wywołane z okna Immediate tak że dodawane są do li-

sty wywołanych procedur.

Okienko Call Stack można wywołać podczas trybu przerwania poleceniem Call Stack

w menu View lub skrótem klawiaturowym (Ctrl+L).

Funkcje przycisków:

♦ Show — powoduje wskazanie wywoływanego właśnie wiersza koduw oknie Code.

♦ Close — powoduje zamknięcie okienka Call Stack .

1.2.2. Code

Okno wyświetlają ce kod projektu i umożliwiają ce jego edycję.

Okienko Code posiada następują ce elementy:




♦ Lista rozwijalna obiektów — domyślnie wskazuje na nazwę obiektu,do którego należy fragment kodu oznaczony migają cym kursorem.

Po rozwinięciu pokazuje wykaz nazw wszystkich obiektów powią zanych

z aktywnym formularzem. W przypadku wybrania pozycji z listy kursorw oknie przemieszczany jest do zwią zanego z nią fragmentu kodu.

♦ Lista rozwijalna zdarzeń — lista wszystkich zdarzeń dostępnych dla obiektu

wybranego w rozwijalnej liście obiektów. W przypadku wybrania pozycjiz listy wyświetlana jest definicja procedury, obsługują cej wybrane zdarzenie.

W przypadku użycia okna Code dla edytowania kodu modułu lista ta zawiera

listę wszystkich procedur w module.

♦ Procedure View (pierwszy przycisk w lewym dolnym rogu okna) — powoduje

wyświetlenie w całym oknie tylko procedury, w której znajduje się kursor,zwią zanej z aktywnym modułem lub formularzem.

♦ Full Module View (drugi przycisk w lewym dolnym rogu okna) — powoduje

wyświetlenie w całym oknie wszystkich procedur zwią zanych z aktywnym

modułem lub formularzem.

1.2.3. Components

Okno to pozwala na dodawanie komponentów, takich jak kontrolki i projektanci, i do-

dawalnych obiektów do aktualnego projektu.




38

Okno Components posiada trzy zakładki:

Controls

Zakładka ta wyświetla listę dostępnych w systemie standardowo kontrolek. Oczywi-

ście można dodawać kontrolki własne lub z pochodzą ce z innych źródeł, wyszukują c

je na dysku za pomocą przycisku Browse i dodają c je do listy.

Wyboru kontrolki z listy dokonujemy przez zaznaczenie pustego kwadratu obok jejnazwy, a odznaczają c go, powodujemy usunięcie z projektu. Nie możemy jednak

usunąć z projektu kontrolek, które są w nim aktualnie używane.

W przypadku zaznaczenia opcji Select Items Only na liście wyświetlone zostaną tylkokontrolki aktualnie dołą czone do projektu.

W ramce oznaczonej nazwą Location pokazywana jest fizyczna lokalizacja na dysku

pliku kontrolki zaznaczonej kolorem na liście.

Designers

Zakładka ta wyświetla listę dostępnych projektantów dla danego projektu.

Wyboru projektanta z listy dokonujemy, zaznaczają c pusty kwadracik obok jego na-zwy, a odznaczają c go, powodujemy usunięcie z projektu.

Nie możemy jednak usunąć z projektu projektanta, który jest w nim aktualnie używany.




W przypadku zaznaczenia opcji Select Items Only na liście wyświetlone zostaną tylkopliki projektantów aktualnie dołą czone do projektu.

W ramce oznaczonej nazwą Location pokazywana jest fizyczna lokalizacja na dyskupliku projektanta zaznaczonego kolorem na liście.

Insertable Objects

Zakładka ta wyświetla listę dostępnych, możliwych do dodania obiektów dla danego

projektu.

Wyboru możliwego do dodania obiektu z listy dokonujemy, zaznaczają c pusty kwa-

drat obok jego nazwy, a odznaczają c go, powodujemy usunięcie z projektu.

Nie możemy jednak usunąć z projektu możliwego do dodania obiektu, który jest w nim

aktualnie używany.

W przypadku zaznaczenia opcji Select Items Only na liście wyświetlone zostaną tylko

dodawalne obiekty aktualnie dołą czone do projektu.

W ramce oznaczonej nazwą Location pokazywana jest fizyczna lokalizacja na dysku

pliku dodawalnego obiektu zaznaczonego kolorem na liście.

1.2.4. Form

Okno służą ce do wizualnego projektowania interfejsu tworzonego programu poprzez

umiejscawianie na nim dostępnych dla projektu obiektów.




40

Wskazówki do korzystania z okienka Form:

♦ Zmiana rozmiarów okienka nie powoduje zmiany rozmiarów obiektu Form

w tworzonym programie.

♦ Dwukrotne kliknięcie lewym klawiszem myszy przy zaznaczonym obiekcieForm lub innym, umiejscowionym na nim, powoduje wyświetlenie oknaCode w miejscu go dotyczą cym.

♦ Umiejscowienie obiektu Form na ekranie monitora podczas uruchomieniaprojektowanego programu pokazuje okienko Form Layout .

♦ Inne obiekty na obiekt Form nanosimy za pomocą myszy.

1.2.5. Form Layout

Okienko pokazują ce umiejscowienie obiektu (obiektów) Form na ekranie monitorapodczas uruchomienia projektowanego programu.

Możemy zmieniać to umiejscowienie poprzez przesunięcie obiektu w tym okienku(umieszczają c wcześniej nad nim wskaźnik myszy i jednocześnie przytrzymują c jejlewy przycisk).

Opcje dostępne po naciśnięciu prawego klawisza myszy (menu kontekstowe) w okienkuForm Layout :

Resolution Guides

Pokazuje umiejscowienie obiektu Form w tworzonej aplikacji dla innej rozdziel-czości monitora niż obecna. Będą jednak pokazane tylko rozdzielczości mniejszeod tej aktualnej.

Startup Position♦ manual — pozwala na ręczną modyfikację położenia obiektu Form,

♦ center owner — wyśrodkowuje obiekt MDIForm w poziomie i w pioniewzględem swego rodzica,




♦ center screen — wyśrodkowuje obiekt Form w poziomie i względem ekranu,

♦ windows default — ustawia obiekt Form w położeniu domyślnym.

Dockable

Umożliwia „dokowanie”, czyli wyrównywanie okienka Form Layout do którejś z we-wnętrznych krawędzi obszaru roboczego.

Hide

Powoduje zaprzestanie wyświetlania całego okienka.

Skutki tej operacji można odwrócić, wywołują c opcję Form Layout z menu View.

1.2.6. ImmediateOkienko wywoływane automatycznie podczas przejścia z trybu wykonywania ko-du w tryb przerwania.

Bezpośrednio po pojawieniu się jest puste i ma aktywny kursor. Można w nim wpisać (lubwkleić) fragment kodu i zaraz go uruchomić poprzez naciśnięcie klawisza ENTER. Kodwpisany za pośrednictwem tego okienka nie może zostać zapisany z jego poziomu wewłaściwym oknie kodu, lecz może zostać tam skopiowany poprzez schowek systemowy.

Za jego pomocą można np.:

1. wykonywać nowo wprowadzony kod,

2. przypisywać nowe wartości zmiennym,

3. zmieniać wartości właściwości.

1.2.7. LocalsWyświetla wszelkie zadeklarowane zmienne w bieżą cej procedurze wraz z ich warto-ściami. Okienko to w przypadku wywołania jest automatycznie aktualizowane przy




42

każdym przejściu ze stanu wykonywania programu do trybu przerwania i gdy zawar-tość stosu się zmienia.

Elementy okienka Locals:

♦ Calls Stack (przycisk — „...”) — otwiera listę z wywołanymi aktualne

procedurami,

♦ Expression — lista zawierają ca nazwy danych zmiennych — nie można ich

edytować,

♦ Value — lista zawierają ca nazwy danych zmiennych — można je edytowaćw przypadku podwójnego kliknięcia na danej wartości. Jeżeli wprowadzimy

wartość niepoprawną , pole pozostanie wciąż aktywne i pojawi się okienko,

opisują ce popełniony błą d,

Możemy się wycofać poprzez naciśnięcie klawisza ESC .

♦ Type — lista zawierają ca typy danych zmiennych — nie można ich edytować.




1.2.8. Object Browser

Okienko zawierają ce: metody, klasy, zdarzenia, właściwości i stałe dostępne dla ak-

tywnego projektu oraz ich opis i definicję.

Wybrane elementy okienka Object Browser :

♦ Lista rozwijalna Project/Library — zawiera biblioteki dostępne w aktywnym

projekcie,

♦ Lista rozwijalna Search Text — służy do wpisywania w nie tekstu bą dź jegopoczą tkowego fragmentu, który ma być wyszukany. Poza tym żą daną nazwę

można też wybrać z rozwijalnej listy,

♦ Go Back i Go Forward (przyciski — strzałka w lewo i w prawo) — Go Back

powoduje za każdym naciśnięciem powrót do poprzednio zaznaczonej

pozycji. Go Forward ma działanie odwrotne,

♦ Copy to Clipboard (przycisk) — kopiuje aktualnie zaznaczoną pozycję do

schowka systemowego,

♦ Show Definition (przycisk) — pokazuje miejsce definicji pozycji zaznaczonej

na liście w oknie kodu,

♦ Help (przycisk) — wyświetla temat pomocy dla zaznaczonej pozycji na liście,

♦ Search (przycisk) — rozpoczyna wyszukiwanie: właściwości, klas, zdarzeń,metod lub stałych w bibliotekach, pasują cych do tekstu wpisanego w oknie

Search Text ,




44

♦ Show/Hide Search Result (przycisk — dwie strzałki w górę) — otwiera lub

ukrywa okienko z alfabetycznie wypisanymi rezultatami wyszukiwania.

1.2.9. ProjectWyświetla zhierarchizowaną strukturę zawartości otwartego projektu (projektów), naktórą mogą składać się: formularze (*.frm), moduły (*.bas), moduły klas (*.cls),

dokumenty użytkownika (*.dob), strony właściwości (*.pag), dokumenty powią zane.

Funkcje przycisków okienka Project :

View Code — wyświetla okienko Code dla zaznaczonej pozycji

w oknie Project

View Object — wyświetla okienko Object dla zaznaczonej pozycji

w oknie Project . Funkcja dostępna tylko dla: formularza,modułu, obiektu ActiveX lub kontrolki użytkownika

Toggle Folders — pozwala pokazać lub ukryć katalogi, będą ce logicznym

pogrupowaniem zawartości okienka Project

1.2.10. PropertiesOkienko zawierają ce listę wszystkich właściwości, dostępnych dla zaznaczonegoobiektu wraz z ich ustawieniami, umożliwiają ce jednocześnie ich modyfikację.




W okienku rozwijalnym wymienione są wszystkie obiekty możliwe w danej chwili domodyfikacji. Wybierają c któryś z nich, powodujemy wyświetlenie wszelkich właściwości

z nim zwią zanych.

Listę właściwości możemy uporzą dkować alfabetycznie lub wg kategorii poprzez

użycie zakładek Alphabetic lub Categorized .

W części Caption wyświetlany jest krótki opis zaznaczonej właściwości. Opis tenmożna wyłą czyć, odznaczają c polecenie Description w menu kontekstowym okienka

Properties (dostępnym poprzez naciśnięcie prawego przycisku myszy, gdy jej wskaź-nik znajduje się nad nim).

1.2.11. ToolboxZawiera miniatury kontrolek Visual Basic, dostępnych w aktualnym projekcie. Opróczkontrolek standardowych do projektu można dokładać kontrolki własne lub inne dodat-

kowe, których lista dostępna jest przy użyciu polecenia Components z menu Project .




46

Polecenie to można tak że wywołać, naciskają c prawy przycisk myszy na oknie Tool-

box, zwanym menu podr ęcznym.

Za pomocą menu podręcznego można również:

♦ tworzyć nowe zakładki, oprócz standardowej zakładki General, które pozwolą pogrupować dostępne kontrolki wg indywidualnych potrzeb programisty po

wywołaniu opcji Add Tab. Każda stworzona zakładka będzie wyróżniona,

podobnie jak zakładka standardowa,

♦ dokładać kontrolki własne lub inne dodatkowe do zakładki standardowej lubdo zakładek stworzonych przez siebie, przy użyciu polecenia Components,

♦ ukryć całe okno przy użyciu opcji Hide, przez co zwiększymy wielkość

obszaru roboczego środowiska programistycznego VB. Operację tę można

odwrócić, wywołują c opcję Toolbox z menu View,

♦ umożliwić „dokowanie”, czyli wyrównywanie do którejś z wewnętrznych

krawędzi obszaru roboczego. Okno po przesunięciu będzie ulegało„dokowaniu”, gdy opcja Dockable będzie włą czona.

Po najechaniu kursorem myszy i przytrzymaniu go przez chwilę na którejś z miniatu-rek kontrolki w oknie Toolbox pojawia się nazwa danej kontrolki. O tym, czy te pod-

powiedzi będą wyświetlane, czy też nie, decyduje opcja Show ToolTips na zakładce

General polecenia Options w pozycji menu głównego programu Tools.




1.2.12. Watch

Okienko pojawiają ce się w przypadku zdefiniowania wyrażenia Watch w projekcie.

Elementy okienka Watches:

♦ Expression — lista wyrażeń Watch w projekcie,

♦ Value — lista wartości wyrażeń w momencie przejścia w tryb przerwania.

Można je w tym miejscu edytować. Jeżeli wprowadzimy wartość niepoprawną ,

pole pozostanie wciąż aktywne i pojawi się okienko, opisują ce popełniony błą d,

Wycofać się możemy poprzez naciśnięcie klawisza ESC .

♦ Type — lista typów wyrażeń,

♦ Context — lista zawartości wyrażeń Watch.



47

Rozdział 2.

Podstawyprogramowania w VB

Czy zdarzyło się Wam kiedyś, że zapomnieliście nazwy lub składni jakiejś funkcji lubinstrukcji? Na pewno tak! Rozdział ten jest właśnie takim „przypominaczem”, któryzawiera wszystkie funkcje i instrukcje dostępne w języku Visual Basic.

Ponadto prawdziwy programista nigdy nie ogranicza się do znajomości tylko i wyłą cz-nie jednego języka programowania — a pamięć, jak wiadomo, bywa czasami zawodna.

2.1. Instrukcje sterują ce

2.1.1. DoDo While

Wykonuje blok instrukcji tak długo, jak długo warunek pętli będzie spełniony.

Składnia:

Do While (Warunek)Blok instrukcji

Loop

Blok instrukcji może nie zostać wykonany w przypadku, gdy zadany warunek nigdynie będzie spełniony.

Przykład:

Do While zmienna1 > 52

Zmienna2 = 0Loop




48

Do Loop While

Wykonuje blok instrukcji, dopóki warunek pętli będzie prawdziwy.

Składnia:Do

Blok instrukcji

Loop While (Warunek)

Blok instrukcji musi zostać wykonany przynajmniej raz, ponieważ pętla zakłada, że

w pierwszym przebiegu warunek jest spełniony.

Przykład:

Do

komunikat = "Podaj liczbę od 24 do 2354"

licznik = licznik + 1

Loop While licznik = 12

Do Until

Wykonuje blok instrukcji tak długo, dopóki warunek pętli nie będzie spełniony.

Składnia:

Do Until (Warunek)

Blok instrukcji

Loop

Blok instrukcji może nie zostać wykonany w przypadku, gdy zadany warunek będziespełniony.

Przykład:Do Until liczba <= 15

komunikat = "Wprowadzona liczba jest większa niż 15"

Loop

Do Loop Until

Wykonuje blok instrukcji, dopóki warunek pętli okaże się prawdziwy.

Składnia:

Do

Blok instrukcji

Loop Until (Warunek)

Blok instrukcji musi zostać wykonany przynajmniej raz, ponieważ pętla zakłada, żew pierwszym przebiegu warunek nie jest spełniony.



Rozdział 2. ♦♦♦♦ Podstawy programowania w VB 49

49

Przykład:

Do

komunikat = "Wpisz liczbę mniejszą niż 24"

Loop Until liczba = 26

Exit Do

Instrukcja pozwalają ca na natychmiastowe przerwanie działania dowolnej pętli Do,bez względu na prawdziwość zadanego warunku.

Przykład 1.:

Do

intLiczba=InputBox("Podaj liczbę całkowitą",Wprowadź liczbę")

if (intLiczba=intStala) Then

Exit Do

End If

sngWynik=1/(intStala-intLiczba)

intWiadomosc=MsgBox(sngWynik)

Loop While (intLiczba>0)

Przykład 2.:

Do

komunikat = "Podaj liczbę od 24 do 2354"

licznik = licznik + 1

if licznik = 13 then

Exit Do

End if

Loop While licznik = 12

2.1.2. For

For

Pozwala na powtarzanie bloku instrukcji zadaną liczbę razy.

Składnia:

For Licznik = WartośćPoczątkowa To WartośćKońcowa [Step Krok]Blok instrukcji

Next [Licznik]

gdzie:

♦ Licznik — musi być zmienną , więc specjalnie dla potrzeb pętli For trzeba

ją zadeklarować (najlepiej typu Integer). Jest ona wykorzystywana przez

pętlę jako licznik powtórzeń,

♦ WartośćPoczątkowa — liczba całkowita, wyrażenie lub zmienna

określają ca począ tek odliczania,




50

♦ WartośćKońcowa — liczba całkowita, wyrażenie lub zmienna

określają ca koniec odliczania,

♦ Krok (opcja) — liczba całkowita, wyrażenie lub zmienna określają ca wartośćskokową , wykorzystywaną przez pętlę do odliczania od wartości począ tkowej

do końcowej.

Przykład:

For Pomocnicza = 1 To 100 Step 5

Zmienna1 = Zmienna2 + Pomocnicza

Next Pomocnicza

Exit For

Instrukcja pozwalają ca na natychmiastowe przerwanie działania dowolnej pętli For,

bez względu na dotychczasowy stan wykonania pętli.

Przykład:For Pomocnicza = 1 To 100 Step 5

If Zmienna1 >= 250 Then

Exit For

End If

Zmienna1 = Zmienna2 + Pomocnicza Next Pomocnicza

2.1.3. If

If

Wykonuje określony blok instrukcji w przypadku, gdy zadany warunek b ędziespełniony.

Składnia:

If Warunek Then

Blok instrukcji

End If

Przykład:

If Zmienna1 > Zmiennej2 Then

Zmienna1 = Zmienna1 + 154

End If

If Else

W przypadku spełnienia warunku określonego po słowie kluczowym If wykonany

zostanie blok instrukcji po słowie Else.




51

Składnia instrukcji:

If Warunek Then

Blok instrukcji

Else

Blok instrukcji

End If

Przykład:

If Zmienna = 5 Then

komunikat = MsgBox("Wprowadzona liczba to 5!!!")

Else

komunikat = MsgBox("Wprowadzona liczba jest różna od 5!!!")

End If

If ElseIf

Pozwala na sprawdzanie wielu warunków oprócz pierwszego If. W przypadku speł-

nienia warunku określonego po nim zostaną sprawdzone wszystkie warunki po kolej-

nych słowach ElseIf. Wykonany może być jednak tylko jeden blok instrukcji, wy-stępują cy po odpowiadają cym mu słowie If, ElseIf lub Else. Sprawdzanych

warunków może być wiele.

Składnia:

If Warunek1 Then

Blok instrukcji

ElseIf Warunek2 Then

Blok instrukcji

ElseIf Warunek3 Then

Blok instrukcji

Else

Blok instrukcji

End If

Przykład:

If Zmienna = 5 Then

komunikat = MsgBox("Wprowadzona liczba to 5!!!")ElseIf Zmienna = 10 Then

komunikat = MsgBox("Wprowadzona liczba to 10!!!")ElseIf Zmienna = 12 Then

komunikat = MsgBox("Wprowadzona liczba to 12!!!")Else

komunikat = MsgBox("Wprowadzona liczba nie jest mi znana!!!")End If

TypeOf

Sprawdzenie typu podanego obiektu.




52

Składnia:

TypeOf NazwaObiektu Is TypObiektu.

Przykład:

If TypeOf NowaKontrolka Is CheckBox Then

Komunikat = MsgBox("Obiekt typu CheckBox!!!")

Else

Komunikat = MsgBox("Obiekt nie jest typu CheckBox!!!")

'gdy dany obiekt będzie typu CheckBox, zostanie wyświetlony

komunikat

End If

2.1.4. Select Case

Select Case

Instrukcja sprawdza wartość podanego wyrażenia i wybiera jeden odpowiedni blokkodu do wykonania. Sprawdzanych warunków może być wiele.

Składnia:

Select Case WyrażenieCase Wartość1 Blok instrukcji

Case Wartość2 Blok instrukcji

Case Wartość3 Blok instrukcji

Case Else

Blok instrukcji

End Select

Przykład:

Select Case Marza

Case 11

Komunikat = MsgBox("Twój zarobek będzie słabiutki")Case 34

Komunikat = MsgBox("Twój zarobek będzie całkiem dobry")Case 100

Komunikat = MsgBox("Twój zarobek bardzo dobry")Case Else

Komunikat = MsgBox("Mam zbyt mało RAM-u!!!")End Select

Select Case Case Is

Instrukcja sprawdza prawdziwość różnych relacji, zachodzą cych pomiędzy podanymwyrażeniem a wartością , i w zależności od wyniku wybiera jeden odpowiedni blok

kodu do wykonania. Sprawdzanych relacji może być wiele.




53

Składnia:

Select Case WyrażenieCase Is Relacja1

Blok instrukcji

Case Is Relacja2

Blok instrukcjiCase Is Relacja3

Blok instrukcji

Case Else

Blok instrukcji

End Select

Przykład:

Select Case Kwota

Case Is <= 800

Komunikat = MsgBox("Lepiej zmień pracę!!!")

Case Is > 800, Is <= 1500

Komunikat = MsgBox("Słabe te Twoje zarobki")

Case Is > 1500, Is <= 2000

Komunikat = MsgBox("Może być, ale powinieneś mieć więcej")

Case ElseKomunikat = MsgBox("Ile by nie płacili — zawsze będzie mało")

End Select

Select Case Case To

Instrukcja sprawdza prawdziwość różnych przedziałów podanych po słowie kluczo-

wym Case i w zależności od wyniku wybiera jeden odpowiedni blok kodu do wyko-

nania. Sprawdzanych warunków może być wiele.

Składnia:

Select Case WyrażenieCase Wartość1a To Wartość1b

Blok instrukcjiCase Wartość2a To Wartość2b Blok instrukcji

Case Else

Blok instrukcji

End Select

Przykład:

Select Case Wiek

Case 1 To 2

Komunikat = MsgBox("Jesteś jeszcze bardzo malutki")Case 3 To 13

Komunikat = MsgBox("Jesteś jeszcze dzieckiem")Case 14 To 18

Komunikat = MsgBox("Należysz do młodzieży")

Case ElseKomunikat = MsgBox("Jesteś już dorosły — zarabiaj na siebie")

End Select




54

2.2. Funkcje wbudowane

2.2.1. Daty i czasu

2.2.1.1. Date

Funkcja Date zwraca wartość typu Variant (Date), zawierają cą aktualną datę systemo-

wą .

Składnia:

Date

Przykład:

BiezacaData = Date ' zmiennej BiezacaData przypisana zostaje data

systemowa (bieżąca)

2.2.1.2. DateAdd

Funkcja DateAdd zwraca wartość typu Variant (Date), zawierają cą datę powstałą poprzez odjęcie lub dodanie określonego przedziału czasowego do podanej daty.

Składnia:

DateAdd (TypOkresu, LiczbaJednostek, Data)

gdzie:

♦ TypOkresu (wymagane) — rodzaj dodawanego lub odejmowanegoprzedziału czasowego,

Wartość Opis

yyyy rok

q kwartał

m miesią c

y dzień roku

d dzień

w dzień tygodnia

ww tydzień

h godzina

n minuta




55

s sekunda

♦ LiczbaJednostek (wymagane) — wartość liczbowa określają ca liczbędodawanych lub odejmowanych przedziałów czasowych. Wartość ta może

być zarówno dodatnia, jak i ujemna. Dodatnia oznacza dodanie podanych jednostek czasu do daty bazowej, ujemna — odjęcie ich od niej,

♦ Data (wymagany) — wyrażenie typu Variant (Date) lub literał, któryokreśla datę, na której wykonana ma zostać operacja.

Przykład 1.:

Zmienna01 = DateAdd ("m",5,"20-12-2001")

'do daty 12-12-2001 dodanych zostanie 5 miesięcy, czego

'wynikiem będzie 20-05-2002

Przykład 2.:

Zmienna01 = DateAdd ("d",5,Zmienna01)

'do daty zapamiętanej pod Zmienna01 dodanych zostanie

'5 dni miesięcy, czego wynikiem będzie 25-05-2002

2.2.1.3. DateDiff

Funkcja DateDiff zwraca wartość typu Variant (Long), która określa liczbę okre-ślonych przedziałów czasowych między dwiema podanymi datami.

Składnia:

DateDiff(TypOkresu, Data1, Data2 [, PierwszyDzieńTygodnia [,PierwszyTydzieńRoku])

gdzie:

♦ TypOkresu (wymagany) — rodzaj wyliczanych przedziałów czasowych(patrz 2.2.1.2),

♦ Data1, Data2 (wymagany) — wyrażenia typu Variant (Date) określają cedaty wykorzystywane do obliczeń,

♦ PierwszyDzieńTygodnia (opcja) — stała, która określa pierwszy dzieńtygodnia — gdy nie zostanie określona, domyślnie przyjmowana jestniedziela,

Stała Wartość Opis

vbUseSystem 0 użyj ustawień NLS API

vbSunday 1 niedziela (domyślna)

vbMonday 2 poniedziałek

vbTuesday 3 wtorek

vbWednesday 4 środa




56

vbThursday 5 czwartek

vbFriday 6 pią tek

vbSaturday 7 sobota

♦ PierwszyTydzieńRoku (opcja) — stała, która określa pierwszy tydzieńroku — gdy nie zostanie określona, domyślnie przyjmowany jest tydzień,w którym jest 1 stycznia,


vbUseSystem 0 użyj ustawień NLS API

vbFirstJan 1 tydzień zawierają cy 1 stycznia (domyślnie)

vbFirstFourDay

s2 pierwszy tydzień, w którym są co najmniej cztery dni nowego roku

vbFirstFullWeek

2 pierwszy pełny tydzień nowego roku

Przykład:

DataBiezaca = Date 'przypisanie zmiennej, bieżącej daty

DataUzytkownika = InputBox("Wprowadź datę...")'użytkownik wpisuje wymyśloną przez siebie datęPrzedzialy = DateDiff("d", DataBiezaca, DataUzytkownika)

'wyliczenie liczby dni występujących między dwoma datami, określonymizmiennymi

W przypadku gdy podana przez użytkownika data będzie wyższa, obliczona wartośćbędzie ujemna.

2.2.1.4. DatePart

Funkcja DatePart zwraca wartość typu Variant lub Integer, określają cą liczbęwystą pień określonego okresu czasu do podanej daty.

Składnia:

DatePart(TypOkresu, Data [,PierwszyDzieńTygodnia [,PierwszyTydzieńRoku])

gdzie:

♦ TypOkresu (wymagany) — rodzaj wyliczanych przedziałów czasowych(patrz 2.2.1.2),

♦ Data (wymagane) — wyrażenie typu Variant (Date), określają ce datęwykorzystywaną do obliczeń,

♦ PierwszyDzieńTygodnia (opcja) — stała, która określa pierwszy dzieńtygodnia (patrz 2.2.1.3) — gdy nie zostanie określona, domyślnieprzyjmowana jest niedziela,




57

♦ PierwszyTydzieńRoku (opcja) — stała, która określa pierwszy tydzieńroku (patrz 2.2.1.3) — gdy nie zostanie określona, domyślnie przyjmowany jest tydzień, w którym jest 1 stycznia.

Przykład 1.:

DataBiezaca = Date 'przypisanie zmiennej, bieżącej datykomunikat = DatePart("q", DataBiezaca)

'przypisanie zmiennej numeru bieżącego kwartału w roku

Przykład 2.:

DataBiezaca = Date 'przypisanie zmiennej, bieżącej daty

komunikat = DatePart("ww", DataBiezaca)

'przypisanie zmiennej numeru bieżącego tygodnia w roku

2.2.1.5. DateSerial

Funkcja DateSerial zwraca wartość typu Variant lub Date, określają cą datę, bę-

dą cą odpowiednikiem trzech podanych wartości liczbowych.

Składnia:

DateSerial(rok, miesiąc, dzień)

♦ rok (wymagany) — liczba będą ca odpowiednikiem roku (zakres od 100do 9999),

♦ miesiąc (wymagany) — liczba będą ca odpowiednikiem miesią ca (zakres

od 1 do 12),

♦ dzień (wymagany) — liczba będą ca odpowiednikiem dnia (zakres

od 1 do 31).

Przykład:komunikat = DateSerial(2006, 6 , 11)

' przypisanie zmiennej daty 11 czerwca 2006

2.2.1.6. DateValue

Funkcja DateValue zwraca wartość typu Variant lub Date z wyrażenia reprezen-

tują cego datę.

Składnia:

DateValue(Data)

Przykład:Dim varData As Variant

Komunikat = DateValue("1999-11-25")

'Przypisanie zmiennej, wartości liczbowej podanej daty




58

2.2.1.7. Day

Funkcja Day zwraca wartość typu Variant lub Integer z liczbą z przedziału 1 –

31, określają cą numer dnia miesią ca podanej daty.

Składnia:

Day(Data)

gdzie:

♦ Data (wymagany) — wyrażenie numeryczne lub zmienna reprezentują ca datę.

Przykład:

Komunikat = Day("2001-03-23")

'zmienna przyjmie wartość 23

2.2.1.8. Format

(patrz również 2.2.5.1)

Funkcja Format zwraca wartość typu Variant lub String, sformatowaną zgodnie z

podanymi instrukcjami.

Składnia:

Format (Wyrażenie[, Format [, PierwszyDzieńTygodnia [,PierwszyTydzieńRoku]]])

gdzie:

♦ Wyrażenie (wymagany) — jakiekolwiek poprawne wyrażenie,

♦ Format (opcja) — nazwa lub zdefiniowane przez użytkownika wyrażenie

formatują ce,

♦ PierwszyDzieńTygodnia (opcja) — wartość określają ca pierwszydzień tygodnia (patrz 2.2.1.3),

♦ PierwszyTydzieńRoku (opcja) — wartość określają ca pierwszy tydzień roku(patrz 2.2.1.3).

Zdefiniowane nazwy formatów daty i czasu:

Nazwa formatu Opis

General Date

Wyświetla datę i (lub) czas, np. 25/12/99 05:58 AM . Jeżeli nie podamy częściułamkowej, wyświetla tylko datę, np. 25/12/99, Jeśli zaś brakuje części całkowitej

— wyświetla tylko czas, np. 05:58 AM . Wyświetlanie określone jest ustawieniami

systemu

Long Date Wyświetla datę wg formatu długiej daty, ustawionego przez system




60

n Wyświetla minuty jako liczbę bez zera na począ tku (od 0 do 59)

nn Wyświetla minuty jako liczbę z zerem na począ tku (od 00 do 59)

s Wyświetla sekundy jako liczbę bez zera na począ tku (od 0 do 59)

nn Wyświetla sekundy jako liczbę z zerem na począ tku (od 00 do 59)

Znak Opis

ttttt Wyświetla czas jako kompletny czas (godzina, minuta, sekunda) przy użyciu separatorów

czasu zdefiniowanych przez system (najczęściej h:mm:ss). Począ tkowe zera wyświetlane

są w przypadku wcześniejszego ustawienia tej opcji

AM/PM Wyświetla czas w formacie 12-godzinnym, używają c dużych liter „AM” i „PM”

am/pm Wyświetla czas w formacie 12-godzinnym, używają c małych liter „am” i „pm”

A/P Wyświetla czas w formacie 12-godzinnym, używają c dużych liter „A” i „P”

a/p Wyświetla czas w formacie 12-godzinnym, używają c małych liter „am” i „pm”

Przykład 1.:

Komunikat = Format(Time, "Long Time")

'zmienna przyjmuje wartość bieżącego czasu w formacie "długiego

czasu"

Przykład 2.:

Komunikat = Format(Date, "Short Date")

'zmienna przyjmuje wartość bieżącej daty w formacie "krótkiej daty

systemowej"

2.2.1.9. Hour

Funkcja Hour zwraca wartość liczbową typu Variant lub Integer z zakresu od 0 do

23, określają cą numer godziny w podanym czasie.

Składnia:

Hour(Czas)

gdzie:

♦ Czas (wymagany) — wyrażenie numeryczne lub zmienna reprezentują ca czas.

Przykład:

Komunikat = Day("22:53:29")





61

2.2.1.10. Minute

Funkcja Minute zwraca wartość liczbową typu Variant lub Integer z zakresu od 0 do

59, określają cą numer minuty w podanym czasie.

Składnia:

Minute(Czas)

gdzie:


Przykład:

Komunikat = Minute("22:53:29")


2.2.1.11. Month

Funkcja Month zwraca wartość liczbową typu Variant lub Integer z zakresu od 1 do

12, określają cą numer miesią ca w podanej dacie.

Składnia:

Month(Data)

gdzie:

♦ Date (wymagany) — wyrażenie numeryczne lub zmienna reprezentują ca datę.

Przykład:

Komunikat = Month("98, Sty 30")'zmienna przyjmie wartość 1

2.2.1.12. Now

Funkcja Now zwraca wartość liczbową typu Variant lub Date, będą cą aktualną datą i czasem systemowym, zgodną z formatem systemowym daty i czasu.

Składnia:

Now

Przykład:

Komunikat = Now'zmienna przyjmie wartość zgodną ze wskazaniem aktualnej

'daty i czasu systemowego w domyślnym formacie




62

2.2.1.13. Second

Funkcja Second zwraca wartość liczbową typu Variant lub Integer z zakresu od 0 do

59, określają cą numer sekundy w podanym czasie.

Składnia:

Second (Czas)

gdzie:


Przykład:

Komunikat = Minute("22:53:29")


2.2.1.14. Time

Funkcja Now zwraca wartość liczbową typu Variant lub Date, będą cą aktualnym

czasem systemowym zgodnym z formatem systemowym czasu.

Składnia:

Time

Przykład:

Komunikat = Time

'zmienna przyjmie wartość zgodną ze wskazaniem aktualnego

'czasu systemowego w domyślnym formacie

2.2.1.15. Timer

Funkcja Timer zwraca wartość typu Single, określają cą liczbę sekund, które upły-nęły od północy.

Składnia:

Timer

Przykład:

Komunikat = Timer

'przy założeniu, że obecnie jest np. godz. O:59,


2.2.1.16. TimeSerial

Funkcja TimeSerial zwraca wartość typu Variant lub Time, będą cą określeniem

czasu i złożeniem trzech podanych wartości liczbowych.




63

Składnia:

TimeSerial(godzina, minuta, sekunda)

gdzie:

♦ godzina (wymagany) — liczba typu Integer z zakresu 0 do 23reprezentują ca godzinę,

♦ minuta (wymagany) — liczba typu Integer z zakresu 0 do 59reprezentują ca minutę,

♦ sekunda (wymagany) — liczba typu Integer z zakresu 0 do 59reprezentują ca sekundę.

Przykład:

Komunikat = TimeSerial(12, 54, 27)

'zmienna przyjmie wartość w formacie czasu; "12:54:27"

2.2.1.17. TimeValue

Funkcja TimeValue zwraca wartość typu Variant lub Date, zawierają cą czas.

Składnia:

TimeValue(Czas)

gdzie:

♦ Czas (wymagany) — wyrażenie numeryczne lub zmienna reprezentują ca

czas. Można stosować zarówno 12-, jak i 24-godzinny zapis, np. "1:06PM"

lub "13:06". Jednocześnie argument ten może zawierać informację o dacie

(zmienna) — funkcja nie zwróci ich, jeżeli jednak będą niepoprawne,

to wystą pi błą d.

Przykład:

Komunikat = TimeValue("1:23:17 PM")

2.2.1.18. Weekday

Funkcja Weekday zwraca wartość typu Variant lub Integer, określają cą numer

dnia tygodnia podanej daty.

Składnia:

Weekday(Data [,PierwszyDzieńTygodnia])

gdzie:

♦ Data (wymagany) — wyrażenie numeryczne lub zmienna reprezentują ca datę,




64

♦ PierwszyDzieńTygodnia (opcja) — wartość określają ca pierwszy dzieńtygodnia (patrz 2.2.1.3).

Wartości zwracane przez funkcję Weekday:


vbSunday 1 niedziela (domyślnie)

vbMonday 2 poniedziałek

vbTuesday 3 wtorek

vbWednesday 4 środa


vbThursday 5 czwartek

vbFriday 6 pią tek

vbSaturday 7 sobota

Przykład:

Komunikat = Weekday("2001, Marzec 26")

'zmienna przyjmie wartość 2 — poniedziałek,

2.2.1.19. Year

Funkcja Year zwraca wartość typu Variant lub Integer z liczbą , określają cą nu-

mer roku podanej daty.

Składnia:Year(Data)

gdzie:

♦ Data (wymagany) — wyrażenie numeryczne lub zmienna reprezentują ca datę.

Przykład:

Komunikat = Month("98, Sty 30")


2.2.2. Konwertują ce

2.2.2.1. Array

Funkcja Array zwraca wartość typu Variant, zawierają cą tablicę.




65

Składnia:

Array(ListaArgumentów )

gdzie:

♦ ListaArgumentów (wymagany) — lista wartości, oddzielonych odsiebie przecinkami, które mają wypełnić tablicę zawartą w typie Variant.

Jeżeli nie zostanie podana lista argumentów, zostanie stworzona tablica o

zerowej długości.

Aby odwołać się do konkretnego elementu tablicy, trzeba podać nazwę zmiennej re-prezentują cej tablicę i indeks reprezentują cy ten element (w nawiasie). Trzeba przy

tym pamiętać, że elementy tablic w języku Visual Basic indeksowane są od 0.

Przykład:

Dim Element As Variant, ZmiennaZTablicy As Variant

ZmiennaTablicy = Array("Pn","Wt","Sr","Cz","Pt","So","Ni")

Element = ZmiennaZTablicy(2)

'zmienna "Element", przyjmuje wartość elementu'tablicy o indeksie 2, czyli "Sr"

2.2.2.2. Oct

Funkcja Oct zwraca wartość typu String, będą cą oktagonalnym (czyli ósemkowym)

zapisem wprowadzonej jako parametr wartości.

Składnia:

Oct(Wartość)

gdzie:

♦ Wartość (wymagany) — dowolne wyrażenie numeryczne lub łańcuchowe.

Jeżeli zdarzyłoby się, że wprowadzona jako parametr wartość nie jest poprawną licz-bą , zostanie ona zaokrą glona do najbliższej poprawnej liczby.

Liczb oktagonalnych można również używać bezpośrednio w kodzie programu, po-przedzają c je znakami „&O”, np.: &O713 (reprezentuje dziesiętną liczbę 459).

Wartości zwracane przez funkcję Oct:

Wartość Zwracana wartość

Null null

Empty zero (0)

Inna wartość do 11 znaków oktagonalnych




66

Przykład:

Dim zm1 As Variantzm1 = Oct(4) 'zmienna "zm1" przyjmuje wartość 4

zm1 = Oct(8) 'zmienna "zm1" przyjmuje wartość 10

zm1 = Oct(459) 'zmienna "zm1" przyjmuje wartość 713

2.2.2.3. Hex

Funkcja Hex zwraca wartość typu String, będą cą heksadecymalnym (czyli szesnast-

kowym) zapisem wprowadzonej jako parametr wartości.

Składnia:

Hex(Wartość)

gdzie:

♦ Wartość (wymagany) — dowolne wyrażenie numeryczne lub łańcuchowe.

Jeżeli zdarzyłoby się, że wprowadzona jako parametr wartość nie jest poprawną licz-bą , zostanie ona zaokrą glona do najbliższej poprawnej liczby.

Liczb oktagonalnych, można również używać bezpośrednio w kodzie programu, po-

przedzają c liczbę znakami „&H”, np.: &HA (reprezentuje dziesiętną liczbę 10).

Wartości zwracane przez funkcję:

Wartość Zwracana wartość

Null null

Empty zero (0)

Inna wartość do 11 znaków oktagonalnych

Przykład:

Dim zm1 As Variantzm1 = Hex(5) 'zmienna "zm1" przyjmuje wartość 5

zm1 = Hex(10) 'zmienna "zm1" przyjmuje wartość A

zm1 = Hex(459) 'zmienna "zm1" przyjmuje wartość 1CB

2.2.2.4. CBool

Funkcja CBool konwertuje wprowadzone wyrażenie na typ Boolean.

Składnia:CBool(Wyrażenie)

gdzie:




67

♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne lub

łańcuchowe.

Przykład:

zmiennaA=5zmiennaB=5

wynik=CBool(zmiennaA=zmiennaB)

'zmienna "wynik" przyjmuje wartość TRUE,

'ponieważ wyrażenie jest prawdziwe

zmiennaA=0wynik=CBool(zmiennaA)

'zmienna "wynik" przyjmuje wartość FALSE

2.2.2.5. CByte

Funkcja CByte konwertuje wprowadzone wyrażenie na typ Byte.

Składnia:CByte(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne z zakresu 0 – 255.

Przykład:

zmA=245.5643varByte=CByte(varDouble)

'zmienna "zmA" przyjmuje wartość 245

2.2.2.6. CCur

Funkcja CCur konwertuje wprowadzone wyrażenie na typ Currency.

Składnia:

CCur(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne z zakresu–922 337 203 685 477,5808 – 922 337 203 685 477,5807.

Przykład:

zmA=156.12129zmB=CCur(zmA*2)

'po konwersji wyniku wyrażenia zmA*2 (312.24258)'do typu zmienna zmB przyjmuje wartość 312.2426




68

2.2.2.7. Cdate (CVDate)

Funkcja CDate (CVDate) konwertuje wprowadzone wyrażenie na typ Date.

Składnia:CDate(Wyrażenie)

lub

CVDate(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne lub łańcuchoweokreślają ce poprawną datę.

Aby określić, czy stosowane wyrażenie może być przekonwertowane na datę lub

czas, należy wcześniej użyć testują cej funkcji IsDate (patrz 2.2.6.5).

Przykład:

zmA="1969, Luty 12" 'podstawienie daty

zmC=CDate(zmA) 'konwersja do typu Data

zmB="4:35:47" 'podstawienie czasuzmC=CDate(zmB) 'konwersja do typu Data

2.2.2.8. CDbl

Funkcja CDbl konwertuje wprowadzone wyrażenie na typ Double.

Składnia:

CDbl(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne w zakresie–1,79769313486232E308 do –4,94065645841247E-324 dla wartości

ujemnych oraz 4,94065645841247E-324 do 1,79769313486232E308

dla wartości dodatnich.

Przykład:

zmA= 156.12129

zmB=CDbl(zmA*2)

'konwersja wyniku wyrażenia na typ Double

2.2.2.9. CDec

Funkcja CDec zawsze zwraca typ Variant, którego wartość może być następnie

przekonwertowana do podtypu Decimal.




69

Składnia:

CDec(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne w zakresie+/– 79 228 162 514 264 337 593 543 950 335 dla liczb bez miejscdziesiętnych.

Dla liczb z 28 miejscami dziesiętnymi: +/–7,9228162514264337593543950335.

Najmniejsza liczba niezerowa: 0,0000000000000000000000000001.

Przykład:

zmA= 156.12129

zmB=CDec(zmA*2)

'konwersja wyniku wyrażenia na typ Decimal

2.2.2.10. CInt

Funkcja CInt konwertuje wprowadzone wyrażenie na typ Integer.

Składnia:

CInt(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne w zakresie32,768 do 32,767 (część ułamkowa zostaje zaokrą glona, w przypadku0,5 — zawsze „w dół”).

Przykład:

zmA= 12,5zmB=CDbl(zmA+3)

'konwersja wyniku wyrażenia na typ Integer

2.2.2.11. CLng

Funkcja CLng konwertuje wprowadzone wyrażenie na typ Long.

Składnia:

CLng(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyra

żenie numeryczne w zakresie–2 147 483 648 do 2 147 483 647 (część ułamkowa zostaje zaokrą glona,

w przypadku 0,5 — zawsze „w dół”).




70

Przykład:

zmA= 123.5zmB=CDbl(zmA+45)

'konwersja wyniku wyrażenia na typ Long

2.2.2.12. CSng

Funkcja CSng konwertuje wprowadzone wyrażenie na typ Single.

Składnia:

CSng(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne w zakresie–3,402823E38 do –1,401298E-45 dla wartości ujemnych, 1,401298E-45do 3,402823E38 dla wartości dodatnich.

Przykład:

zmA= 312.365zmB=CSng(zmA/5)

'konwersja wyniku wyrażenia na typ Single

2.2.2.13. CStr

Funkcja CStr konwertuje wprowadzone wyrażenie na typ String.

Składnia:

CStr(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne lub

łańcuchowe.

Wartości zwracane przez funkcję CStr:

Wyrażenie Wartość zwracana

Boolean łańcuch zawierają cy True lub False

Datełańcuch zawierają cy datę w krótkim formacie zgodnym z ustawieniami

systemowymi

Nullbłą d (run-time)

Empty (pusty) łańcuch zerowej długości ("")

Error (błą d) słowo Error poprzedzone numerem błędu




72

Składnia:

Atn(Wartość)

gdzie:

♦ Wartość (wymagany) — typu Double lub dowolne wyrażenie numeryczne.

Zakres wyników funkcji Atn jest od –π /2 do π /2 radianów (gdzie π jest stałą matema-

tyczną o wartości 3,1415926535897932).

Przykład:

zmA= Atn(36)

'arcus tangens z liczby 36

2.2.3.3. Cos

Funkcja Cos zwraca wartość funkcji cosinus podanego k ą ta.

Składnia:

Cos(Wartość)

gdzie:

♦ Wartość (wymagany) — typu Double lub dowolne wyrażenie numeryczne

określają ce k ą t w radianach.

Zakres wyników funkcji Cos: od –1 do 1.

Przykład:

zmA=Cos(25)

'cosinus z liczby 25

2.2.3.4. Exp

Funkcja Exp zwraca wartość stałej e (podstawy logarytmu naturalnego) podniesionej

do podanej potęgi. Zwracana wartość jest typu Double.

Składnia:

Exp(Potęga)

gdzie:

♦

Potęga (wymagany) — typu Double lub dowolne wyrażenie numeryczneokreślają ce k ą t w radianach.




73

Przykład:

zmA=Exp(5)

'podniesienie stałej „e” do potęgi 5

2.2.3.5. Fix

Funkcja Fix zwraca część całkowitą podanej liczby.

Składnia:

Fix(Wartość)

gdzie:


Funkcja Fix zwraca najbliższą liczbę całkowitą mniejszą (lub równą ) od podanej w przy-

padku liczb dodatnich. W przypadku liczb ujemnych zwraca najbliższą liczbę całkowitą

większą (lub równą ) od podanej.

Przykład:

zmB=Fix (96.8) 'zmienna przyjmuje wartość 96

zmC=Fix(-89.6) 'zmienna przyjmuje wartość -90

2.2.3.6. Int

Funkcja Int zwraca część całkowitą podanej liczby.

Składnia:

Int(Wartość)

gdzie:


Funkcja Int zwraca najbliższą liczbę całkowitą mniejszą (lub równą ) od podanej

w przypadku liczb dodatnich. W przypadku liczb ujemnych zwraca najbliższą liczbęcałkowitą mniejszą (lub równą ) od podanej.

Przykład:

zmB=Fix (96.8) 'zmienna przyjmuje wartość 96

zmC=Fix(-89.6) 'zmienna przyjmuje wartość –89

2.2.3.7. Log

Funkcja Log zwraca wartość logarytmu naturalnego podanej liczby typu Double.




74

Składnia:

Log(Wartość)

gdzie:

♦ Wartość (wymagany) — typu Double lub dowolne wyrażenie numeryczne>0.

Przykład:

Dim varLiczba As Variant

zmA=Log(10)

'logarytm z 10

2.2.3.8. Rnd

Funkcja Rnd zwraca liczbę pseudolosową typu Single.

Składnia:Rnd [(Wartość)]

gdzie:

♦ Wartość (opcja) — typu Single lub dowolne wyrażenie numeryczne.


Wartość wejściowa Zwracana wartość

Mniejsza niż zero ta sama wartość za każdym razem (wartość wejściowa używana jako

podstawa generatora liczb losowych)

Równa zero najczęściej generowana liczba

Większa niż zero następna liczba losowa w sekwencji

Nieokreślona następna liczba losowa w sekwencji

Funkcja Rnd zwraca wartość mniejszą niż 1 i większą lub równą 0.

Przykład:

zmA=Int((7*Rnd)+1)

'wygenerowanie liczby losowej z zakresu 1-7

2.2.3.9. Sgn

Funkcja Sgn zwraca wartość typu Integer, określają cą znak podanej wartości.




75

Składnia:

Sgn(Wartość)

gdzie:

♦ Wartość (wymagany) — dowolne wyrażenie numeryczne.


Wartość wejściowa Zwracana wartość

Większa niż zero 1

Równa zero 0

Mniejsza niż zero –1

Przykład:

zmA=Sgn(15) 'zmienna przyjmuje wartość 1

zmB=Sgn(0) 'zmienna przyjmuje wartość 0

zmC=Sgn(-23) 'zmienna przyjmuje wartość -1

2.2.3.10. Sin

Funkcja Sin zwraca wartość funkcji sinus podanego k ą ta.

Składnia:

Sin(Wartość)

gdzie:

♦ Wartość (wymagany) — typu Double lub dowolne wyrażenie numeryczneokreślają ce k ą t w radianach.

Zakres wyników funkcji Sin: –1 do 1.

Przykład:

zmA=Sin(90)

'sinus z 90

2.2.3.11. SqR

Funkcja Sqr zwraca wartość pierwiastka kwadratowego podanej wartości typu Do-

uble.




76

Składnia:

Sqr(Wartość)

gdzie:

♦ Wartość (wymagany) — typu Double lub dowolne wyrażenie numeryczne>=0. Jeżeli będzie miał wartość mniejszą od zera, zostanie wygenerowanybłą d.

Przykład:

zmA=Sqr(25) 'zmienna przyjmuje wartość 5

zmB=Sqr(0) 'zmienna przyjmuje wartość 0

2.2.3.12. Tan

Funkcja Tan zwraca wartość funkcji tangens (typu Double) podanej wartości.

Składnia:Tan(Wartość)

gdzie:

♦ Wartość (wymagany) — typu Double lub dowolne wyrażenie numeryczne

określają ce k ą t w radianach.

Przykład:

zmA=Sin(85)

'tangens z 85

2.2.4. Tekstowe

2.2.4.1. Format

(patrz również 2.2.1.8)

Funkcja Format zwraca wartość typu Variant (String) sformatowaną odpowied-

nio do instrukcji zawartych w wyrażeniu.

Składnia:

Format (Wyrażenie[, Format [, PierwszyDzieńTygodnia[,PierwszyTydzieńRoku]]])

gdzie:

♦ Wyrażenie (wymagany) — dowolne poprawne wyrażenie,




77

♦ Format (opcja) — nazwa lub zdefiniowane przez użytkownika wyrażenie

formatują ce,

♦ PierwszyDzieńTygodnia (opcja) — opcjonalna wartość lub stała

określają ca pierwszy dzień tygodnia,

♦ PierwszyTydzieńRoku (opcja) — opcjonalna wartość lub stała określają ca

pierwszy tydzień roku.

Wartości i stałe dla argumentu PierwszyDzieńTygodnia i PierwszyTydzieńRo-

ku wypisane są w punkcie 2.2.1.3.

Różne formaty dla różnych wartości numerycznych

Wyrażenie Format zdefiniowane przez użytkownika dla liczb może mieć od jednej

do czterech sekcji oddzielonych od siebie średnikami. Jeżeli argument Format zawie-

ra jeden z formatów numerycznych, to tylko jedna sekcja jest dozwolona.

Przy użyciu Otrzymany wynik

tylko jednej sekcji wyrażenie Format stosowane do wszystkich wartości

dwóch sekcji pierwsza sekcja stosowana jest do dodatnich wartości i zera, druga do ujemnych

wartości

trzech sekcji pierwsza sekcja stosowana jest do dodatnich wartości, druga do ujemnych

wartości, trzecia do zera

czterech sekcji pierwsza sekcja stosowana jest do dodatnich wartości, druga do ujemnych

wartości, trzecia do zera, a czwarta do wartości Null

Poniższy przykład ma dwie sekcje, pierwsza definiuje format dla dodatnich warto-ści i zera, druga definiuje format dla ujemnych wartości:

"$#,##0;($#,##0)"

Przy użyciu średników, bez żadnych znaków między nimi, opuszczona sekcja jest

wyświetlana z użyciem formatu dla dodatnich wartości. Na przykład poniższy formatwyświetla dodatnie i ujemne wartości, używają c formatu pierwszej sekcji i wyświetla

"Zero", jeżeli wartość jest zero:

"$#,###;;\Z\e\r\o"

Różne formaty dla różnych łańcuchowych wartości

Wyrażenie Format dla łańcuchów może mieć jedną lub dwie sekcje oddzielone śred-

nikami.

Przy użyciu Otrzymany wynik

tylko jednej sekcji wyrażenie Format stosowane do wszystkich danych string




78

dwóch sekcji pierwsza sekcja stosowana jest do danych łańcuchowych, druga do wartości

Null i do pustych łańcuchów ("")

Zdefiniowane formaty numeryczne

Nazwa formatu Opis

General Number Wyświetla liczbę bez separatora tysięcy

Currency

Wyświetla liczbę z separatorem tysięcy, jeżeli jest potrzebny; wyświetla dwie

cyfry do prawej strony separatora dziesiętnego. Formatowanie jest oparte na

ustawieniach lokalnych w systemie

FixedWyświetla przynajmniej jedną cyfrę od lewej i dwie cyfry od prawej strony

separatora dziesiętnego

StandardWyświetla liczbę z separatorem tysięcy, przynajmniej jedną cyfrę od lewej

i dwie cyfry od prawej strony separatora dziesiętnego

PercentWyświetla liczbę pomnożoną przez 100 ze znakiem procentu (%) dołą czonymdo prawej strony, zawsze wyświetla dwie cyfry po prawej stronie separatora

dziesiętnego

Scentific Używa standardowego formatu wykładniczego

Yes/NoWyświetla Nie (No), jeżeli liczba jest 0, w przeciwnym przypadku wyświetla Tak

(Yes)

True/False Wyświetla False, jeżeli liczba jest 0, w przeciwnym przypadku wyświetla True

On/Off Wyświetla Off, jeżeli liczba jest 0, w przeciwnym przypadku wyświetla On

Formaty numeryczne zdefiniowane przez użytkownika

Znaki, jakich można używać do tworzenia formatów numerycznych użytkownika:

Znak Opis

None Wyświetla niesformatowaną liczbę

0 Znak pola. Wyświetla cyfrę lub zero. Jeżeli wyrażenie zawiera cyfrę na pozycji, gdzie

występuje 0 w wyrażeniu Format, wyświetla ją , w przeciwnym wypadku wyświetla

zero na tej pozycji. Jeżeli wyrażenie ma mniej pozycji, niż jest zer po obu stronach

kropki dziesiętnej w określonym formacie, to do wyświetlanej liczby są dodawane

zera. W przypadku gdy wyrażenie ma więcej pozycji z lewej strony kropki dziesiętnej,

to dodatkowe pozycje zostaną wyświetlone, gdy zaś z prawej strony, to zostaną obcięte

# Znak pola. Wyświetla cyfrę lub nic. Jeżeli wyrażenie zawiera cyfrę na pozycji, gdzie

występuje 0 w wyrażeniu Format, wyświetla ją , w przeciwnym przypadku nic nie

wyświetla na tej pozycji. W przypadku gdy wyrażenie ma mniej pozycji, niż jest zer po

obu stronach kropki dziesiętnej w określonym formacie, to do wyświetlanej liczby nie

są dodawane zera

. Znak dziesiętny. W niektórych lokalnych ustawieniach jako separator dziesiętny jest




79

używany przecinek. Znak dziesiętny określa pozycję kropki dziesiętnej w utworzonym

formacie. Jeżeli z lewej strony tego znaku nie ma znaków pola, to liczby mniejsze od 1

zaczynane są znakiem dziesiętnym. Aby wyświetlić zero na począ tku wyświetlanej

liczby ułamkowej, należy użyć znaku 0 jako pierwszego znaku pola po lewej stronie

znaku dziesiętnego. Znak używany jako znak dziesiętny w formatowanym wyjściu

zależy od formatu numerycznego, rozpoznawanego przez system% Znak procentu. Jest wstawiany do wyrażenia na pozycję, na której ma być wyświetlony.

Wyrażenie jest mnożone przez 100

, Separator tysięcy. W niektórych lokalnych ustawieniach jako separator dziesiętny jest

używana kropka. Standardowe użycie separatora tysięcy jest określone, jeżeli format

zawiera separator tysięcy otoczony przez znaki pola (0 lub #). Dwa bezpośrednio do

siebie przylegają ce separatory tysięcy lub separator tysięcy bezpośrednio po lewej

stronie separatora dziesiętnego oznaczają , że wielkość liczby, jeżeli jest to potrzebne,

jest dzielona przez 1000. Na przykład można użyć wyrażenia format "##0,," do

przedstawienia liczy 100 milionów jako 100. Liczby mniejsze niż milion są wyświetlane

jako 0. Dwa bezpośrednio po sobie następują ce separatory tysięcy w jakiejkolwiek

innej pozycji niż po lewej stronie znaku dziesiętnego są traktowane jako normalne

separatory tysięcy. Znak używany jako separator tysięcy w formatowanym wyjściu

zależy od formatu numerycznego rozpoznawanego przez system: Separator czasu. W niektórych lokalnych ustawieniach jako separatory czasu mogą być

używane inne znaki. Separator czasu oddziela od siebie godziny, minuty i sekundy, gdy

wartość czasu jest formatowana. Znak używany jako separator czasu w formatowanym

wyjściu jest określony przez ustawienia systemu

/ Separator daty. W niektórych lokalnych ustawieniach inne znaki mogą być używane

jako separatory daty. Separator daty oddziela od siebie dzień, miesią c i rok, gdy

wartość daty jest formatowana. Znak używany jako separator daty w formatowanym

wyjściu jest określony przez ustawienia systemu

Znak Opis

E+ E– e+e– Format wykładniczy. Umieszczenie jednego z symboli wykładniczych z prawej stronyznaków pola powoduje, że liczba jest wyświetlana w formacie wykładniczym. Litera E

lub e jest umieszczona między liczbą a wykładnikiem. Dla liczb ujemnych należy użyćsymboli z minusem. Liczbę znaków wykładnika potęgi określa się za pomocą znaków

pola umieszczonych z prawej strony symbolu wykładniczego

- + $ () Wy świetla znak literowy. Do wyświetlenia znaków innych niż wymienione należy je

poprzedzić ukośnikiem wstecznym (\) lub zamknąć w dwóch znakach cudzysłowu (" ").

\ Znak zezwolenia. Pozwala na wyświetlenie znaków używanych do formatowania. Aby

wyświetlić taki znak, należy poprzedzić go znakiem zezwolenia. Aby wyświetlić znak

zezwolenia, należy użyć go podwójnie. Przykłady znaków, które nie mogą być normalnie

wyświetlane: znaki formatowania daty i czasu (a, c, d, h, m, n, p, q, s, t, w, y, /, :),

znaki formatowania numerycznego (#, 0, %, E, e, przecinek, kropka), znaki

formatowania łańcuchowego (@, &, <, >, !)

"ABC" Wy świetla łańcuch zawarty między dwoma znakami cudzysłowu (" "). Aby włą czyćłańcuch do argumentu Format z kodu, należy użyć Chr(34) do załą czenia tekstu (34

jest kodem znaku cudzysłowu ("))




80

Formaty łańcuchowe zdefiniowane przez użytkownika

Znaki, jakich można używać do tworzenia wyrażenia Format dla łańcuchów:

Znak Opis

@

Miejsce na znak. Wyświetla znak albo spację. Jeżeli łańcuch zawiera znak na pozycji,

gdzie jest symbol (@) w wyrażeniu Format, wyświetla go, w przeciwnym wypadku

wyświetla spację na tej pozycji. Miejsca na znaki są wypełniane od prawej strony do

lewej, o ile nie występuje znak wykrzyknika (!) w wyrażeniu Format

&

Miejsce na znak. Wyświetla znak lub nic nie wyświetla. Jeżeli łańcuch zawiera znak

na pozycji, gdzie jest symbol (&) w wyrażeniu Format, wyświetla go, w przeciwnym

wypadku nie wyświetla nic. Miejsca na znaki są wypełniane od prawej strony do

lewej, o ile nie występuje znak wykrzyknika (!) w wyrażeniu Format

< Wyświetla wszystkie znaki w formacie małych liter

> Wyświetla wszystkie znaki w formacie dużych liter

! Powoduje wypełnianie miejsc na znaki od lewej do prawej. Standardowo są wypełniane od prawej do lewej

Przykład 1.:

Komunikat = Format(Time, "Long Time")

'zmienna przyjmuje wartość bieżącego czasu w formacie "długiego

czasu"

Przykład 2.:

Komunikat = Format(Date, "Short Date")

'zmienna przyjmuje wartość bieżącej daty w formacie "krótkiej daty

systemowej"

Przykład 3.:

zmCzas = #16:09: 32#

zmA = Format(zmCzas, "h:m:s")

'zmienna przyjmuje wartość "16:9:32"

Przykład 4.:

zmCzas = #16:04:32#

zmA = Format(varCzas, "hh:mm:ss AMPM")

'zmienna przyjmuje wartość "04:09:32 PM"

Przykład 5.:

zmData = #December 28, 2001#

zmA = Format(zmData, "dddd, mmm d yyyy")'zmienna przyjmuje wartość "Friday, Dec 28 2001"




81

Przykład 6.:

zmA = Format(58)

'zmienna przyjmuje wartość "58"

Przykład 7.:zmA = Format(569.3, "###0.00")

'zmienna przyjmuje wartość "569.30"

Przykład 8.:

zmA = Format("TO jEsT teKST", "<")

'zmienna przyjmuje wartość "to jest tekst"

2.2.4.2. LCase

Funkcja LCase zwraca łańcuch znakowy (typu String) przekonwertowany na małe lite-

ry.

Składnia:

LCase(Łańcuch)

gdzie:

♦ Łańcuch (wymagany) — dowolne wyrażenie łańcuchowe.

Przykład:

zmA = LCase("TO jEsT teKST", "<")

'zmienna przyjmuje wartość "to jest tekst"

2.2.4.3. UCase

Funkcja LCase zwraca łańcuch znakowy (typu String) przekonwertowany na duże lite-

ry.

Składnia:

LCase(Łańcuch)

gdzie:


Przykład:

zmA = UCase("To jEst teKsT", "<")

'zmienna przyjmuje wartość "TO JEST TEKST"




82

2.2.4.4. StrConv

Funkcja StrConv zwraca łańcuch znakowy (typu String) przekonwertowany wg

specyfikacji.

Składnia:

StrConv(Łańcuch, Konwersja)

gdzie:

♦ Łańcuch (wymagany) — dowolne wyrażenie łańcuchowe,

♦ Konwersja (wymagany) — wyrażenie typu Integer będą ce sumą wartości

określają cych sposób konwersji.

Stałe i ich wartości wykorzystywane w funkcji:


vbUpperCase 1 konwersja na duże litery

vbLowerCase 2 konwersja na małe litery

vbProperCas

e3 konwersja pierwszej litery każdego słowa na dużą

vbWide* 4* konwersja znaków narrow (jeden bajt) na wide (dwa bajty)

vbNarrow* 8* konwersja znaków wide (dwa bajty) na narrow (jeden bajt)

vbKatakana*

*16** konwersja znaków Hiragana na znaki Katakana

vbHiragana*

*32** konwersja znaków Katakana na znaki Hiragana

vbUnicode 64 konwersja do Unicode używają ca standartowej strony kodowej systemu

vbFromUnico

de128 konwersja z Unicode do standartowej strony kodowej systemu

* Dotyczy Dalekiego Wschodu

** Dotyczy tylko Japonii

Przykład:

zmA="TO jEst teKsT"

zmB=StrConv(zmA,vbProperCase)

'zmienna przyjmuje wartość "To Jest Tekst"

2.2.4.5. LTrim

Funkcja LTrim zwraca łańcuch znakowy (typu String) przekonwertowany wg spe-

cyfikacji bez począ tkowych spacji.




83

Składnia:

LTrim (Łańcuch)

gdzie:


Przykład:

zmA=" To Jest Tekst"

zmB=LTrim (zmA)


2.2.4.6. RTrim

Funkcja RTrim zwraca łańcuch znakowy (typu String) przekonwertowany wg spe-

cyfikacji bez końcowych spacji.

Składnia:RTrim (Łańcuch)

gdzie:


Przykład:

zmA=" To Jest Tekst "

zmB=LTrim (zmA)

'zmienna przyjmuje wartość " To Jest Tekst"

2.2.4.7. Trim

Funkcja Trim zwraca łańcuch znakowy (typu String) przekonwertowany wg specy-

fikacji bez począ tkowych i końcowych spacji.

Składnia:

Trim (Łańcuch)

gdzie:


Przykład:

zmA=" To Jest Tekst "

zmB=Ltrim (zmA)





84

2.2.4.8. Left

Funkcja Left zwraca łańcuch znakowy (typu String), zawierają cy określoną liczbęznaków od lewej strony łańcucha.

Składnia:

Left(Łańcuch, Długość)

gdzie:


♦ Długość (wymagany) — wyrażenie typu Long, określają ce, ile znaków

liczą c od lewej strony Łańcucha ma zostać zwróconych.

Przykład:

zmA="tekst do przetestowania"zmB=Left(zmA, 18)

'zmienna przyjmuje wartość "tekst do przetesto"

2.2.4.9. LeftB

Funkcja LeftB zwraca łańcuch znakowy (typu String), zajmują cy określoną liczbębajtów od lewej strony łańcucha.

Składnia:

LeftB(Łańcuch, Długość)

gdzie:


♦ Długość (wymagany) — wyrażenie typu Long, określają ce rozmiar

Łańcucha, który ma zostać zwrócony (w bajtach) od lewej strony łańcucha.

Przykład:

zmA="To jest tekst testowy"zmB=LeftB(zmA, 22)

'zmienna przyjmuje wartość "To jest tek"

2.2.4.10. Right

Funkcja Right zwraca łańcuch znakowy (typu String), zawierają cy określoną licz-

bę znaków od prawej strony łańcucha.




85

Składnia:

Right(Łańcuch, Długość)

gdzie:


♦ Długość (wymagany) — wyrażenie typu Long, określają ce, ile znaków

liczą c od prawej strony Łańcucha ma zostać zwróconych.

Przykład:

zmA="tekst do przetestowania"zmB=Right(zmA, 12)

'zmienna przyjmuje wartość "zetestowania"

2.2.4.11. RightB

Funkcja LeftB zwraca łańcuch znakowy (typu String), zajmują cy określoną liczbębajtów od prawej strony łańcucha.

Składnia:

RightB(Łańcuch, Długość)

gdzie:


♦ Długość (wymagany) — wyrażenie typu Long, określają ce rozmiar

Łańcucha, który ma zostać zwrócony (w bajtach) od prawej strony łańcucha.

Przykład:

zmA="To jest tekst testowy"zmB=RightB(zmA, 22)

'zmienna przyjmuje wartość "kst testowy "

2.2.4.12. Mid

Funkcja Mid zwraca łańcuch znakowy (typu String), zawierają cy określoną liczbęznaków z łańcucha.

Składnia:

Mid (Łańcuch, Początek [,Długość])

gdzie:♦ Łańcuch (wymagany) — dowolne wyrażenie łańcuchowe,

♦ Początek (wymagany) — wyrażenie typu Long, określają ce pozycję znaku,

od którego będzie zwracany łańcuch,




86

♦ Długość (opcja) — wyrażenie typu Long, określają ce, ile znaków, liczą c od

znaku o numerze Początek, ma zostać zwróconych. Jeżeli argument

Długość zostanie ominięty lub będzie większy niż liczba znaków łańcucha

od znaku o numerze Początek do końca łańcucha, funkcja zwróci część

łańcucha od znaku o numerze Początek do końca łańcucha.

Przykład:

zmA= Mid ("To jest tekst testowy",7)

'zmienna przyjmuje wartość "t tekst testowy"varNapis= Mid ("To jest tekst testowy",7, 5)

'zmienna przyjmuje wartość "t tek"

2.2.4.13. Space

Funkcja Space zwraca łańcuch znakowy (typu String), zawierają cy określoną licz-

bę spacji.

Składnia:Space(Długość)

gdzie:

♦ Długość (wymagany) — wyrażenie typu Long, określają ce liczbę spacji,

które mają znaleźć się w zwróconym cią gu znaków.

Przykład:

zmA = "To jest..." & Space(5) & "test!!!"

'zmienna przyjmuje wartość "To jest... test!!!"

2.2.4.14. String

Funkcja String zwraca łańcuch (String), zawierają cy określoną liczbę takich sa-

mych znaków.

Składnia:

String(Długość, Znak)

gdzie:

♦ Długość (wymagany) — wyrażenie typu Long, określają ce liczbę znaków

do powtórzenia,

♦ Znak (wymagany) — wyrażenie będą ce kodem znaku lub wyrażeniem

łańcuchowym, którego pierwszy znak zostanie wykorzystany do stworzeniałańcucha.




87

Przykład:

zmA=String(5,42)

'zmienna przyjmuje wartość "*****"

varNapis=String(7,"Test")

'zmienna przyjmuje wartość "TTTTTTT"

2.2.5. Testują ce

2.2.5.1. IIf

Funkcja IIf zwraca jedną z dwóch podanych wartości — zależnie od wartości wyra-

żenia.

Składnia:

IIf(Wyrażenie, GdyTrue, GdyFalse)

gdzie:

♦ Wyrażenie (wymagany) — sprawdzane wyrażenie,

♦ GdyTrue (wymagany) — wyrażenie zwracane, gdy Wyrażenie ma wartośćTrue,

♦ GdyFalse (wymagany) — wyrażenie zwracane, gdy Wyrażenie ma wartośćFalse.

Przykład:

zmA=IIf(zmWiek>25,"Dorosły","Młodzież")

'zmienna przyjmuje wartość "Dorosły", gdy zmienna

'zmWiek jest > 25, w przeciwnym wypadku zmienna

'zmA przyjmie wartość "Młodzież"

2.2.5.2. IsArray

Funkcja IsArray zwraca wartość typu Boolean (True lub False), określają cą , czy

badana zmienna jest tablicą .

Składnia:

IsArray(NazwaZmiennej)

gdzie:

♦ NazwaZmiennej (wymagany) — identyfikator zmiennej.

Przykład:

zmA=29

zmB=IsArray(varZmienna) 'varCzyTablica=False

'zmienna zmB przyjmuje wartość False, ponieważ sprawdzana




88

'zmienna nie identyfikuje tablicy

zmA=Array(10,4,5)zmB=IsArray(varZmienna) 'varCzyTablica=True'zmienna zmB przyjmuje wartość True, ponieważ sprawdzana

'zmienna identyfikuje tablicę

2.2.5.3. LBound

Funkcja LBound zwraca wartość typu Long, zawierają cą najmniejszy dopuszczalny

numer indeksu dla elementów wybranego wymiaru tablicy.

Składnia:

LBound (NazwaZmiennej [,NumerWymiaru])

gdzie:

♦ NazwaZmiennej (wymagany) — identyfikator zmiennej zawierają cej

tablicę,

♦ NumerWymiaru (opcja) — wartość typu Long określają ca numer wymiarutablicy, którego dolny zakres ma być zwrócony. Wymiary numerowane są od 1, wartością domyślną jest 1.

Przykład:

Dim zmATo (1 To 12, -5 To 5, 26 To 93) As Variant

Dim zmB (33) As Variant

zmC=LBound (zmATo,2) 'zmienna przyjmuje wartość –5

zmC=LBound (zmB) 'zmienna przyjmuje wartość 0 lub 1

2.2.5.4. UBound

Funkcja UBound zwraca wartość typu Long, zawierają cą największy dopuszczalnynumer indeksu dla elementów wybranego wymiaru tablicy.

Składnia:

UBound (NazwaZmiennej [,NumerWymiaru])

gdzie:

♦ NazwaZmiennej (wymagany) — identyfikator zmiennej zawierają cejtablicę,

♦ NumerWymiaru (opcja) — wartość typu Long, określają ca numer wymiaru

tablicy, którego górny zakres ma być zwrócony. Wymiary numerowane są

od 1, wartością domyślną jest 1.

Przykład:

Dim zmATo (1 To 12, -5 To 5, 26 To 93) As VariantDim zmB (33) As Variant




89

zmC=UBound (zmATo,2) 'zmienna przyjmuje wartość 5

zmC=UBound (zmB) 'zmienna przyjmuje wartość 19 lub 20

2.2.5.5. IsDate

Funkcja IsDate zwraca wartość typu Boolean (True lub False), określają cą , czy

badana zmienna może być konwertowana do typu Data.

Składnia:

IsDate(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — wyrażenie typu łańcuchowego lub daty,rozpoznawalne jako data lub czas.

Przykład:

zmA="1953, Luty 10"zmB=IsDate(zmA)

'zmienna zmB przyjmuje wartość True, ponieważ sprawdzana'zmienna może być konwertowanazmA="Tekst testowy"zmB=IsDate(zmA) 'varCzyData=False

'zmienna zmB przyjmuje wartość False, ponieważ sprawdzana'zmienna nie może być konwertowana

2.2.5.6. IsNumeric

Funkcja IsNumeric zwraca wartość typu Boolean (True lub False), określają cą , czybadane wyrażenie może być konwertowane na liczbę.

Składnia:IsNumeric(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — dowolne wyrażenie łańcuchowe lubnumeryczne.

Przykład:

zmA="253.105"zmB=IsNumeric(zmA)

'zmienna zmB przyjmuje wartość True, ponieważ sprawdzana'zmienna może być konwertowana

zmA="Tekst testowy"zmB=IsNumeric(zmA)

'zmienna zmB przyjmuje wartość False, ponieważ sprawdzana'zmienna nie może być konwertowana




90

2.2.5.7. IsEmpty

Funkcja IsEmpty zwraca wartość typu Boolean (True lub False), określają cą , czy

badana zmienna została zainicjowana.

Składnia:

IsEmpty(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — zmienna reprezentują ca dowolne wyrażenie

łańcuchowe lub numeryczne.

Przykład:

zmA=NullzmB=IsEmpty(zmA) 'zmienna przyjmuje wartość False

zmA=Empty

zmB=IsEmpty(zmA) 'zmienna przyjmuje wartość True

2.2.5.8. IsNull

Funkcja IsNull zwraca wartość typu Boolean (True lub False), określają cą , czy

wyrażenie zawiera poprawne dane, czy wartość Null.

Składnia:

IsNull(Wyrażenie)

gdzie:

♦ Wyrażenie (wymagany) — zmienna reprezentują ca dowolne wyrażenie

łańcuchowe lub numeryczne.

Przykład:

Dim zmA As Variant

zmB=IsNull(zmA) 'zmienna przyjmuje wartość False

zmA=""

zmB=IsNull(zmA) 'zmienna przyjmuje wartość False

zmA=Null

zmB=IsNull(zmA) 'zmienna przyjmuje wartość True

2.2.5.9. IsMissing

Funkcja IsMissing zwraca wartość typu Boolean (True lub False), określają cą , czy

argument został przekazany do procedury.

Składnia:

IsMissing(NazwaArgumentu)




91

gdzie:

♦ NazwaArgumentu (wymagany) — wyrażenie zawierają ce nazwęopcjonalnego argumentu typu Variant przekazywanego do funkcji.

Przykład:Function Testowa(Optional zmA)

If IsMissing(zmA) Then

' jeżeli brak argumentu, zwraca wartość Null.

Testowa = Null

Else

Testowa = zmA * 2

End If

End Function

2.2.5.10. VarType

Funkcja VarType zwraca wartość typu Integer, określają cą typ badanej zmiennej.

Składnia:

VarType(NazwaZmiennej)

gdzie:

♦ NazwaZmiennej (wymagany) — wyrażenie zawierają ce nazwę zmiennej.

Wartości i stałe zwracane przez funkcję VarType:


vbEmpty 0 Empty, niezainicjowana

vbNull 1 Null, brak poprawnych danych

vbInteger 2 Integer

vbLong 3 Long Integer

vbSingle 4 Single

vbDouble 5 Double

vbCurrency 6 Currency

vbDate 7 Date

vbString 8 String

Object 9 Object

vbError 10 Error

vbBoolean 11 Boolean

vbVariant 12 Variant (tylko dla tablic Variant)




92


vbDataObje

ct13 Dane dostępu do obiektu

vbDecimal 14 Decimal

vbByte 17 Byte

vbArray 8192 Tablica

Przykład:

zmA=57

zmB= VarType(zmA) 'zmienna przyjmuje wartość 2

zmA="2001, May 25"zmB= VarType(zmA) 'zmienna przyjmuje wartość 7

zmA="Tekst testowy"

zmB= VarType(zmA) 'zmienna przyjmuje wartość 8

zmA=FalsezmB= VarType(zmA) 'zmienna przyjmuje wartość 11

2.2.5.11. TypeName

Funkcja TypeName zwraca wartość typu String, zawierają cą informacje na temat

badanej zmiennej.

Składnia:

TypeName(NazwaZmiennej)

gdzie:

♦ NazwaZmiennej (wymagany) — zawierają ca nazwę zmiennej z wyją tkiemzmiennych typu użytkownika (user-defined type).

Wartości zwracane przez funkcję TypeName:

Zwracany łańcuch Zmienna

object type obiekt typu object type

Byte wartość typu Byte (naturalna)

Integer wartość typu Integer (całkowita)

Long wartość typu Long Integer (całkowita)

Single wartość typu Single (zmiennoprzecinkowa)

Double wartość typu Double (zmiennoprzecinkowa)




93

Zwracany łańcuch Zmienna

Currency wartość typu Currency (walutowa)

Decimal wartość typu Decimal (dziesiętna)

Date wartość typu Date (data)

String wartość typu String (łańcuch)

Boolean wartość typu Boolean (True lub False)

Error błędna wartość

Empty nie zainicjowana

Null brak poprawnych danych

Object obiekt

Unknown żaden ze znanych typów

Nothing zmienna nie odnosi się do żadnego obiektu

Przykład:

Dim zmA As Variant

Dim zmB As String

Dim zmC (1 To 5) As Integer

zmA=Null

zmTyp=TypeName(zmA) 'zmienna przyjmuje wartość "Null"

zmTyp=TypeName(zmB) 'zmienna przyjmuje wartość "String"

zmTyp=TypeName(zmC) 'zmienna przyjmuje wartość "Integer"

2.2.6. Wejścia-wyjścia

2.2.6.1. Command

Funkcja Command zwraca listę argumentów wiersza poleceń, użytą przy uruchamia-

niu Visual Basica lub aplikacji w nim napisanej.

Składnia:

Command

Przykład:

zmA=Command()

'zmienna przyjmuje postać listy argumentów,

'użytych do uruchomienia programu za pomocą wiersza poleceń

2.2.6.2. CurDir

Funkcja CurDir zwraca wartość typu String, zawierają cą bieżą cą ścieżk ę dyskową .




95

Przykład:

zmA=Dir("C:\WINDOWS\CONFIG.TXT")

'zmienna zwraca atrybuty pliku wskazanego pliku

zmA=Dir("*.SYS",vbSystem)

'zmienna zwraca pierwszy znaleziony plik o rozszerzeniu'SYS, i o ustawionym atrybucie „Systemowy”

zmA=Dir

'zmienna zwraca kolejny znaleziony plik

2.2.6.4. Environ

Funkcja Environ zwraca wartość typu String, skojarzoną z podaną zmienną syste-

mową systemu operacyjnego (jednocześnie można użyć tylko jednego argumentu).

Składnia:

Environ(Zmienna | NrZmiennej)

gdzie:

♦ Zmienna (opcja) — wyrażenie łańcuchowe określają ce nazwę zmiennej

systemowej,

♦ NrZmiennej (opcja) — wyrażenie numeryczne będą ce numerem zmiennej

systemowej w tablicy zmiennych systemowych.

Przykład:

zmA=Environ("PATH")

'zmienna zwraca wartość zmiennej systemowej PATH

zmA=Environ(3)

'zmienna zwraca wartość 3 zmiennej z tablicy'zmiennych systemowych

2.2.6.5. EOF

Funkcja EOF zwraca wartość typu Integer, zawierają cą wartość Boolean (True), w

przypadku osią gnięcia końca pliku otwartego w trybie Random lub Input .

Składnia funkcji EOF:

EOF(NrPliku)

gdzie:

♦ NrPliku (wymagany) — wyrażenie typu Integer zawierają ce numer

otwartego pliku.




96

Przykład:

If Not EOF(1) Then 'kolejne instrukcje będą wykonywane

... 'tylko wtedy, gdy koniec pliku 1

'nie zostanie jeszcze osiągnięty

2.2.6.6. FileAttr

Funkcja FileAttr zwraca wartość typu Long, określają cą tryb otwarcia otwartego pli-

ku.

Składnia:

FileAttr(NrPliku, ZwracanyTyp)

gdzie:


otwartego pliku,

♦ ZwracanyTyp (wymagany) — wyrażenie typu Integer określają ce rodzajzwróconej wartości. Argument może przyjąć wartość 1 lub 2, przy czym

wartość 2 wykorzystywana jest tylko w systemach 16-bitowych i nie jestobsługiwana w systemach 32-bitowych.

Wartości zwracane przez funkcję, w przypadku gdy wartość argumentu Zwracany-

Typ wynosi 1:

Tryb Zwracana wartość

Input 1

Output 2

Random 4

Append 8

Binary 32

Przykład:

Open "PlikTestowy" For Binary As #1

zm1=FileAttr(1,1) 'zmienna przyjmuje wartość 32

2.2.6.7. FileDateTime

Funkcja FileDateTime zwraca wartość typu Date, określają cą datę i czas ostatniejmodyfikacji pliku.




97

Składnia:

FileDateTime(Ś cieżkaDoPliku)

gdzie:

♦ Ś cieżkaDoPliku (wymagany) — dowolne wyrażenie łańcuchowe będą ce

poprawną ścieżk ą dostępu do pliku.

Przykład:

zm1=FileDateTime("Plik")

'zmienna przyjmuje wartość, np. "01/07/24 17:42:03"

2.2.6.8. FileLen

Funkcja FileLen zwraca wartość typu Long, będą cą rozmiarem pliku nie otwartego

lub tuż przed otwarciem w bajtach.

Składnia:

FileLen(Ś cieżkaDoPliku)

gdzie:

♦ Ś cieżkaDoPliku (wymagany) — dowolne wyrażenie łańcuchowe będą ce

poprawną ścieżk ą dostępu do pliku.

Przykład:

zm1=FileLen("Plik") 'pobranie rozmiaru pliku "FILE"

'zmienna przyjmuje wartość, np. "1057"

2.2.6.9. FreeFile

Funkcja FreeFile zwraca wartość typu Integer, będą cą kolejnym wolnym nume-

rem, możliwym do wykorzystania przy otwieraniu lub tworzeniu pliku.

Składnia:

FreeFile(ZakresArgumentow )

gdzie:

♦ ZakresArgumentów (opcja) — wyrażenie typu Variant określają ce

zakres używanych numerów plików. Wartość 0 (domyślna) określa zakres

numerów 1 – 255, wartość 1 określa zakres numerów 256 – 511.

Przykład:

zm1=FreeFile

'zmienna przyjmuje wartość, np. "4"




98

2.2.6.10. GetAttr

Funkcja GetAttr zwraca wartość typu Integer, określają cą atrybut pliku lub kata-

logu (folderu).

Składnia:

GetAttr (Ś cieżkaDostę pu)

gdzie:

♦ Ś cieżkaDostę pu (wymagany) — dowolne wyrażenie łańcuchowe będą ce

poprawną ścieżk ą dostępu do pliku lub katalogu (folderu).

Wartości i stałe zwracane przez funkcję:


vbNormal 0 normalny (domyślny)

vbReadOnly 1 tylko do odczytu

vbHidden 2 ukryty

vbSystem 4 systemowy

vbDirector

y16 katalog lub folder

vbArchive 32 plik został zmieniony od ostatniego wykonania kopii zapasowej

Przykład:

zm1="c:\io.sys"

zm2=GetAttr(zm1) And vbSystem'zmienna przyjmie wartość zero, jeżeli wskazany plik

'nie jest systemowy, a 1 jeżeli jest

zm1="pulpit"

zm2=GetAttr(zm1)

'zmienna przyjmie wartość 16, jeżeli wskazany ciąg

'reprezentuje katalog (folder)

2.2.6.11. Input

Funkcja Input zwraca wartość typu String, zawierają cą określony znak z pliku

otwartego w trybie Input lub Binary.

Składnia:

Input(Numer , [#]NrPliku)




99

gdzie:

♦ Numer (wymagany) — wyrażenie numeryczne określają ce numer znakudo zwrócenia,

♦ NrPliku (wymagany) — wyrażenie typu

Integer zawierają ce numerotwartego pliku.

Przykład:

zm1=Input(123,#2) 'odczytaj znak

'zmienna przyjmie wartość 123 znaku z otwartego pliku,

'oznaczonego numerem 2

2.2.6.12. InputBox

Funkcja InputBox wyświetla na ekranie standardowe okienko dialogowe.

Składnia:

InputBox(Pytanie [, Tytuł] [, Domy ślnyTekst] [, XPos] [, YPos]

[,PlikHelp, HelpContext])

gdzie:

♦ Pytanie (wymagany) — dowolne wyrażenie łańcuchowe wyświetlane jako

wiadomość w oknie dialogowym,

♦ Tytuł (opcja) — dowolne wyrażenie łańcuchowe wyświetlane na paskutytułowym okienka,

♦ Domy ślnyTekst (opcja) — dowolne wyrażenie łańcuchowe będą ce

domyślnie wyświetlanym tekstem,

♦ XPos (opcja) — dowolne wyrażenie numeryczne określają ce w twipsach

poziomą odległość między lewą krawędzią okna dialogowego a lewą krawędzią ekranu,

♦ YPos (opcja) — dowolne wyrażenie numeryczne określają ce w twipsach

pionową odległość między górną krawędzią okna dialogowego a górną krawędzią ekranu,

♦ PlikHelp (opcja) — dowolne wyrażenie łańcuchowe określają ce plik

pomocy (*.hlp), zawierają cy podpowiedzi dotyczą ce tworzonego okna

dialogowego,

♦ HelpContext (opcja) — dowolne wyrażenie numeryczne określają ce numer

skojarzony przez autora pliku pomocy z tematem pomocy.

Przykład:

InputBox("Podaj imię", "DANE OSOBOWE", "Jurek", 120, 145 )

'na ekranie wyświetli się okienko dialogowe, zawierające

'pytanie, tytuł, wartość domyślną, i o określonym




100

'położeniu

2.2.6.13. LoadPicture

Funkcja LoadPicture ładuje plik z grafik ą do właściwości formy — Picture (patrz3.2.103), kontrolki Image (patrz 3.1.19) lub kontrolki PictureBox (patrz 3.1.28).

Składnia:

LoadPicture(NazwaPliku)

gdzie:

♦ Pytanie (wymagany) — dowolne wyrażenie łańcuchowe, będą ce poprawną ścieżk ą dostępu do pliku graficznego, który ma zostać załadowany.

Przykład:

Set Form3.Picture=LoadPicture("obrazek.bmp")

'do obiektu zostanie załadowany wskazany plik graficzny

2.2.6.14. Loc

Funkcja Loc zwraca wartość typu Long, określają cą ostatnią pozycję odczytu lub za-pisu otwartego pliku.

Składnia:

Loc(NrPliku)

gdzie:

♦ NrPliku (wymagany) — wyrażenie typu Integer zawierają ce numerotwartego pliku.



Random numer ostatnio odczytanego lub zapisanego rekordu do pliku

Sequential

(sekwencyjny)bieżą ca pozycja pliku w bajtach podzielona przez 128

Binary pozycja ostatniego bajta odczytanego lub zapisanego

Przykład:

zm1=Loc(3)'zmienna przyjmie wartość, określającą ostatnią pozycję

'zapisu lub odczytu podanego pliku




101

2.2.6.15. LOF

Funkcja LOF zwraca wartość typu Long, reprezentują cą rozmiar otwartego wcześniejpliku w bajtach.

Składnia:

LOF(NrPliku)

gdzie:


otwartego pliku.

Przykład:

zm1=LOF(1)

'zmienna przyjmie wartość, określającą rozmiar

'podanego pliku

2.2.6.16. MsgBox

Funkcja MsgBox wyświetla na ekranie standardowe okienko komunikatu.

Składnia:

MsgBox(Komunikat [, Przyciski] [, Tytuł] [, PlikHelp, HelpContext])

gdzie:

♦ Komunikat (wymagany) — dowolne wyrażenie łańcuchowe wyświetlane jako wiadomość w oknie dialogowym,

♦ Przyciski (opcja) — wyrażenie numeryczne będą ce sumą wartościokreślają cych numer i typ przycisków, które mają być wyświetlane, styl

wyświetlanej ikony i modalność okna wiadomości. Wartością domyślną jest 0,

♦ Tytuł (opcja) — dowolne wyrażenie łańcuchowe wyświetlane na paskutytułowym okienka,

♦ PlikHelp (opcja) — dowolne wyrażenie łańcuchowe określają ce plik

pomocy (*.hlp), zawierają cy podpowiedzi dotyczą ce tworzonego oknadialogowego,

♦ HelpContext (opcja) — dowolne wyrażenie numeryczne określają ce numer

skojarzony przez autora pliku pomocy z tematem pomocy.

Wartości i stałe argumentu Przyciski:


vbOKOnly 0 tylko przycisk OK (Dobrze)




102

vbOKCancel 1 przyciski OK (Dobrze) oraz Cancel (Anuluj)

vbAbortRetryIgnor

e2 przyciski Abort (Przerwij), Retry (Ponów) oraz Ignore (Zignoruj)

vbYesNoCancel 3 przyciski Yes (Tak), No (Nie) i Cancel (Anuluj)

vbYesNo 4 przyciski Yes (Tak) i No (Nie)


vbRetryCancel 5 przyciski Retry (Ponów próbę) i Cancel (Anuluj)

vbCritical 16 wyświetla ikonę wiadomości krytycznej

vbQuestion 32 wyświetla ikonę pytania

vbExclamation 48 wyświetla ikonę wiadomości ostrzegawczej

vbInformation 64 wyświetla ikonę wiadomości

vbDefaultButton1 0 pierwszy przycisk staje się domyślny

vbDefaultButton2 256 drugi przycisk staje się domyślny

vbDefaultButton3 512 trzeci przycisk staje się domyślny

vbDefaultButton4 768 czwarty przycisk staje się domyślny

vbApplicationModa

l0 okno modalne dla aplikacji, użytkownik musi zareagować

vbSystemModal 4096 okno modalne dla systemu, wszystkie aplikacje są zawieszone,

dopóki użytkownik nie zareaguje

vbMsgBoxHelpButto

n16384 dodaje przycisk Help (Pomoc)

VbMsgBoxSetForegr

ound65536 okienko komunikatu będzie zawsze „na wierzchu”

vbMsgBoxRight 524288 tekst jest wyrównany do prawej

vbMsgBoxRtlReadin

g1048576 tekst w systemach arabskich i hebrajskich (czytany od prawej do

lewej)

Przykład:

MsgBox("Czy jesteś mężczyzną?",

vbYesNo+vbQuestion+vbDefaultButton2, "Ankieta",

"Pomoc.hlp", 7)

'na ekranie wyświetli się okienko komunikatu, zawierające

'pytanie, dwa przyciski ("Yes" oraz "No"), określenie, że

'drugi przycisk jest domyślny, tytuł, określenie pliku

'pomocy, określenie tematu w pliku pomocy

2.2.6.17. Seek

Funkcja Seek zwraca wartość typu Long, określają cą następną pozycję odczytu lub

zapisu otwartego pliku.




103

Składnia:

Seek(NrPliku)

gdzie:

♦ NrPliku (wymagany) — wyrażenie typu Integer zawierają ce numerotwartego pliku.



Random numer następnego rekordu do odczytu lub zapisu w pliku

Binary, Output, Append,

Inputpozycja bajta, na którym będzie wykonana następna operacja

Przykład:

zm1=Loc(3)

'zmienna przyjmie wartość, określającą następną pozycję

'zapisu lub odczytu podanego pliku

2.2.6.18. SetAttr

Funkcja SetAttr ustawia atrybuty określonego pliku.

Składnia:

SetAttr Ś cieżkaDoPliku, Atrybuty

gdzie:

♦ Ś cieżkaDoPliku (wymagany) — dowolne wyrażenie łańcuchowe będą cepoprawną ścieżk ą dostępu do pliku,

♦ Atrybuty (wymagany) — wyrażenie będą ce sumą stałych lub wartości,określają cych nadawane atrybuty.

Wartości i stałe argumentu Atrybuty :


vbNormal 0 normalny (domyślny)

vbReadOnly 1 tylko do odczytu

vbHidden 2 ukryty

vbSystem 4 systemowy

vbArchive 32 plik został zmieniony od ostatniego wykonania kopii zapasowej




104

Przykład:

SetAttr "Plik", vbSystem+vbReadOnly

'nadanie plikowi atrybutów "Systemowy"

'oraz "TylkoDoOdczytu"

2.2.6.19. Shell

Funkcja Shell uruchamia program wykonywalny.

Składnia:

Shell(Ś cieżkaDostę pu [, StylOkna])

gdzie:

♦ Ś cieżkaDostę pu (wymagany) — dowolne wyrażenie łańcuchowe, będą cepoprawną ścieżk ą dostępu do uruchamianej aplikacji (wraz z jej ewentualnymiargumentami wiersza poleceń),

♦ StylOkna (opcja) — wyrażenie lub stała określają ca styl okna uruchamianejaplikacji.

Wartości i stałe atrybutu StylOkna:


vbHide 0 Okno jest ukryte i posiada fokus

vbNormalFocus 1 Okno ma normalny rozmiar i pozycję i posiada fokus

vbMinimizedFocus 2 Okno jest zminimalizowane i posiada fokus

vbMaximizedFocus 3 Okno jest zmaksymalizowane i posiada fokus

vbNormalNoFocus4 Okno ma normalny rozmiar i pozycję. Aktualnie aktywne oknopozostaje aktywne

vbMinimizedNoFoc

us6 Okno jest zminimalizowane. Aktualnie aktywne okno pozostaje

aktywne

Przykład:

Shell("C:\Windows\Notepad.exe",1)

'uruchomiona zostanie wskazana aplikacja jako aktywna

2.2.7. Pozostałe

2.2.7.1. DoEvents

Funkcja DoEvents oddaje sterowanie, aby system operacyjny mógł wykonać in-ne zdarzenia.




105

Składnia:

DoEvents()

Przykład:

If zm1=2500 ThenDoEvents

'system wstrzymuje wykonywanie aktualnego procesu

'i ustawia go w kolejce procesów

Enf If

2.2.7.2. Error

Funkcja Error zwraca komunikat o błędzie o podanym numerze.

Składnia:

Error[(NrBłędu)]

gdzie:

♦ NrBłędu (opcja) — poprawny numer błędu.

Przykład:

If zm1 = 'YES'

MsgBox(Error(63))

'w zależności od stanu zmiennej zostanie wyświetlony

'komunikat o błędzie o podanym numerze

End If

2.2.7.3. RGB

Funkcja RGB zwraca wartość typu Long, określają cą wartość koloru RGB.

Składnia:

RGB(Czerwony , Zielony , Niebieski)

gdzie:

♦ Czerwony (wymagany) — wyrażenie typu Integer będą ce wartością danej

składowej,

♦ Zielony (wymagany) — wyrażenie typu Integer będą ce wartością danej

składowej,

♦ Niebieski (wymagany) — wyrażenie typu Integer będą ce wartością danej składowej.

Wartości składowych funkcji określają ce standardowe kolory:

Kolor Składowa czerwona Składowa zielona Składowa niebieska




106

Czarny 0 0 0

Niebieski 0 0 255

Zielony 0 255 0

Cyjan 0 255 255

Czerwony 255 0 0

Magenta 255 0 255

Kolor Składowa czerwona Składowa zielona Składowa niebieska

Żółty 255 255 0

Biały 255 255 255

Przykład:

zm1=RGB(255,255,0)

'zmienna przyjmie wartość, określającą kolor żółty

2.2.7.4. QBColor

Funkcja QBColor zwraca wartość typu Long, określają cą kod RGB koloru o poda-

nym numerze.

Składnia:

QBColor(Kolor )

gdzie:

♦ Kolor (wymagany) — wyrażenie typu Integer będą ce prawidłowymnumerem koloru.

Dopuszczalne wartości argumentu Kolor :

Numer Kolor

0 czarny (Black)

1 niebieski (Blue)

2 zielony (Green)

3 cyjan (Cyan)

4 czerwony (Red)

5 magenta

6 żółty (Yellow)




107

7 biały (White)

8 szary (Gray)

9 jasny niebieski (Light Blue)

10 jasny zielony (Light Green)

11 jasny cyjan (Light Cyan)

12 jasny czerwony (Light Red)

13 jasny magenta (Light Magenta)

Numer Kolor

14 jasny żółty (Light Yellow)

15 ciemny biały (Bright White)

Przykład:zm1=QBColor(14)

'zmienna przyjmie wartość, określającą kolor

'"Light Yellow" w kodzie RGB



107

Rozdział 3.

Obiekty w VB

Obiekty w Visual Basicu odgrywają kluczową rolę. Nie trzeba od samych podstawkodować wyświetlania grafiki czy rozwijanego menu. Zamiast tego wstawiamy go-

towe już elementy, zwane obiektami. Ułatwiają one życie programiście, skracają c

czas potrzebny do napisania aplikacji. Ale nie ulegajmy złudzeniu, że reszta jest nie-zmiernie łatwa. Otóż nie — sprawne i efektywne korzystanie z obiektów wymagawiedzy o ich możliwościach. Tak ą podstawową wiedzę zapewnia poniższy rozdział.

3.1. Kontrolki standardowe

3.1.1. Animation

Kontrolka ta pozwala wyświetlić animację (pliki *.avi). Potrafi jednak odtwarzać pli-

ki AVI bez dźwięków.

Próba załadowania pliku *.avi, zawierają cego dźwięk, lub pliku w innym formacie za-

kończy się wygenerowaniem błędu.

Dostępne zdarzenia:

♦ Click (ActiveX) — wciśnięcie przycisku myszy

♦ DblClick (ActiveX) — podwójne wciśnięcie przycisku myszy

♦ DragDrop — zakończenie przecią gania obiektu

♦ DragOver — przecią ganie obiektu

♦ GotFocus — otrzymanie fokusa

♦ LostFocus — utracenie fokusa




108

♦ MouseDown — wciśnięcie przycisku myszy

♦ MouseMove — przesuwanie wskaźnika myszy

♦ MouseUp — wciśnięcie przycisku myszy

Dostępne metody:

♦ Close (Animation) — zamknięcie otwartego pliku

♦ Drag — rozpoczęcie, zakończenie lub przerwanie przecią gania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag (ActiveX) — rozpoczęcie operacji drag/drop

♦ Open (Animation) — otwarcie pliku

♦ Play (Animation) — rozpoczęcie odtwarzania pliku

♦ SetFocus — przeniesienie fokusa na kontrolk ę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ Stop (Animation) — zatrzymanie odtwarzania pliku

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.2. CheckBox

Kontrolka CheckBox daje użytkownikowi możliwość dokonania wyboru opcji (wybórmoże paść na więcej niż jedną ). Wyświetla ona znak potwierdzenia przy wybranej opcji.






♦ KeyDown — generowane po naciśnięciu przycisku

♦ KeyPress — generowane po naciśnięciu i zwolnieniu przycisku

♦ KeyUp — generowane po zwolnieniu przycisku







Rozdział 3. ♦♦♦♦ Obiekty w VB 109

109

Dostępne metody:



♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu




3.1.3. ComboBox

Kontrolka ComboBox jest listą rozwijalną , do której użytkownik może sam wprowa-

dzić wartości lub korzystać z już wyświetlanych. Dodawać lub usuwać wartości z li-sty można programowo, za pomocą odpowiednich metod.


♦ Change — zmiana wartości kontrolki

♦ Click — wciśnięcie przycisku myszy

♦ DblClick — podwójne wciśnięcie przycisku myszy



♦ DrapDown — rozwinięcie ComboBox do listy






♦ Scroll — zmiana pozycji na pasku przewijania

Dostępne metody:

♦ AddItem — dodanie elementu do listy kontrolki

♦ Clear — wyczyszczenie zawartości kontrolki






110



♦ RemoveItem — usunięcie elementu z listy kontrolki




3.1.4. CommandButton

Za pomocą kontrolki Button można stworzyć standardowy przycisk.













Dostępne metody:











111

3.1.5. CommonDialog

Kontrolka CommonDialog umożliwia wykorzystanie standardowych okien dialogo-wych. Kontrolka ta wykorzystuje standardową bibliotek ę Windows — commdlg.dll.

Aby móc stosować tę kontrolk ę, biblioteka commdlg.dll musi się znajdować w kata-logu SYSTEM systemu operacyjnego Windows.

Dostępne metody:

♦ AboutBox — wyświetla okno About (O...)

♦ ShowColor — wyświetla okno wybory koloru

♦ ShowFont — wyświetla okno wyboru czcionki

♦ ShowHelp — wywołuje pomoc systemu Windows

♦ ShowOpen — wyświetla okno Open (Otwórz plik )

♦

ShowPrinter — wyświetla okno ustawień drukarki♦ ShowSave — wyświetla okno SaveAs ( Zapisz jako)

3.1.6. Data

Kontrolka Data umożliwia dostęp do baz danych (zapis i odczyt danych). Można

również za jej pomocą dokonywać zapytań do bazy danych. Jej obecność w progra-mie zapewnia przede wszystkim możliwość manipulowania danymi poprzez inne,

skojarzone kontrolki. Z kontrolk ą Data, a co za tym idzie z bazą danych, można sko-

jarzyć następują ce kontrolki:

♦ ComboBox ♦ Label

♦ CheckBox ♦ ListBox

♦ DBCombo ♦ MSFlexGrid

♦ DBGrid ♦ OLEContainer

♦ DBList ♦ PictureBox

♦ Image ♦ TextBox




♦ Error — wystą pił błą d zewnętrzny Visual Basic






112


♦ OLECompleteDrag — poinformowanie komponentu docelowego

o zakończeniu operacji OLE drag/drop

♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowymw operacji OLE drag/drop

♦ OLEDragOver — przecią ganie jednego komponentu nad drugim w operacji

OLE drag/drop

♦ OLEGiveFeedback — zakończono zdarzenie OLEDragOver

♦ OLESetData — brak danych w odpowiednim formacie dla komponentu

docelowego w operacji OLE drag/drop

♦ Reposition — rekord staje się bieżą cym

♦ Resize — zmiana rozmiaru obiektu

♦ Validate — inny rekord ma stać się bieżą cym

Dostępne metody:






♦ UpdateControls — wyświetlenie bieżą cego rekordu w kontrolkach

połą czonych

♦ UpdateRecord — zapisanie wartości kontrolek połą czonych


3.1.7. DBCombo

Kontrolka DBCombo tworzy okno rozwijalne, automatycznie wypełniane z bazy da-nych, poprzez skojarzenie z kontrolk ą Data, co umożliwia też jej modyfikację. Może

również odświeżać inną kontrolk ę Data. Pole tekstowe tej kontrolki może być wyko-rzystywane do edytowania wybranego pola. Za jej pomocą można szybko przeszuki-

wać elementy skojarzone z odpowiednią kontrolk ą Data.

Dostępne zdarzenia:♦ Change — zmiana wartości kontrolki






113




♦ KeyDown — wciśnięcie klawisza

♦ KeyPress — wciśnięcie klawisza ASCII

♦ KeyUp — zwolnienie klawisza








♦ OLEDragOver — przecią ganie jednego komponentu nad drugim

w operacji OLE drag/drop




♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:




♦ Refill — odświeżenie zawartości listy





3.1.7. DBGrid

Kontrolka DBGrid służy do wyświetlania zawartości pól bazy danych w uporzą dko-wanej formie, przypominają cej Accessa. Jest to zbiór wierszy i kolumn, zawartych




114

w jednej tabeli. Liczbę wyświetlanych wierszy i kolumn można określać poprzez od-

powiednie właściwości (maksymalna liczba wierszy jest uzależniona od zasobów sys-

temowych komputera, kolumn zaś można wyświetlić 1700). Wartości w poszczegól-

nych komórkach tabeli mogą być edytowane.


♦ AfterColEdit — zakończenie edycji komórki

♦ AfterColUpdate — zakończenie przenoszenia danych z komórki do bufora

kontrolki

♦ AfterDelete — zakończenie usuwania rekordu z kontrolki

♦ AfterInsert — zakończenie wstawiania rekordu do kontrolki

♦ AfterUpdate — zakończenie zapisywania zmienionych danych do bazy danych

♦ BeforeColEdit — rozpoczęcie edytowania kolumny

♦ BeforeColUpdate — rozpoczęcie przenoszenia danych z komórki do bufora

♦ BeforeDelete — rozpoczęcie usuwania rekordu z kontrolki

♦ BeforeInsert — rozpoczęcie wstawiania rekordu do kontrolki

♦ BeforeUpdate — rozpoczęcie zapisywania zmian do bazy danych

♦ ButtonClick — wciśnięcie przycisku komórki



♦ ColEdit — edytowanie kolumny

♦ ColResize — zmiana rozmiarów kolumny




♦ Error — wystą pił błą d zewnętrzny Visual Basic


♦ HeadClick — kliknięcie nagłówka kolumny










115


♦ OnAddNew — wywołanie operacji AddNew

♦ RowColChange — zmiana bieżą cej komórki

♦ RowResize — zmiana rozmiaru wiersza


♦ SelChange — zmiana zaznaczenia

♦ SplitChange — zmiana bieżą cej wykorzystywanej linii podziału

♦ UnboundAddData — dodanie nowego rekordu do kontrolki nie połą czonej

♦ UnboundDeleteRow — usunięcie rekordu kontrolki nie połą czonej

♦ UnboundGetRelativeBookmark — wyświetlanie danych kontrolki niepołą czonej

♦ UnboundReadData — wyświetlanie danych kontrolki nie połą czonej

♦ UnboundWriteData — zapisanie danych kontrolki nie połą czonej

Dostępne metody:

♦ CaptureImage — zapisanie wyglą du kontrolki jako obrazu graficznego

♦ ClearFields — przywrócenie domyślnego wyglą du kontrolki

♦ ClearSelCols — anulowanie zaznaczenia kolumn

♦ ColContaining — indeks komórki o określonych współrzędnych


♦ GetBookmark — zakładka wybranego wiersza

♦ HoldFields — zapamiętanie ustawień bieżą cej kolumny


♦ Rebind — odtworzenie kontrolki


♦ RowBookmark — zakładka widzialnych wierszy kontrolki

♦ RowContaining — indeks komórki o określonych współrzędnych

♦ RowTop — współrzędne określonego wiersza




♦ SplitContaining — linia podziału o określonych współrzędnych




116


3.1.8. DBList

Kontrolka DBList jest listą rozwijaną , automatycznie wypełnianą wartościami dzięki

skojarzeniu z kontrolk ą Data. Może również zmieniać zawartości pól innej kontrolki

Data. Za jej pomocą można szybko przeszukiwać elementy skojarzone z odpowiednią kontrolk ą Data.














♦

OLECompleteDrag — poinformowanie komponentu docelowegoo zakończeniu operacji OLE drag/drop

♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym



OLE drag/drop





Dostępne metody:






117

♦ OLEDrag — rozpoczęcie operacji drag/drop Refill odświeżenie zawartości

listy


♦

SetFocus — przeniesienie fokusa na kontrolk ę ♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


3.1.9. Debug

Za pomocą obiektu Debug możliwa jest kontrola programu w fazie jego wykonywa-

nia.

Dostępne metody:

♦ Assert — powoduje zatrzymanie programu

♦ Print — wyświetla tekst na obiekcie

3.1.10. DirListBox

Kontrolka DirListBox wyświetla w sposób hierarchiczny listę dostępnych katalogówwraz ze ścieżkami dostępu do nich.


♦ Change — zmiana zawartości kontrolki

♦ Click — wciśnięcie przycisku myszy♦ DragDrop — zakończenie przecią gania obiektu













118






OLE drag/drop






Dostępne metody:








3.1.11. DriveListBox

Kontrolka DriveListBox wyświetla w sposób hierarchiczny listę dostępnych napędówdyskowych.


♦ Change — zmiana zawartości kontrolki











119






OLE drag/drop






Dostępne metody:








3.1.12. FileListBox

Kontrolka FileListBox wyświetla w sposób hierarchiczny listę dostępnych plikóww wybranym wcześniej katalogu (folderze).













120










OLE drag/drop





♦ PathChange — zmiana ścieżki dostępu

♦ PatternChange — zmiana maski plików


Dostępne metody:








3.1.13. Form

Obiekt Form jest częścią interfejsu użytkownika, stworzonego przez pisany program.

Można również tworzyć formy zawierają ce w sobie formy potomne (patrz 3.1.20).


♦ Activate — obiekt staje się aktywny





121


♦ DeActivate — obiekt staje się nieaktywny




♦ Initialize — tworzenie nowej instancji obiektu




♦ LinkClose — zakończenie konwersacji DDE

♦ LinkError — błą d konwersacji DDE

♦ LinkExecute — przesłanie do aplikacji źródła cią gu poleceń podczas

operacji dynamicznej wymiany danych (DDE)

♦ LinkOpen — inicjacja konwersacji DDE

♦ Load — załadowanie formy










OLE drag/drop


♦ OLESetData — brak danych w odpowiednim formacie dla komponentudocelowego w operacji OLE drag/drop


♦ Paint — odsłonięcie części obiektu

♦

QueryUnload — zamykana jest forma lub aplikacja♦ Resize — zmiana rozmiaru obiektu

♦ Terminate — usunięto wszystkie referencje obiektu

♦ UnLoad — usunięcie obiektu z pamięci




122

Dostępne metody:

♦ Circle — narysowanie elipsy, okręgu lub łuku na obiekcie

♦ Cls — wyczyszczenie grafik stworzonych na obiekcie

♦ Hide — ukrycie obiektu

♦ Line — narysowanie linii lub prostok ą ta na obiekcie



♦ PaintPicture — narysowanie zawartości pliku na obiekcie

♦ Point — pobranie wartości koloru RGB określonego punktu na obiekcie

♦ PopupMenu — wyświetlenie menu pop-up

♦ PrintForm — wydrukowanie obiektu na drukarce

♦ PSet — narysowanie punktu o określonym kolorze na obiekcie


♦ Scale — zdefiniowanie układu współrzędnych obiektu

♦ ScaleX — konwersja szerokości obiektu na inny rodzaj jednostek

♦ ScaleY — konwersja wysokości obiektu na inny rodzaj jednostek


♦ Show — wyświetlenie obiektu

♦ TextHeight — zwrócenie wysokości tekstu w aktualnie wybranej czcionce

♦ TextWidth — zwrócenie szerokości tekstu w aktualnie wybranej czcionce

♦ WhatsThisMode — włą czenie trybu What’s This?


3.1.14. Frame

Kontrolka Frame jest ramk ą , dzięki której można grupować inne kontrolki.









123




♦ OLECompleteDrag — poinformowanie komponentu docelowegoo zakończeniu operacji OLE drag/drop




OLE drag/drop





Dostępne metody:







3.1.15. HScroolBar

Kontrolka HScrollBar jest poziomym paskiem przewijania, pozwalają cym na nawi-gację różnorakimi listami. Po określeniu dopuszczalnych zakresów zmian kontrolki

może być wykorzystana jako wskaźnik wartości.





♦ GotFocus — otrzymanie fokusa♦ KeyDown — wciśnięcie klawisza






124



Dostępne metody:







3.1.16. Image

Kontrolki Image umożliwiają wyświetlanie obrazków graficznych (*.bmp, *.ico,

*.wmf , *.emf , *.jpeg, *.gif ).














OLE drag/drop








125

Dostępne metody:







3.1.17. Label

Kontrolka Label pozwala wyświetlić tekst bez możliwości jego modyfikacji.









♦ LinkNotify — zmiana danych konwersacji DDE









OLE drag/drop







126


Dostępne metody:


♦ LinkExecute — przesłanie do aplikacji źródła cią gu poleceń podczas operacji

dynamicznej wymiany danych (DDE)

♦ LinkPoke — przeniesienie zawartości obiektu do aplikacji źródła cią gu

poleceń podczas operacji dynamicznej wymiany danych (DDE)

♦ LinkRequest — żą danie od aplikacji źródła przesłania nowej zawartości

kontrolek podczas operacji dynamicznej wymiany danych (DDE)

♦ LinkSend — przeniesienie zawartości obiektu do aplikacji klienta (celu)

podczas operacji dynamicznej wymiany danych (DDE)


♦

OLEDrag — rozpoczęcie operacji drag/drop♦ Refresh — odświeżenie zawartości obiektu



3.1.18. Line

Kontrolka Line pozwala wstawiać na formularzu linie.

Dostępne metody:



3.1.19. ListBox

Kontrolka ListBox pozwala wyświetlić listę określonych elementów, aby umożliwićich wybór.









127


♦ ItemCheck — wybranie lub usunięcie elementu z listy










w operacji OLE drag/drop♦ OLEDragOver — przecią ganie jednego komponentu nad drugim w operacji

OLE drag/drop






Dostępne metody:

♦ AddItem — dodanie elementu do listy kontrolki

♦ Clear — wyczyszczenie zawartości kontrolki





♦ RemoveItem — usunięcie elementu z listy kontrolki


♦

ShowWhatsThis — wyświetlenie pomocy What’s This? ♦ ZOrder — zmiana kolejności z-order obiektów




128

3.1.20. MDIForm

Obiekt MDIForm jest częścią interfejsu użytkownika, stworzonego przez pisany pro-gram. Jest również formą zawierają cą w sobie formy potomne (kontenerem).


♦ Activate — obiekt staje się aktywny



♦ DeActivate — obiekt staje się nieaktywny



♦ Initialize — tworzenie nowej instancji obiektu






♦ Load — załadowanie formy









OLE drag/drop





♦ QueryUnload — zamykana jest forma lub aplikacja


♦ Terminate — usunięto wszystkie referencje obiektu




129

♦ UnLoad — usunięcie obiektu z pamięci

Dostępne metody:

♦ Arrange — ułożenie okien lub ikon wewną trz obiektu

♦ Hide — ukrycie obiektu



♦ PopupMenu — wyświetlenie menu pop-up


♦ Show — wyświetlenie obiektu

♦ WhatsThisMode — włą czenie trybu What’s This?


3.1.21. Menu

Kontrolka Menu tworzy w pisanej aplikacji standardowe menu, mogą ce zawierać po-lecenia, podmenu i separatory.



3.1.22. OLE

Kontrolka OLE pozwala na wstawianie do tworzonego programu obiektów z innych

aplikacji.













130






♦ Updated — zmiana danych obiektu

Dostępne metody:

♦ Close — zamknięcie obiektu

♦ Copy — kopiowanie danych do obiektu Clipboard

♦ CreatedEmbed — tworzenie obiektu osadzonego

♦ CreateLink — tworzenie obiektu połą czonego z pliku

♦ Delete — usunięcie obiektu

♦ DoVerb — otwarcie obiektu do wykonania operacji


♦ FetchVerbs — uaktualnienie listy akcji obiektu

♦ InsertObjDlg — wyświetlenie okna dialogowego Insert Object


♦ Paste — skopiowanie danych z obiektu Clipboard

♦ PasteSpecialDlg — wyświetlenie okna dialogowego Paste Special

♦

ReadFromFile — załadowanie obiektu z pliku♦ Refresh — odświeżenie zawartości obiektu

♦ SaveToFile — zapisanie obiektu do pliku

♦ SaveToOle1File — zapisanie obiektu do pliku w formacie OLE1

♦ SetFocus — przekazuje fokus obiektowi


♦ Update — pobranie nowych danych z aplikacji obiektu


3.1.23. OptionButton

Kontrolka OptionButton daje użytkownikowi możliwość dokonania wyboru opcji (wybórmoże paść tylko na jedną ). Wyświetla znak potwierdzenia przy wybranej opcji.




131



















OLE drag/drop





Dostępne metody:






♦

ShowWhatsThis — wyświetlenie pomocy What’s This? ♦ ZOrder — zmiana kolejności z-order obiektów




132

3.1.24. Panel

Obiekt Panel jest panelem używanym zazwyczaj do pokazywania bieżą cego stanuaplikacji (jest jej paskiem stanu).

Zdarzeń i metod brak

3.1.25. PictureBox

Kontrolki Image umożliwiają wyświetlanie obrazków graficznych (*.bmp, *.ico,

*.wmf , *.emf , *.jpeg, *.gif ).


♦

Change — zmiana wartości kontrolki♦ Click — wciśnięcie przycisku myszy






















133

♦ OLEDragOver — przecią ganie jednego komponentu nad drugim w operacjiOLE drag/drop

♦ OLEGiveFeedback — zakończono zdarzenie OLEDragOver w operacjiOLE drag/drop



♦ Paint — odsłonięcie części obiektu


Dostępne metody:



♦ Drag — rozpocz

ęcie, zako

ńczenie lub przerwanie przeci

ą gania kontrolki


♦ LinkExecute — przesłanie do aplikacji źródła cią gu poleceń podczas operacji

dynamicznej wymiany danych (DDE)















♦

ScaleY — konwersja wysokości obiektu na inny rodzaj jednostek♦ SetFocus — przeniesienie fokusa na kontrolk ę






134



3.1.26. PrinterObiekt Printer pozwala na komunikację z zainstalowaną w systemie drukark ą .

Dostępne metody:


♦ EndDoc — kończy drukowanie i zwalnia drukark ę

♦ KillDoc — przerwanie bieżą cego wydruku


♦ NewPage — rozpoczyna drukowanie nowej strony








3.1.27. ProgressBar

Kontrolka ProgressBar stosowana jest zazwyczaj do graficznego pokazywania stop-nia zaawansowania w wykonaniu różnych operacji.












135




OLE drag/drop





Dostępne metody:






3.1.28. Shape

Kontrolka Shape służy do narysowania takich figur geometrycznych, jak: prostok ą t,kwadrat, owal, koło, prostok ą t lub kwadrat o zaokrą glonych rogach.

Dostępne metody:




3.1.29. Slider

Kontrolka Slider jest suwakiem i służy do zmiany określonych wartości w tworzonymprogramie.









136













♦

OLEDragOver — przecią ganie jednego komponentu nad drugim w operacjiOLE drag/drop




♦ Scroll — przewinięcie kontrolki

Dostępne metody:

♦ ClearSel — wyczyszczenie zaznaczenia


♦ GetNumTicks — pobranie liczby znaczników







3.1.30. SSTab

Kontrolka SSTab umożliwia tworzenie standardowych zakładek, gdzie na każdej z nichmożna umieszczać inne kontrolki.




137


♦ Click — kliknięcie na zakładce

















OLE drag/drop





Dostępne metody:






♦

ZOrder — zmiana kolejności z-order obiektów




138

3.1.31. StatusBar

Kontrolka StatusBar jest paskiem stanu tworzonej aplikacji, używanym zazwyczaj dopokazywania bieżą cego stanu aplikacji.














OLE drag/drop





♦ PanelClick — wciśnięcie przycisku myszy nad panelem

♦ PanelDblClick — podwójne wciśnięcie przycisku myszy nad panelem

Dostępne metody:










139

3.1.32. TabStrip

Kontrolka TabStrip umożliwia tworzenie standardowych zakładek, gdzie na każdej z nichmożna umieszczać inne kontrolki.


♦ BeforeClick — kliknięcie zakładki





















Dostępne metody:









140



3.1.33. TextBoxKontrolka TextBox jest polem tekstowym, do którego użytkownik może sam wpro-wadzić wartości lub edytować już wyświetlane.
























OLE drag/drop







141


Dostępne metody:











♦

OLEDrag — rozpoczęcie operacji drag/drop♦ Refresh — odświeżenie zawartości obiektu




3.1.34. ToolBar

Kontrolka Toolbar zawiera kolekcję obiektów Button i służy do tworzenia pasków na-rzędziowych dla tworzonej aplikacji.


♦ ButtonClick — kliknięcie przycisku Button

♦ Change — zakończenie dostosowywania kontrolki przez użytkownika











142






OLE drag/drop





Dostępne metody:

♦ Customize — wywołanie okna dialogowego Customize




♦ Refresh — odświeżenie zawartości obiektu RestoreToolbar, odtworzenie

stanu począ tkowego kontrolki

♦ SaveToolbar — zapisanie ustawień kontrolki w pliku



3.1.35. TimerKontrolka Timer jest niewidoczna podczas działania programu i służy do wykonywa-nia jakiegokolwiek kodu programu w ściśle określonych odstępach czasu.


♦ Timer — minięcie określonego przedziału czasu

3.1.36. UpDown

Kontrolka UpDown, za pomocą swych dwóch przycisków, pozwala użytkownikowi

na zmianę wartości w kontrolce powią zanej (zwiększanie lub zmniejszanie).


♦ Change — zmiana bieżą cej wartości




143

♦ DownClick — wciśnięcie dolnego przycisku kontrolki












♦

OLEDragOver — przecią ganie jednego komponentu nad drugim w operacjiOLE drag/drop




♦ UpClick — wciśnięcie górnego przycisku kontrolki

Dostępne metody:



♦ OLEDrag (ActiveX) — rozpoczęcie operacji drag/drop




3.1.37. UserControl

Obiekt UserControl jest obiektem bazowym dla tworzenia kontrolek ActiveX.


♦ AccessKeyPress — wciśnięcie klawiszy dostępu kontrolki

♦ AmbientChanges — zmiana właściwości ambient




144

♦ AsyncReadComplete — odczyt danych z pliku lub adresu URL




♦ DragOver — przecią ganie obiektu EnterFocus otrzymania fokusa

♦ ExitFocus — utracenie fokusa


♦ Hide — zmiana właściwości Visible

♦ Initialize — tworzenie nowej instancji obiektu InitProperties,utworzenie kontrolki














♦ Paint — odsłonięcie części obiektu ReadProperties, załadowanie starejinstancji obiektu

♦ Resize — zmiana rozmiaru obiektu Show (UserControl), zmiana właściwościVisible

♦ Terminate — usunięto wszystkie referencje obiektu WriteProperties,

zapisanie instancji obiektu

Dostępne metody:

♦ AsyncRead — czytanie danych z pliku lub adresu URL




145

♦ CancelAsyncRead — przerwanie odczytywania danych

CanPropertyChange, zapytanie o możliwość zmiany właściwościpołą czonej







♦ PopupMenu — wyświetlenie menu pop-up PropertyChanged,poinformowanie pojemnika o zmianie właściwości






♦ SetFocus — przeniesienie fokusa na kontrolk ę Size, zmiana rozmiarówkontrolki



3.1.38. VScrollBar

Kontrolka VScrollBar jest pionowym paskiem przewijania, pozwalają cym na nawiga-cję różnorakimi listami. Po określeniu dopuszczalnych zakresów zmian kontrolki mo-

że być wykorzystana jako wskaźnik wartości.












146



Dostępne metody:







3.2. Właściwości kontrolek standardowych

3.2.1. Action

Właściwość Action określa (lub zwraca) rodzaj wyświetlanego okna dialogowego.

Nie jest dostępna na etapie projektowania.

Składnia:

obiekt. Action [= wartość]

gdzie:

♦ obiekt — obiekt wykorzystują cy tę właściwość,

♦ wartość — określenie rodzaju wyświetlanego okna dialogowego.

Wartości dostępne dla argumentu wartość:

Wartość Opis

0 brak okna

1 okno Open

2 okno SaveAs

3 okno Color

4 okno Font

5 okno Printer

6 uruchamia WINHLP32.EXE




147

3.2.2. ActionControl

Właściwość ActionControl wskazuje kontrolk ę „aktywną ” (posiadają cą fokus)

lub — w przypadku wywoływania formy — wskazuje kontrolk ę, która posiadała fo-

kus, gdy ta forma była aktywna.

Składnia:

obiekt. ActiveControl

gdzie:

♦ obiekt — obiekt wykorzystują cy tę właściwość.

3.2.3. ActiveForm

Właściwość ActiveForm wskazuje formę „aktywną ” (posiadają cą fokus).

Składnia:

obiekt. ActiveForm [= Wartość]

gdzie:


♦ wartość — określenie sposobu wyświetlania okna dialogowego.

3.2.4. Align

Właściwość Align określa (lub zwraca) miejsce wyświetlania obiektu na ekranie.

Składnia:

obiekt. Align [=wartość]

gdzie:


♦ wartość — określenie sposobu wyświetlania okna dialogowego.

Wartości i stałe dostępne dla argumentu wartość:


vbAlignNone 0 Domyślna (oprócz MDIForm, przez które jest ignorowana)

vbAlignTop 1 Domyślna dla form MDIForm. Położenie u góry formy




148

vbAlignBotto

m2 Położenie u dołu formy

vbAlignLeft 3 Położenie z lewej strony formy

vbAlignRight 4 Położenie z prawej strony formy

3.2.5. Alignment

Właściwość Alignment określa (lub zwraca) miejsce wyświetlania obiektu na ekra-

nie.

Składnia:

obiekt. Alignment [=wartość]

gdzie:


♦ wartość — określenie rodzaju wyświetlanego okna dialogowego.

Wartości i stałe dostępne dla argumentu wartość (dla kontrolek CheckBox i Option-

Button):


vbLeftJustif

y0 Domyślna. Tekst wyrównany do lewej. Kontrolka wyrównana do prawej

vbRightJusti

fy1 Tekst jest wyrównany do prawej. Kontrolka wyrównana do lewej

Wartości i stałe dostępne dla argumentu wartość (dla kontrolek Label i TextBox):


vbLeftJustif

y0 Domyślna. Tekst wyrównany do lewej

vbRightJusti

fy1 Tekst wyrównany do prawej

vbcenter 2 Tekst wyrównany do środka

Wartości i stałe dostępne dla argumentu wartość (dla kontrolki DBGrid ):


dbgLeft 0 Tekst wyrównany do lewej




149

dbgRight 1 Tekst wyrównany do prawej

dbgcenter 2 Tekst wyrównany do środka

dbgGeneral 2 Domyślna. Tekst wyrównany do lewej, liczby wyrównane do prawej

3.2.6. Appearance

Właściwość Appearance określa (lub zwraca) sposób wyświetlania kontrolek.

Składnia:

obiekt. Appearance

gdzie:


Wartości właściwości Appearance:

Wartość Opis

0 Kontrolki i formy są wyświetlane w sposób płaski

1 Domyślna. Kontrolki są wyświetlane z efektem trójwymiarowości

3.2.7. Archive

Właściwość Archive określa (lub zwraca) wartość, określają cą , czy kontrolka File-

ListBox wyświetla pliki z atrybutem Archive.

Składnia:

obiekt. Archive [=boolean]

gdzie:


♦ boolean — wyrażenie typu Boolean określają ce sposób wyświetlania

plików (True — domyślny, pozwala na wyświetlanie, False — nie pozwala).

3.2.8. AutoRedrawWłaściwość AutoRedraw określa (lub zwraca) wartość, określają cą sposób auto-

matycznego odtwarzania grafiki stworzonej przez metody graficzne.




150

Składnia:

obiekt. AutoRedraw [=boolean]

gdzie:



grafiki (True — domyślny, pozwala na automatyczne wyświetlanie, False —

nie pozwala).

3.2.9. AutoShowChildren

Właściwość AutoShowChildren określa (lub zwraca) wartość, określają cą , czy for-

my potomne MDIChild są automatycznie wyświetlane po załadowaniu.

Składnia:

obiekt. AutoShowChildren [=boolean]

gdzie:



grafiki (True — pozwala na automatyczne odtwarzanie grafiki, False —

domyślny, nie pozwala).

3.2.10. AutoSize

Właściwość AutoSize określa (lub zwraca) wartość, określają cą , czy kontrolka auto-matycznie zmienia swój rozmiar, dostosowują c go do pokazania całej swej zawartości.

Składnia:

obiekt. AutoSize [=boolean]

gdzie:



grafiki (True — pozwala na automatyczne dostosowanie rozmiaru, False —

domyślny, nie pozwala, zachowują c ustawiony wcześniej rozmiar).

3.2.11. BackColor

Właściwość BackColor określa (lub zwraca) kolor tła obiektu.




151

Składnia:

obiekt.BackColor [=color ]

gdzie:


♦ color — wartość lub stała, określają ca kolor tła obiektu.

Wartości i stałe dostępne dla argumentu color :


vbBlack &H0 czarny

vbRed &HFF czerwony

vbGreen &HFF00 zielony

vbYellow &HFFFF żółty

vbBlue &HFF0000 niebieski

vbMagenta &HFF00FF magenta

vbCyan &HFFFF00 morski

vbWhite &HFFFFFF biały

vbScrollBars &H80000000 kolor pasków przewijania

vbDesktop &H80000001 kolor pulpitu

vbActiveTitleBar &H80000002 kolor aktywnego paska tytułu

vbInactiveTitleBar &H80000003 kolor nieaktywnego paska tytułu

vbMenuBar &H80000004 kolor menu

vbWindowBackground &H80000005 kolor tła okna


vbWindowFrame &H80000006 kolor obramowania okna

vbMenuText &H80000007 kolor tekstu w menu

vbWindowText &H80000008 kolor tekstu w oknie

vbTitleBarText &H80000009 kolor tekstu paska tytułowego

vbActiveBorder &H8000000A kolor ramki aktywnego okna

vbInactiveBorder &H8000000B kolor ramki nieaktywnego okna

vbApplicationWorkspace

&H8000000C kolor tła aplikacji wykorzystują cej MDIForm

vbHighlight &H8000000D kolor tła wybranych elementów kontrolki

vbHighlightText &H8000000E kolor tekstu wybranych elementów




152

vbButtonFace &H8000000F kolor przycisków

vbButtonShadow &H80000010 kolor cieniowania przycisków

vbGrayText &H80000011 kolor niedostępnego tekstu

vbButtonText &H80000012 kolor tekstu przycisków

vbInactiveCaptionTe

xt&H80000013 kolor tekstu nieaktywnej etykiety narzędzi

vb3DHighlight &H80000014 kolor podświetlonych elementów 3D

vb3DDKShadow &H80000015 ciemny kolor cieniowania elementów 3D

vb3DLight &H80000016 drugi jaśniejszy kolor elementów 3D

vb3DFace &H8000000F kolor tekstu 3D

vb3Dshadow &H80000010 kolor cieniowania tekstu

vbInfoText &H80000017 kolor tekstu podpowiedzi

vbInfoBackground &H80000018 kolor tła podpowiedzi

3.2.12. BorderColor

Właściwość BorderColor określa (lub zwraca) kolor obramowania obiektu.

Składnia:

obiekt.BorderColor [=color ]

gdzie:


♦ color — wartość lub stała określają ca kolor tła obiektu (patrz 3.2.12).

3.2.13. BorderStyle

Właściwość BorderStyle określa (lub zwraca) rodzaj obramowania obiektu.

Składnia:

obiekt.BorderStyle [=obramowanie]

gdzie:


♦ obramowanie — wartość lub stała określają ca rodzaj obramowania obiektu.

Wartości i stałe dostępne dla argumentu obramowanie (dla kontrolki Form):




153


vbBSNone 0 Brak obramowania

vbFixedSingle 1 Obramowanie pojedyncze cią głe. Może zawierać menu kontroli,pasek tytułowy, przycisk Maksymalizuj i przycisk Minimalizuj.

Rozmiar można zmieniać, tylko używają c przycisków

Maksymalizuj i Minimalizuj

vbSizable 2 Domyślna. Rozmiar obramowana można zmieniać

vbFixedDouble 3 Obramowanie może zawierać menu kontrolne i pasek tytułowy.

Nie może zawierać przycisków Maksymalizuj i Minimalizuj.

Bez możliwości zmiany rozmiaru

vbFixedToolWindow 4 Obramowanie zawiera przycisk Zamknij i pasek tytułowy

o zmniejszonym rozmiarze. Bez możliwości zmiany rozmiaru.

Forma z tym ustawieniem nie jest pokazywana na pasku zadań

vbSizableToolWind

ow

5 Obramowanie zawiera przycisk Zamknij i pasek tytułowy

o zmniejszonym rozmiarze. Jest możliwość zmiany rozmiaru.Forma z tym ustawieniem nie jest pokazywana na pasku zadań

Wartości dostępne dla argumentu obramowanie (dla kontrolek: Image, Label, OLE-

Container , PictureBox, Frame, TextBox):

Wartość Opis

0 Brak obramowania (dla kontrolek Image i Label — domyślne)

1 Obramowanie pojedyncze cią głe (dla kontrolek PictureBox, TextBox i OLEContainer

— domyślne)

Wartości i stałe dostępne dla argumentu obramowanie (dla kontrolek Line i Shape):


vbTransparent 0 Obramowanie przezroczyste

vbBSSolid 1 Obramowanie cią głe. Ramka jest położona centralnie na brzegu kształtu

vbBSDash 2 Obramowanie z kresek

vbBSDot 3 Obramowanie z kropek

vbBSDashDot 4 Obramowanie z kreska-kropka

vbBSDashDotDo

t 5 Obramowanie z kreska-kropka-kropka

vbBSInsideSol

id6

Obramowanie wewnętrzne cią głe. Zewnętrzna krawędź ramki pełni rolęzewnętrznej krawędzi kształtu




154

3.2.14. BorderWidth

Właściwość BorderWidth określa (lub zwraca) szerokość obramowania obiektu.

Składnia:

obiekt.BorderWidth [= wartość]

gdzie:


♦ wartość — wartość numeryczna określają ca szerokość obramowania

(1-8192).

3.2.15. Cancel

Właściwość Cancel określa (lub zwraca), czy przycisk poleceń w formie jest przyci-skiem Anuluj. Może to być kontrolka CommandButton lub inny obiekt wewną trz kon-

trolki OLEContainer , zachowują cy się jak przycisk poleceń.

Składnia:

obiekt.Cancel [=boolean]

gdzie:


♦ boolean — wartość określają ca, czy obiekt jest przyciskiem Cancel

(True — kontrolka CommandButton jest przyciskiem Cancel, False

— domyślne, nie jest).

3.2.16. Caption

Właściwość Caption określa napis, który jest wyświetlany na kontrolkach.

Składnia:

obiekt.Caption [=napis]

gdzie:


♦ napis — wyświetlany tekst.




155

3.2.17. Checked

Właściwość Checked określa (lub zwraca) wartość, określają cą , czy znak zaznacze-nia będzie wyświetlany obok polecenia w menu.

Składnia:

obiekt.Checked [= boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy ma być wyświetlany znacznik (True— znak zaznaczenia jest wyświetlany, False — domyślne, nie jest wyświetlany).

3.2.18. ClipControls

Właściwość ClipControls określa (lub zwraca) wartość, określają cą , czy metody gra-

ficzne w zdarzeniu Paint obrysowują cały obiekt, czy tylko nowo odsłonięty obszar (pozmianie rozmiarów lub po przesłonięciu innym oknem). Określa również, czy tworzy

się wycięty obszar, wyłą czają cy niegraficzne kontrolki zawarte w obiekcie.

Składnia:

obiekt.ClipControls [= boolean]

gdzie:


♦ boolean — wyrażenie określają ce zachowanie się obiektu (True — domyślne,

metody graficzne w zdarzeniu Paint odtwarzają cały obiekt, a wokółniegraficznych kontrolek na formie przed wykonaniem zdarzenia Paint jesttworzony wycięty obszar, False — metody graficzne w zdarzeniu Paintodtwarzają tylko nowo odsłonięty obszar, a wokół niegraficznych kontrolekna formie przed wykonaniem zdarzenia Paint nie jest tworzony wycięty obszar).

3.2.19. Columns (DBGrid)

Właściwość Columns dla kontrolki DBGrid zwraca jej kolekcję obiektów Column

jako typ Variant.

Składnia:

obiekt.Columns

gdzie:





156

3.2.20. Columns (ListBox)

Właściwość Columns dla kontrolki ListBox określa (lub zwraca) wartość, określają cą ,czy kontrolka ListBox może być przewijana pionowo lub poziomo oraz w ilu kolum-

nach wyświetlane są elementy listy. Jeżeli jest przewijana poziomo, właściwość Co-

lumns określa liczbę wyświetlanych kolumn.

Składnia:

obiekt.Columns [= Wartość]

gdzie:


♦ wartość — wyrażenie określają ce liczbę kolumn i sposób ich przewijania

(0 — domyślne, elementy są wyświetlane w jednej kolumnie i lista może byćprzewijana pionowo 1-N — elementy są wyświetlane w N kolumnach).

3.2.21. Container

Właściwość Container określa (lub zwraca) pojemnik (container) kontrolki.

Składnia:

obiekt.Container [= pojemnik]

gdzie:


♦ pojemnik — wyrażenie reprezentują ce obiekt, który może być pojemnikiemdla innych kontrolek (obiekt).

3.2.22. ControlBox

Właściwość ControlBox określa (lub zwraca) wartość, określają cą , czy menu kon-

troli zostanie wyświetlone na formie w czasie wykonywania programu.

Składnia:

obiekt.ControlBox [=boolean]

gdzie:♦ obiekt — obiekt wykorzystują cy tę właściwość,

♦ boolean — wartość określają ca sposób wyświetlania menu kontroli(True — domyślnie, wyświetla je na formie, False — nie wyświetla).




157

3.2.23. Controls

Właściwość Controls zwraca referencję do kolekcji Controls obiektu. Wykorzy-

stywana np. do zmiany właściwości wszystkich kontrolek danego typu.

Składnia:

obiekt.Controls

gdzie:


3.2.24. Count (VB Collections)

Właściwość Count (VB Collections) zwraca liczbę obiektów w kolekcji. Wyko-

rzystywana np. do zmiany właściwości wszystkich kontrolek danego typu.

Składnia:

obiekt.Count

gdzie:


3.2.25. CurrentX, CurrentY

Właściwości CurrentX i CurrentY określają (lub zwracają ) poziomą (CurrentX ) i

pionową (CurrentY ) współrzędną dla następnej metody drukują cej lub rysują cej.

Składnia:

obiekt.CurrentX [= X]

obiekt.CurrentY [= Y]

gdzie:


♦ X — wartość określają ca współrzędną poziomą ,

♦ Y — wartość określają ca współrzędną pionową .

3.2.26. Database

Właściwość Database zwraca referencję do obiektu Database, stworzonego przez

kontrolk ę Data.




158

Składnia:

obiekt.Database

Set obiektdatabase = obiekt.Database

Tylko edycje VB Professional i VB Enterprise.

gdzie:


♦ obiektdatabase — obiekt wykorzystują cy obiekt Database, stworzony

przez kontrolk ę Data.

3.2.27. DatabaseName

Właściwość DatabaseName określa (lub zwraca) nazwę i lokalizację źródła danych(baza danych) dla kontrolki Data.

Składnia:

obiekt.DatabaseName [=nazwa]

gdzie:


♦ nazwa — wyrażenie łańcuchowe, które określa nazwę i lokalizację (ścieżk ędostępu) pliku bazy danych lub nazwę źródła danych dla źródeł danychODBC.

3.2.28. DataChanged

Właściwość DataChanged określa (lub zwraca) wartość, określają cą , czy dane kontrolki

połą czonej zmieniły się przez inny proces niż otrzymanie danych z bieżą cego rekordu.

Składnia:

obiekt.DataChanged [=wartość]

gdzie:


♦ wartość — wyrażenie określają ce, czy dane się zmieniły (True — danew kontrolce są inne niż dane w bieżą cym rekordzie, False — domyślne,

są takie same).




159

3.2.29. DataField

Właściwość DataField określa (lub zwraca) wartość, przypisują cą kontrolk ę do pola

w bieżą cym rekordzie.

Składnia:

obiekt.DataField [=wartość]

gdzie:


♦ wartość — wyrażenie określają ce nazwę jednego z pól w obiekcie

Recordset, określonego przez właściwości RecordSource i

DatabaseName.

3.2.30. DataSourceWłaściwość DataSource powią zuje kontrolk ę z polem w bazie danych poprzez

określenie odpowiedniej kontrolki Data. Nie można ustawiać tej właściwości w ko-dzie programu, tylko w fazie projektowania.

3.2.31. Default

Właściwość Default określa (lub zwraca) wartość, określają cą , która kontrolka

CommandButton jest domyślnym przyciskiem.

Składnia:

obiekt.Default [=Boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy przycisk poleceń jest przyciskiemdomyślnym (True — kontrolka jest przyciskiem domyślnym, False — domyślne, nie jest).

3.2.32. DisabledPicture

Właściwość DisabledPicture określa (lub zwraca) referencję do wyświetlanej gra-fiki, gdy kontrolka jest wyłą czona (właściwość Enabled = False).




160

Składnia:

obiekt.DisabledPicture [=Obraz]

gdzie:


♦ obraz — obiekt Picture zawierają cy grafik ę do wyświetlenia.

3.2.33. DownPicture

Właściwość DownPicture określa (lub zwraca) referencję do wyświetlanej grafiki,gdy kontrolka jest wciśnięta (stale).

Składnia:

obiekt.DownPicture [=Obraz]

gdzie:


♦ obraz — obiekt Picture zawierają cy grafik ę do wyświetlenia.

3.2.34. DragIcon

Właściwość DragIcon określa (lub zwraca) ikonę, wyświetlaną jako wskaźnik przyoperacjach drag/drop (przecią gnij-upuść).

Składnia:

obiekt.DragIcon [=Ikona]

gdzie:


♦ ikona — odwołanie do ikony.

3.2.35. DragMode

Właściwość DragMode określa (lub zwraca) wartość, określają cą , czy będzie używa-

ny ręczny, czy automatyczny tryb operacji drag/drop (przecią gnij-upuść).

Składnia:obiekt.DragMode [=wartość]

gdzie:




161


♦ wartość — wartość określają ca tryb przecią gania (0 — domyślnie, ręczny

wymaga użycia metody Drag, aby zainicjować operację drag/drop,

1 — automatyczny, kliknięcie automatycznie powoduje wykonanie

operacji drag/drop).

3.2.36. DrawMode

Właściwość DrawMode określa (lub zwraca) wartość, określają cą wyglą d zewnętrzny

kontrolki Line lub Shape, lub ustawienia dla metod graficznych.

Składnia:

obiekt.DrawMode [=wygląd ]

gdzie:


♦ wygląd — wyrażenie określają ce wyglą d zewnętrzny.

Wartości i stałe dostępne dla argumentu Wygląd :


vbBlackness 1 czarny

vbNotMergePen 2 Not Merge pen

vbMaskNotPen 3 Not Mask pen

vbNotCopyPen 4 Not Copy pen

vbMaskPenNot 5 Mask pen Not

vbInvert 6 inwersja

vbXorPen 7 Xor pen

vbNotMaskPen 8 Not Mask pen

vbMaskPen 9 Mask pen


vbNotXorPen 10 Not Xor pen

vbNop 11 bez zmian

vbMergeNotPen 12 Merge Not pen

vbCopyPen 13 Copy pen

vbMergePenNot 14 Merge pen Not

vbMergePen 15 Merge pen




162

vbWhiteness 16 biały

3.2.37. DrawStyle

Właściwość DrawStyle określa (lub zwraca) wartość, określają cą rodzaj rysowanej

linii dla metod graficznych.

Składnia:

obiekt.DrawStyle [=wartość]

gdzie:


♦ wartość — wyrażenie określają ce rodzaj linii.



vbSolid 0 cią gła

vbDash 1 kreska

vbDot 2 kropka

vbDashDot 3 kreska-kropka

vbDashDotDot 4 kreska-kropka-kropka

vbInvisible 5 niewidoczna

vbInsideSolid6 wewnętrzna cią gła

3.2.38. DrawWidth

Właściwość DrawWidth określa (lub zwraca) szerokość linii rysowanych przez me-

tody graficzne.

Składnia:

obiekt.DrawWidth [=rozmiar ]

gdzie:


♦ rozmiar — wartość określają ca szerokość rysowanej linii w pikselach

(1 – 32 767).




163

3.2.39. Drive

Właściwość Drive określa (lub zwraca) wybrany dysk w czasie wykonywania programu.

Składnia:

obiekt.Drive [= Dysk]

gdzie:


♦ dysk — wyrażenie określają ce literę dysku.

3.2.40. Enabled

Właściwość Enabled określa (lub zwraca) wartość, określają cą , czy kontrolka ma re-

agować na zdarzenia generowane przez użytkownika.

Składnia:

obiekt.Enabled [= Boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy obiekt ma reagować na zdarzenia

generowane przez użytkownika, czy też nie.

3.2.41. FileNameWłaściwość FileName określa (lub zwraca) ścieżk ę i nazwę wybranego pliku.

Składnia:

obiekt.FileName [= plik]

gdzie:


♦ plik — nazwa pliku wraz ze ścieżk ą dostępu do niego.

3.2.42. FillColor

Właściwość FillColor określa (lub zwraca) kolor, którym są wypełniane kształty

oraz figury stworzone przez metody graficzne Circle i Line.




165

3.2.44. Font

Właściwość Font zwraca obiekt typu Font, którego właściwości można zmieniać.

Składnia:obiekt.Font

gdzie:


3.2.45. FontBold

Właściwości: FontBold, FontItalic, FontStrikethru i FontUnderline okre-ślają (lub zwracają ) styl czcionek.

Składnia:obiekt.FontBold [= Boolean]

obiekt.FontItalic [= Boolean]obiekt.FontStrikethru [= Boolean]

obiekt.FontUnderline [= Boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy czcionka ma przyjąć wskazywanystyl (True — ma przyjąć, False — nie przyjmuje).

3.2.46. FontItalicPatrz 3.2.45.

3.2.47. FontName

Właściwość FontName określa (lub zwraca) rodzaj czcionki używanej do wyświetla-nia tekstu w kontrolkach.

Składnia:

obiekt.FontName [= Czcionka]

gdzie:


♦ czcionka — nazwa czcionki przeznaczonej do użycia.




166

3.2.48. FontSize

Właściwość FontSize określa (lub zwraca) rozmiar czcionki używanej do wyświe-tlania tekstu w kontrolkach.

Składnia:

obiekt.FontSize [= rozmiar ]

gdzie:


♦ rozmiar — rozmiar czcionki (w punktach).

3.2.49. FontStrikethru

Patrz 3.2.45.

3.2.50. FontTransparent

Właściwość FontTransparent określa (lub zwraca) wartość, określają cą , czy

tekst i grafiki, będą ce w tle czcionki, są wyświetlane w bliskiej przestrzeni wokółniej.

Składnia:

obiekt.FontTransparent [= Boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy przycisk poleceń jest przyciskiemdomyślnym (True — domyślnie, wyświetla tekst i grafik ę w tle w przestrzeniwokół znaków, False — nie wyświetla).

3.2.51. FontUnderline

Patrz 3.2.45.

3.2.52. ForeColor

Właściwość ForeColor określa (lub zwraca) kolor tekstu i grafiki obiektu.




167

Składnia:

obiekt.ForeColor [= kolor ]

gdzie:


♦ kolor — wartość określają ca, jaki kolor ma być użyty do wypełnianiakształtów (patrz 3.2.11).

3.2.53. hDC

Właściwość hDC zwraca uchwyt (handle) dostarczony przez system operacyjny MS

Windows do kontekstu urzą dzenia obiektu (połą czenie pomiędzy aplikacją Windows,

sterownikiem urzą dzenia i wyjściem urzą dzenia wejścia-wyjścia).

Składnia:

obiekt.hDC

gdzie:


3.2.54. Hidden

Właściwość Hidden określa (lub zwraca) wartość, określają cą , czy kontrolka FileLi-

stBox wyświetla pliki z atrybutem Hidden.

Składnia:

obiekt. Archive [=boolean]

gdzie:



plików (True — pozwala na wyświetlanie, False — domyślny, nie pozwala).

3.2.55. Height

Właściwość Height określa (lub zwraca) wysokość obiektu lub kolumny w kontrolce

DBGrid .




169

gdzie:


♦ boolean — wyrażenie określają ce stan podświetlenia tekstu po utracie

fokusa przez kontrolk ę (True — domy

ślnie, b

ędzie pod

świetlony, False — niebędzie).

3.2.59. Icon

Właściwość Icon zwraca ikonę, wyświetlaną , gdy obiekt form jest minimalizowany.

Składnia:

obiekt.Icon

gdzie:


3.2.60. Image

Właściwość Image zwraca uchwyt (handle) dostarczony przez system operacyjny MS

Windows do stałej grafiki (wyjście z metody graficznej, przechowywane w pamięci).

Składnia:

obiekt.Image

gdzie:


3.2.61. Index (ActiveX)

Właściwość Index określa (lub zwraca) wartość, określają cą numer obiektu w kolekcji.

Składnia:

obiekt.Index

gdzie:





171

3.2.65. ItemData

Właściwość ItemData określa (lub zwraca) wartość dla każdego elementu kontrolek

ComboBox i ListBox.

Składnia:

obiekt.ItemData(Indeks) [= Wartość]

gdzie:


♦ index — numer elementu w danym obiekcie,

♦ wartość — wartości określają ce liczbę milisekund pomiędzy wystą pieniami

zdarzenia Timer.

3.2.66. KeyPreview

Właściwość KeyPreview określa (lub zwraca) wartość, która określa, czy zdarzenia

klawiatury dla formy są wywoływane przed zdarzeniami klawiatury dla kontrolek.

Składnia:

obiekt.KeyPreview [=boolean]

gdzie:


♦ boolean — wartości określają ce, jak zdarzenia zostaną odebrane (True

— najpierw zdarzenie odbierze forma, a potem aktywna kontrolka, False — domyślne, aktywna kontrolka odbierze zdarzenie, a forma go nie odbierze).

3.2.67. LargeChange

Właściwość LargeChange określa (lub zwraca) wartość zmiany właściwości Va-

lue pasków przewijania HScrollBar i VScrollBar podczas kliknięcia przez użytkow-

nika w obszarze między strzałkami przewijania.

Składnia:

obiekt.LargeChange [= wartość]

gdzie:





172

♦ wartość — liczba całkowita określają ca wartość zmiany właściwości

Value.

3.2.68. LeftWłaściwość Left określa (lub zwraca) odległość pomiędzy wewnętrzną lewą krawę-

dzią obiektu a lewą krawędzią obiektu, w którym on się zawiera.

Składnia:

obiekt.Left [= wartość]

gdzie:


♦ wartość — liczba określają ca odległość.

3.2.69. LinkItem

Właściwość LinkItem określa (lub zwraca) dane przesyłane do kontrolki docelo-

wej w czasie konwersacji z inną aplikacją (DDE).

Składnia:

obiekt.LinkItem [= wartość]

gdzie:


♦ wartość — wyrażenie określają ce dane przesyłane do kontrolki docelowej.

3.2.70. LinkMode

Właściwość LinkMode określa (lub zwraca) typ połą czenia używanego przy konwer-

sacjach DDE i aktywuje połą czenie.

1. Gdy celem konwersacji DDE są kontrolki — kontrolce docelowej pozwala

na formie zainicjować konwersację określoną przez właściwości LinkTopic

i LinkItem.

2. Gdy źródłem konwersacji DDE są formy — aplikacji docelowej pozwala

zainicjować konwersację z formą źródłową .




173

Składnia:

obiekt.LinkMode [= wartość]

gdzie:


♦ wartość — wyrażenie określają ce typ połą czenia.

Wartości i stałe dostępne dla argumentu wartość, gdy celem konwersacji DDE są kontrolki:


vbLinkNone 0 (Domyślna) brak współdziałania DDE

vbLinkAutomati

c1 Automatyczny — kontrolka docelowa zostaje automatycznie

uaktualniana za każdym razem, gdy zmieniają się połą czone dane

vbLinkManual 2 Ręczny — kontrolka docelowa jest uaktualniana tylko po wywołaniumetody LinkRequest

vbLinkNotify 3 Informacyjny — po zmianie danych połą czonych wywoływane jest

zdarzenie LinkNotify, a kontrolka docelowa zostaje uaktualniana

tylko po wywołaniu metody LinkRequest

Wartości i stałe dostępne dla argumentu wartość, gdy źródłem konwersacji DDE

są formy:


vbLinkNone 0 (Domyślna) brak współdziałania DDE

vbLinkSource

1 Kontrolki Label, PictureBox, TextBox będą ce na formie, mogą dostarczaćdane do aplikacji docelowej, która ustanowiła konwersację DDE z formą

Jeżeli połą czenie już istnieje, obiekt docelowy zostaje automatycznie

poinformowany, kiedy zawartość kontrolek się zmieni

Aplikacja docelowa może przesłać tak że dane do kontrolek Label, PictureBox,

TextBox na formie

3.2.71. LinkTimeout

Właściwość LinkTimeout określa (lub zwraca) wartość, określają cą czas oczekiwa-

nia kontrolki na odpowiedź wiadomości DDE.




174

Składnia:

obiekt.LinkTimeout [= wartość]

gdzie:


♦ wartość — liczba określają ca czas oczekiwania (1 sekunda = 10).

3.2.72. LinkTopic

Właściwość LinkTopic określa (lub zwraca):

1. Gdy celem konwersacji DDE są kontrolki — aplikację docelową i tematpołą czenia (podstawowy zbiór danych używanych w aplikacji).

2. Gdy źródłem konwersacji DDE są formy — temat dla formy źródłowej,

odpowiadają cej na konwersację DDE.

Składnia:

obiekt.LinkTopic [= wartość]

gdzie:


♦ wartość — wyrażenie określają ce element DDE.

3.2.73. List

Właściwość List określa (lub zwraca) pozycję zawartą w części listy kontrolki (jestona tablicą , w której każdy element jest pozycją listy).

Składnia:

obiekt.List (Indeks) [= pozycja]

gdzie:


♦ index — liczba określają ca pozycję na liście,

♦ pozycja — wyrażenie określają ce pozycję listy.

3.2.74. ListCount

Właściwość ListCount zwraca liczbę pozycji części listy kontrolki.




175

Składnia:

obiekt.ListCount

gdzie:


3.2.75. ListIndex

Właściwość ListIndex określa (lub zwraca) indeks aktualnie zaznaczonej pozy-

cji w kontrolce.

Składnia:

obiekt.ListIndex [= Indeks]

gdzie:


♦ index — liczba określają ca indeks aktualnej pozycji w liście (–1 — żadna

pozycja nie jest zaznaczona, N — zaznaczona jest pozycja o indeksie N).

3.2.76. Locked

Właściwość Locked określa (lub zwraca) wartość, określają cą , kiedy kontrolka może

być edytowana.

Składnia:

obiekt.Locked [= wartość]

gdzie:


♦ wartość — wartość określają ca, kiedy kontrolka może być edytowana

(–1 — żadna pozycja nie jest zaznaczona, N — zaznaczona jest pozycja

o indeksie N).

3.2.77. MaskColor

Właściwość MaskColor określa (lub zwraca) kolor w obrazie przycisku, który zosta-

nie zamaskowany (będzie przezroczysty).




177

Składnia:

obiekt. MaxLength [=wartość]

gdzie:


♦ wartość — liczba całkowita, określają ca liczbę znaków.

3.2.81. MDIChild

Właściwość MDIChild określa (lub zwraca) wartość, określają cą , czy forma jest for-

mą potomną (MDIChild).

Składnia:

obiekt. MDIChild [=boolean]

gdzie:


♦ boolean — wartość określają ca, czy forma jest formą potomną (True — forma jest formą potomną , False — domyślne, nie jest).

3.2.82. Min

Właściwość Min określa (lub zwraca) dopuszczalną minimalną wartość właściwości

Value.

Składnia:

obiekt. Min [= wartość]

gdzie:


♦ wartość — liczba określają ca minimalną wartość (0 – 32000).

3.2.83. MinButton

Właściwość MinButton określa (lub zwraca) wartość, określają cą , czy forma posiada

przycisk Minimalizacji.




179

vbCrosshair 2 Krzyżyk (+)

vbIbeam 3 Prosta kreska (kursor)

vbIconPointer 4 Ikona

vbSizePointer 5 Poczwórna strzałka wskazują ca północ, południe, wschód i zachód

vbSizeNESW 6 Podwójna strzałka wskazują ca północny wschód i południowy zachód

vbSizeNS 7 Podwójna strzałka wskazują ca północ i południe

vbSizeNWSE 8 Podwójna strzałka wskazują ca północny zachód i południowy wschód

vbSizeWE 9 Podwójna strzałka wskazują ca zachód i wschód

vbUpArrow 10 Strzałka w górę

vbHourglass 11 Klepsydra (ikona wskazują ca czekanie)

vbNoDrop 12 Ikona wskazują ca niedostępność

vbArrowHourgla

ss13 Strzałka i klepsydra

vbArrowQuestio

n14 Strzałka i znak zapytania

vbSizeAll 15 Zmiana wszystkich rozmiarów

vbCustom 99 Ikona użytkownika określona przez właściwość MouseIcon

3.2.86. Moveable

Właściwość Moveable określa (lub zwraca) wartość, określają cą , czy obiekt może

być przemieszczany.

Składnia:obiekt. Moveable [=wartość]

gdzie:


♦ wartość — wartość określają ca, czy obiekt może być przemieszczany

(True lub –1 — obiekt może być przemieszczany, False lub 0 — nie może).

3.2.87. MultiLine

Właściwo

ść MultiLine okre

śla (lub zwraca) warto

ść, okre

ślaj

ą c

ą , czy kontrolkaTextBox może zawierać i wyświetlić wiele wierszy tekstu.




180

Składnia:

obiekt. MultiLine [=boolean]

gdzie:


♦ boolean — wartość określają ca, czy w kontrolce może wystą pić wielewierszy tekstu (True — może wystą pić, False — domyślne, może wystą pićtylko jeden).

3.2.88. MultiSelect

Właściwość MultiSelect określa (lub zwraca) wartość, określają cą , czy użytkownik

może dokonywać wyboru wielu elementów za jednym razem w kontrolkach FlieList-

Box i ListBox oraz jak ten wielokrotny wybór będzie przeprowadzany.

Składnia:

obiekt. MultiSelect [=wartość]

gdzie:


♦ wartość — wartość określają ca, czy można dokonywać wyboru wielu

elementów za jednym razem.

Wartości dostępne dla argumentu wartość:

Wartość Opis

0 (Domyślna) wielokrotny wybór niedozwolony

1 Prosty wielokrotny wybór. Kliknięcie myszy lub przyciśnięcie SPACE zaznacza lub

odznacza pozycję na liście, a klawisze strzałek przesuwają wyróżnienie

2 Rozszerzony wielokrotny wybór. Przyciśnięcie SHIFT i kliknięcie myszy lub SHIFT

i jednego z klawiszy rozszerza selekcję z poprzednio zaznaczonej pozycji do obecnej

pozycji w liście. Przyciśnięcie CTRL i kliknięcie myszy zaznacza lub odznacza pozycjęw liście

3.2.89. Name

Właściwość Name określa (lub zwraca) nazwę używaną w kodzie do obiektu albo na-zwę czcionki obiektu.




181

Składnia:

obiekt. Name [=nazwa]

gdzie:


♦ nazwa — nazwa obiektu lub czcionki.

3.2.90. Negotiate

Właściwość Negotiate ustala wartość (True, False), określają cą , czy kontrolka wy-

równana właściwością Align może być wyświetlana na formie zawierają cej paski na-

rzędzi (toolbars). Dostępna tylko w fazie projektowania.

3.2.91. NegotiateMenus

Właściwość NegotiateMenus ustala wartość, określają cą , czy pasek menu na formie

zawiera menu formy i menu aktywnego w danym momencie obiektu do edycji. Do-

stępna tylko w fazie projektowania.

3.2.92. NegotiatePosition

Właściwość NegotiatePosition ustala wartość, określają cą , czy kontrolki Menu

niższych poziomów będą wyświetlane na pasku menu, gdy aktywny jest obiekt osa-dzony lub połą czony na formie i wyświetla swoje menu. Dostępna tylko w fazie projek-

towania.

Wartości dostępne dla właściwości NegotiatePosition:

Wartość Opis

0 (Domyślna) Menu nie jest wyświetlane na pasku menu

1 Menu wyświetlane jest z lewej strony menu

2 Menu wyświetlane jest w środku menu

3 Menu wyświetlane jest z prawej strony menu

3.2.93. NegotiateToolbarsWłaściwość NegotiateToolbars ustala wartość (True, False), określają cą , czy pa-

ski narzędziowe aktywnego obiektu aktywnej formy potomnej MDIChild są wyświe-

tlane na formie — rodzicu (MDIForm). Dostępna tylko w fazie projektowania




182

3.2.94. NewIndex

Właściwość NewIndex zwraca indeks ostatnio dodanego elementu kontrolek Com-

boBox i ListBox.

Składnia:

obiekt. NewIndex

gdzie:


3.2.95. Normal

Właściwość Normal określa (lub zwraca) wartość, określają cą , czy kontrolka FileLi-

stBox wyświetla pliki z atrybutem Normal.

Składnia:

obiekt. Normal [=boolean]

gdzie:


♦ boolean — wyrażenie określają ce sposób wyświetlania plików

(True — domyślny, pozwala na wyświetlanie, False — nie pozwala).

3.2.96. OLEDragMode

Właściwość OleDragMode określa (lub zwraca) wartość, określają cą , czy operacje

OLE drag/drop będą obsługiwane przez komponent, czy też przez programistę.

Składnia:

obiekt.OLEDragMode [=wartość]

gdzie:


♦ wartość — wyrażenie określają ce sposób obsługiwania operacji OLEdrag/drop.






183

vbOLEDragManual 0 (Domyślna) wszystkie operacje OLE drag/drop obsługuje programista

vbOLEDragAutomat

ic1 Wszystkie operacje OLE drag/drop obsługiwane są automatycznie

3.2.97. OLEDropMode

Właściwość OleDropMode określa (lub zwraca) wartość, określają cą sposób przechwy-

tywania operacji drop przez komponent docelowy.

Składnia:

obiekt.OLEDropMode [=wartość]

gdzie:


♦ wartość — wyrażenie określają ce metodę przechwytywania operacjidrag/drop przez komponent.



vbOLEDropNone 0 (Domyślna) komponent docelowy nie akceptuje OLE drop

i wyświetla kursor No Drop

vbOLEDropManual 1 Komponent docelowy wywołuje zdarzenia OLE drop, pozwalają cprogramiście na obsługę operacji OLE drop w kodzie programu


vbOLEDropAutoma

tic2 Komponent docelowy akceptuje OLE drop, jeżeli obiekt DataObject

zawiera dane w formacie przez niego rozpoznawanym. Jeżeli

OLEDropMode jest ustawione navbOLEDropAutomatic, zdarzenia

myszy lub OLE drag/drop nie są wywoływane

3.2.98. Palette

Właściwość Palette określa (lub zwraca) obraz, który zawiera paletę używaną przez

kontrolk ę.

Składnia:

obiekt.Palette [= plik]

gdzie:




184


♦ plik — nazwa i ścieżka dostępu do pliku zawierają cego paletę.

3.2.99. PaletteModeWłaściwość PaletteMode określa (lub zwraca) wartość, określają cą , jaka paleta zo-

stanie wykorzystana przez kontrolki obiektu.

Składnia:

obiekt.PaletteMode [= wartość]

gdzie:


♦ wartość — wyrażenie określają ce używaną paletę.



vbPaletteModeHalfTo

ne0 (Domyślna) systemowej palety półtonów

vbPaletteModeUseZOr

der1 Paleta z najwyżej w porzą dku znajdują cej się kontrolki

posiadają cej paletę

vbPaletteModeCustom 2 Paleta określona we właściwości Palette

vbPaletteModeContai

ner3 Paleta containerów dla containerów obsługują cych właściwość

Palette


vbPaletteModeNone 4 Brak użycia jakiejkolwiek z palet

vbPaletteModeObject 5 Paleta projektanta ActiveX

3.2.100. Parent

Właściwość Parent zwraca formę, obiekt lub kolekcję, zawierają cą kontrolk ę, obiekt

lub kolekcję.

Składnia:obiekt.Parent

gdzie:




185


3.2.101. PasswordChar

Właściwość PasswordChar określa (lub zwraca) wartość, określają cą znaki wyświe-

tlane w kontrolce TextBox podczas wpisywania tekstu przez użytkownika.

Składnia:

obiekt.PasswordChar [= wartość]

gdzie:


♦ wartość — wyrażenie określają ce wyświetlane znaki.

3.2.102. Path

Właściwość Path określa (lub zwraca) ścieżk ę dyskową .

Składnia:

obiekt.Path [= ścieżka]

gdzie:


♦ ścieżka — wyrażenie określają ce ścieżk ę dyskową .

3.2.103. Pattern

Właściwość Pattern określa (lub zwraca) mask ę plików wyświetlanych w kontrolce

FileListBox.

Składnia:

obiekt.Pattern [= wartość]

gdzie:


♦ wartość — wyrażenie określają ce wyświetlane pliki (np. *.*, *.arj lub*.doc). Domyślnym ustawieniem jest *.*, czyli wszystkie pliki.




187

Składnia:

obiekt.ScaleHeight [= wartość]

gdzie:


♦ wartość — wyrażenie numeryczne określają ce pionowy wymiar.

3.2.107. ScaleLeft

Właściwość ScaleLeft określa (lub zwraca) poziomą współrzędną dla lewej i górnej

krawędzi obiektu.

Składnia:

obiekt.ScaleLeft [= wartość]

gdzie:


♦ wartość — wyrażenie numeryczne określają ce poziomą współrzędną .Wartością domyślną jest 0.

3.2.108. ScaleMode

Właściwość ScaleMode określa (lub zwraca) wartość, określają cą jednostk ę miary

dla współrzędnych obiektu.

Składnia:obiekt.ScaleMode [= wartość]

gdzie:


♦ wartość — liczba (całkowita) określają ca jednostk ę miary.



vbUser 0 Wskazuje, że przynajmniej jedna z właściwości ScaleHeight,

ScaleWidth, ScaleLeft lub ScaleTop jest już ustawiona

vbTwips 1 (Domyślna) jednostka miary to twip (1440 twipów = 1 cal, 567 twipów =

1 centymetr)




188

vbPoints 2 Jednostka miary to punkt (72 punkty = 1 cal)

vbPixels 3 Jednostka miary to piksel

vbCharacter

s4 Jednostka miary to znak (poziomo = 120 twipów na jednostk ę, pionowo =

240 twipów na jednostk ę)

vbInches 5 Jednostka miary to cal

vbMilimeter

s6 Jednostka miary to milimetr

vbCentimete

rs7 Jednostka miary to centymetr

3.2.109. ScaleTop

Właściwość ScaleTop określa (lub zwraca) pionową współrzędną dla lewej i górnej

krawędzi obiektu.

Składnia:

obiekt.ScaleTop [= wartość]

gdzie:


♦ wartość — wyrażenie numeryczne określają ce pionową współrzędną .Wartością domyślną jest 0.

3.2.110. ScaleWidth

Właściwość ScaleWidth określa (lub zwraca) liczbę poziomego, wewnętrznego

wymiaru obiektu.

Składnia:

obiekt.ScaleWidth [= wartość]

gdzie:


♦ wartość — wyrażenie numeryczne określają ce pionowy wymiar.

3.2.111. ScrollBars

Właściwość ScrollBars określa (lub zwraca) wartość, określają cą , czy obiekt ma

poziomy lub pionowy pasek przewijania.




189

Składnia:

obiekt.ScrollBars [= wartość]

gdzie:


♦ wartość — wyrażenie określają ce, czy obiekt ma pasek przewijania.

Wartości dostępne dla argumentu wartość (dla obiektu MDIForm):

Wartość Opis

True (Domyślna) forma ma poziomy lub pionowy pasek przewijania, lub obydwa — zależnie

od potrzeb

False Forma nie posiada pasków przewijania

Wartości i stałe dostępne dla argumentu wartość (dla kontrolki TextBox):

Stałe Wartość Opis

vbSBNone 0 (Domyślna) brak pasków przewijania

vbHorizonta

l1 Kontrolka posiada poziomy pasek przewijania

vbVertical 2 Kontrolka posiada pionowy pasek przewijania

vbBoth 3 Kontrolka posiada obydwa paski przewijania

3.2.112. SellCountWłaściwość SellCount zwraca liczbę zaznaczonych pozycji w kontrolce ListBox.

Składnia:

obiekt.SellCount

gdzie:


3.2.113. Selected

Właściwość Selected określa (lub zwraca) status zaznaczenia pozycji w kontrolce

ListBox i FileListBox.




190

Właściwość niedostępna na etapie projektowania.

Składnia:

obiekt.Selected (Indeks) [= Boolean]

gdzie:


♦ index — numer indeksu pozycji w kontrolce,

♦ boolean — wyrażenie określają ce, czy pozycja na liście jest zaznaczona

(True — pozycja na liście jest zaznaczona, False — domyślne, nie jest).

3.2.114. SelLength

Właściwość SelLenght określa (lub zwraca) liczbę zaznaczonych znaków.

Składnia:

obiekt.SelLength[= ile]

gdzie:


♦ ile — liczba (całkowita) określają ca liczbę zaznaczonych znaków

(od 0 do maksymalnej długości tekstu).

3.2.115. SelStartWłaściwość SelStart określa (lub zwraca) liczbę zaznaczonych znaków.

Składnia:

obiekt.SelStart[= index ]

gdzie:


♦ index — liczba (całkowita) określają ca począ tek zaznaczanego tekstu.

3.2.116. SelText

Właściwość SelText określa (lub zwraca) zaznaczony tekst lub pusty łańcuch w

przypadku braku zaznaczenia




191

Składnia:

obiekt.SelText[= wartość]

gdzie:


♦ wartość — wyrażenie łańcuchowe zawierają ce zaznaczony tekst.

3.2.117. Shape

Właściwość Shape określa (lub zwraca) wartość, określają cą wyglą d kontrolki Sha-

pe.

Składnia:

obiekt.Shape[= wartość]

gdzie:


♦ wartość — wyrażenie określają ce wyglą d kontrolki.



vbShapeRectangle 0 kształt prostok ą ta

vbShapeRectangle 1 kształt kwadratu

vbShapeOval 2 kształt owalu

vbShapeCircle 3 kształt koła

vbShapeRoundedRectan

gle4 kształt prostok ą ta o zaokrą glonych rogach

vbShapeRoundedSquare 5 kształt kwadratu o zaokrą glonych rogach

3.2.118. Shortcut

Właściwość Shortcut określa klawisz dostępu dla obiektu Menu. Dostępna tylko w

fazie projektowania.




192

3.2.119. ShowInTaskbar

Właściwość ShowInTaskbar określa (lub zwraca) wartość (True, False), określają -cą , czy ikona obiektu Form pojawi się w systemowym pasku zadań.

Składnia:

obiekt.ShowInTaskbar

gdzie:


3.2.120. SmallChange

Właściwość SmallChange określa (lub zwraca) wartość zmiany właściwości Value

pasków przewijania HScrollBar i VScrollBar podczas kliknięcia przez użytkownika

na strzałk ę przewijania.

Składnia:

obiekt.SmallChange [= wartość]

gdzie:


♦ wartość — liczba całkowita określają ca wartość zmiany właściwości

Value.

3.2.121. SortedWłaściwość Sorted określa (lub zwraca) wartość (True, False), określają cą , czy ele-

menty kontrolki będą automatycznie sortowane wg alfabetu.

Składnia:

obiekt.ShowInTaskbar

gdzie:


3.2.122. Stretch

Właściwość Stretch określa (lub zwraca) wartość, określają cą , czy grafika zmienia

rozmiar, dopasowują c się do rozmiaru kontrolki Image.




195

3.2.126. TabIndex

Właściwość TabIndex określa (lub zwraca) kolejność przechodzenia między obiek-

tami klawiszem Tab.

Składnia:

obiekt.TabIndex[= index ]

gdzie:


♦ index — liczba (całkowita) (0 — liczba obiektów – 1).

3.2.127. TabStop

Właściwość TabStop określa (lub zwraca) wartość, określają cą , czy można używaćklawisza TAB w stosunku do obiektu.

Składnia:

obiekt.TabStop [=boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy obiekt może otrzymać fokus poprzezużycie klawisza TAB (True — domyślny, może otrzymywać, False — obiekt jest omijany).

3.2.128. Tag

Właściwość Tag określa (lub zwraca) wyrażenie, przechowują ce dodatkowe dane po-trzebne dla programu.

Składnia:

obiekt.Tag [= wartość]

gdzie:


♦ wartość — wyrażenie identyfikują ce obiekt.




196

3.2.129. Text

Właściwość Text określa (lub zwraca) tekst wyświetlany w kontrolce.

Składnia:obiekt.Text [= tekst]

gdzie:


♦ tekst — wyświetlany tekst.

3.2.130. ToolTipText

Właściwość ToolTipText określa (lub zwraca) tekst podpowiedzi, pojawiają cy się

po zatrzymaniu wskaźnika myszy nad obiektem.

Składnia:

obiekt.ToolTipText [= tekst]

gdzie:


♦ tekst — wyświetlany tekst podpowiedzi.

3.2.131. Top

Właściwość Top określa (lub zwraca) odległość pomiędzy wewnętrzną górną krawę-

dzią obiektu a górną krawędzią obiektu, w którym on się zawiera.

Składnia:

obiekt.Top [= wartość]

gdzie:


♦ wartość — liczba określają ca odległość.

3.2.132. TopIndex

Właściwość TopIndex określa (lub zwraca) wartość, określają cą , który element listy

jest wyświetlany na pierwszej pozycji.




197

Składnia:

obiekt.TopIndex [= index ]

gdzie:


♦ index — liczba (całkowita) określają ca numer elementu listy wyświetlanego

na pierwszej pozycji.

3.2.133. UseMaskColor

Właściwość UseMaskColor określa (lub zwraca) wartość, określają cą , czy kolor skoja-

rzony z właściwością MaskColor jest używany jako maska (tworzą c przezroczyste ob-

szary).

Składnia:

obiekt.UseMaskColor [= boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy kolor jest używany jako maska (True

— kolor jest używany jako maska, False — domyślny, kolor jest ignorowany).

3.2.134. UseMnemonic

Właściwość UseMnemonic określa (lub zwraca) wartość, określają cą , czy znak „&”, do-

łą czony do właściwości Caption kontrolki, definiuje klawisz skrótu klawiaturowego.

Składnia:

obiekt.UseMnemonic [= boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy kontrolka posiada klawisz skrótu

klawiaturowego (True — znak „&” we właściwości Caption powoduje,

iż znak następny staje się klawiszem skrótu klawiaturowego, False

— domyślny, każdy znak „&” we właściwości Caption jest ignorowany).




198

3.2.135. Value

Właściwość Value dla kontrolki CheckBox i OptionButton określa (lub zwraca) stan

kontrolki. Dla kontrolki CommandButton określa (lub zwraca) wartość, określają cą ,

czy przycisk jest wybrany. Dla kontrolek HScrollBar i VScrollBar określa (lub zwra-ca) aktualnie wskazywaną wartość przez pasek przewijania.

Składnia:

obiekt. Value [= wartość]

gdzie:


♦ wartość — wartość określają ca pozycję lub stan kontrolki.

3.2.136. VisibleWłaściwość Visible określa (lub zwraca) wartość, określają cą , czy obiekt jest wi-

doczny, czy ukryty dla użytkownika.

Składnia:

obiekt. Visible [= boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy obiekt jest widoczny, czy też nie

(True — domyślnie, obiekt jest widoczny, False — obiekt jest ukryty).

3.2.137. WhatsThisButton

Właściwość WhatsThisButton określa (lub zwraca) wartość (True, False), określa-

ją cą , czy przycisk What’s This? pojawia się na pasku tytułowym formy.

Składnia:

obiekt. WhatsThisButton

gdzie:





199

3.2.138. WhatsThisHelp

Właściwość WhatsThisHelp określa (lub zwraca) wartość, określają cą , czy pomoc kon-

tekstowa używa menu pop-up What’s This? systemu operacyjnego, czy głównej pomocy.

Składnia:

obiekt. WhatsThisHelp [= boolean]

gdzie:


♦ boolean — wyrażenie określają ce, czy używane jest menu pop-up What’s

This? (True — techniki What’s This? są wykorzystywane do uruchamianiapomocy, False — domyślne, do wywołania pomocy wykorzystywany jestklawisz F1).

3.2.138. WhatsThisHelpID

Właściwość WhatsThisHelpID określa (lub zwraca) wartość, określają cą numerkontekstu w pliku pomocy, wywoływany dla obiektu.

Składnia:

obiekt. WhatsThisHelpID [= indeks]

gdzie:


♦ indeks — liczba (całkowita) określają ca numer kontekstu w pomocy.

3.2.139. Width

Właściwość Width określa (lub zwraca) wysokość obiektu lub kolumny w kontrolce

DBGrid.

Składnia:

obiekt. Width [=szerokość]

gdzie:


♦ szerokość — wartość określają ca szerokość obiektu lub kolumny.




200

3.2.140. WindowList

Właściwość WindowList określa (lub zwraca) wartość (True, False), określają cą ,czy obiekt Menu zawiera listę okien MDIChild obiektu MDIForm.

Składnia:

obiekt. WindowList

gdzie:


3.2.142. WindowState

Właściwość WindowState określa (lub zwraca) wartość, określają cą sposób wyświe-

tlania okna formy.

Składnia:

obiekt. WindowState [= wartość]

gdzie:


♦ wartość — wartość określają ca sposób wyświetlania okna obiektu.



vbNormal 0 (Domyślna) wyświetlane standardowo

vbMinimize

d1 Wyświetlane jako zminimalizowane do ikony

vbMaximize

d2 Wyświetlane jako zmaksymalizowane do rozmiaru ekranu

3.2.143. WordWrap

Właściwość WordWrap określa (lub zwraca) wartość, określają cą rozmiar kontrolki

Label dostosowuje się automatycznie do rozmiaru tekstu w sobie zawartego.

Składnia:

obiekt. WordWrap [= boolean]

gdzie:




201


♦ boolean — wyrażenie określają ce, czy kontrolka dopasowuje swój rozmiar

automatycznie (True — dopasowuje się jedynie do kroju i rozmiaru czcionki

(pionowo), False — dopasowuje się zarówno do kroju i rozmiaru czcionki,

jak i do rozmiaru tekstu (pionowo i poziomo).

3.2.144. X1, Y1 — X2,Y2

Właściwości X1, Y1 określają (lub zwracają ) współrzędne punktu począ tkowego, a wła-

ściwości X2, Y2 określają (lub zwracają ) współrzędne punktu końcowego kontrolki Line.

Składnia:

obiekt.X1 [= wartość]

gdzie:


♦ wartość — wartość określają ca współrzędną .

3.3. Zdarzenia kontrolek standardowych

3.3.1. Activate

Zdarzenie Activate jest generowane, gdy obiekt staje się aktywny.

Składnia:

Private Sub obiekt _ Activate ()

gdzie:

♦ obiekt — obiekt wykorzystują cy to zdarzenie.

3.3.2. Change

Zdarzenie Change jest generowane, jeżeli zmieni się zawartość obiektu.

Składnia:

Private Sub obiekt _ Change ([Indeks As Integer])

gdzie:




202

♦ obiekt — obiekt wykorzystują cy to zdarzenie,

♦ indeks — wartość określają ca element sterują cy w tablicy elementów

sterują cych.

3.3.3. Click

Zdarzenie Click jest generowane, gdy nastą pi kliknięcie myszy (naciśnięcie i zwol-

nienie przycisku).

Składnia:

Private Sub Form_Click()Private Sub obiekt _ Click ([Indeks As Integer])

gdzie:


♦ indeks — wartość określają ca element sterują cy w tablicy elementów sterują cych.

3.3.4. DblClick

Zdarzenie DblClick jest generowane, gdy nastą pi podwójne kliknięcie myszy (po-dwójne naciśnięcie i zwolnienie przycisku).

Składnia:

Private Sub Form_DblClick()

Private Sub obiekt _ DblClick ([Indeks As Integer])

gdzie:♦ obiekt — obiekt wykorzystują cy to zdarzenie,

♦ indeks — wartość określają ca element sterują cy w tablicy elementówsterują cych.

3.3.5. DeActivate

Zdarzenie DeActivate jest generowane, gdy obiekt przestaje być obiektem aktyw-nym.

Składnia:

Private Sub obiekt _ DeActivate ()

gdzie:





203

3.3.6. DragDrop

Zdarzenie DragDrop jest generowane zaraz po zakończeniu przecią gania obiektu lub

po użyciu metody Drag z argumentem Czynność ustawionym na 2 (vbEndDrag).

Składnia:

Private Sub Form_DragDrop(Źródło As Control, X As Single, Y As

Single)Private Sub MDIForm_DragDrop(Źródło As Control, X As Single, Y As

Single)

Private Sub obiekt _DragDrop([Indeks As Integer,] Źródło As Control, X

As Single, Y As Single)

gdzie:



sterują cych,

♦ źródło — przecią gany element,

♦ x, y — współrzędne kursora myszy w chwili zakończenia przecią gania.

3.3.7. DragOver

Zdarzenie DragOver jest generowane podczas przecią gania obiektu nad innym obiektem.

Składnia:

Private Sub Form_DragOver (Źródło As Control, X As Single, Y As

Single, Stan As Integer)

Private Sub MDIForm_DragOver(Źródło As Control, X As Single, Y AsSingle, Stan As Integer)

Private Sub obiekt _DragOver ([Indeks As Integer,] Źródło As Control,

X As Single, Y As Single, Stan As Integer)

gdzie:


♦ indeks — wartość określają ca element sterują cy w tablicy elementówsterują cych,

♦ źródło — przecią gany element,

♦ x , y — współrzędne kursora myszy w chwili zakończenia przecią gania,

♦ stan — aktualny stan przecią gania (0 — Enter , obiekt wszedł nad „cel”,1 — Leave, obiekt jest poza „celem”, 2 — Over , obiekt jest nad „celem”).




204

3.3.8. DropDown

Zdarzenie DropDown jest generowane, gdy w ComboBox rozwijamy listę. Nie zacho-

dzi, gdy właściwość Style jest ustawiona na 1.

Składnia:

Private Sub obiekt _ DropDown ([Indeks As Integer])

gdzie:



sterują cych.

3.3.9. Error

Zdarzenie Error jest generowane, gdy wystą pi błą d dostępu do danych podczas wy-konywania programu.

Składnia:

Private Sub obiekt _ Error ([Indeks As Integer,] Błąd As Integer,Odpowied ź As Integer)

gdzie:



♦ błąd — numer błędu,

♦ odpowied ź — wartość określają ca numer odpowiedzi, jaka ma wystą pićna dany błą d.

3.3.10. GotFocus

Zdarzenie GotFocus jest generowane, gdy obiekt staje się aktywny (gdy jego wła-

ściwości Enabled i Visible są ustawione na True (–1).

Składnia:

Private Sub Form_GotFocus()Private Sub obiekt _ GotFocus ([Indeks As Integer])

gdzie:





205


3.3.11. Initialize

Zdarzenie Initialize jest generowane, gdy aplikacja tworzy instancję Form, MDI-

Form, PropertyPage, UserControl lub klasy.

Składnia:

Private Sub obiekt _ Initialize()

gdzie:


♦ indeks — wartość określają ca element sterują cy w tablicy elementów sterują cych.

3.3.12. ItemCheck

Zdarzenie ItemCheck jest generowane, gdy właściwość Style kontrolki ListBox jest

ustawiona na 1 (checkboxes) i element z listy w kontrolce ListBox zostanie wybrany

lub skasowany.

Składnia:

Private Sub obiekt _ ItemCheck ([Indeks As Integer])

gdzie:



sterują cych.

3.3.13. KeyDown

Zdarzenie KeyDown jest generowane po naciśnięciu klawisza.

Składnia:

Private Sub Form_KeyDown (Kod As Integer, Stan As Integer)

Private Sub obiekt _ KeyDown ([Indeks As Integer,] Kod As Integer, Stan

As Integer)

gdzie:





206


sterują cych,

♦ kod — kod reprezentują cy wciśnięty klawisz,

♦

stan — wartość określają ca stan klawiszy Shift , Ctrl i Alt (1 — SHIFT ,2 — CTRL, 4 — ALT ).

Wartości te mogą być dodawane, co oznaczać będzie wciśnięcie jakiejś kombinacji tych

przycisków.

3.3.14. KeyPress

Zdarzenie KeyPress jest generowane po naciśnięciu i zwolnieniu klawisza.

Składnia:

Private Sub Form_KeyPress (ZnakAscii As Integer)

Private Sub obiekt _KeyPress ([Indeks As Integer,] ZnakAscii As

Integer)

gdzie:



sterują cych,

♦ znakAscii — kod ASCII reprezentują cy wciśnięty klawisz.

3.3.15. KeyUpZdarzenie KeyUp jest generowane po zwolnieniu klawisza.

Składnia:

Private Sub Form_KeyUp (Kod As Integer, Stan As Integer)

Private Sub obiekt _KeyUp ([Indeks As Integer,] Kod As Integer, Stan

As Integer)

gdzie:



sterują cych,

♦ kod — kod reprezentują cy wciśnięty klawisz,




207

♦ stan — wartość określają ca stan klawiszy Shift , Ctrl i Alt (1 — SHIFT ,

2 — CTRL, 4 — ALT ).


przycisków.

3.3.16. LinkClose

Zdarzenie LinkClose jest generowane, gdy nastą pi zakończenie konwersacji DDE.

Składnia:

Private Sub Form_LinkClose()

Private Sub MDIForm_LinkClose()

Private Sub obiekt _ LinkClose ([Indeks As Integer])

gdzie:



sterują cych.

3.3.17. LinkError

Zdarzenie LinkError jest generowane, gdy nastą pi błą d podczas konwersacji DDE.

Składnia:

Private Sub Form_LinkError (Numer As Integer)Private Sub MDIForm_LinkError (Numer As Integer)

Private Sub obiekt _LinkError ([Indeks As Integer,] Numer As Integer)

gdzie:



♦ numer — numer błędu.

Wartości dostępne dla argumentu numer :

Numer bł ędu Opis

1 Żą danie danych w złym formacie przez inną aplikację

6 Inna aplikacja próbuje konwersacji DDE mimo ustawienia LinkMode na 0




208

7 Wszystkie połą czenia ze źródłem są zajęte (maksymalnie 128 połą czeń z jednym

źródłem)

8 Dla kontrolek — błą d uaktualnienia danych w kontrolce po automatycznym

połą czeniu lub użyciu metody LinkRequest, dla form — nieudana próba

wystawienia danych przez kontrolk ę11 Zbyt mało pamięci dla wykonania konwersacji DDE

3.3.18. LinkExecute

Zdarzenie LinkExecute jest generowane, gdy w konwersacji DDE aplikacja typu klient

przekazuje do aplikacji typu server jako polecenia do wykonania łańcuch CmdStr .

Składnia:

Private Sub obiekt _LinkExecute (CmdStr As String, Cancel As Integer)

gdzie:


♦ cmdStr — polecenie do wykonania wysłane przez aplikację typu klient,

♦ cancel — wartość określają ca, czy polecenie zostało zaakceptowane(0 — tak, inna wartość — nie, standardowo — (–1).

3.3.19. LinkNotify

Zdarzenie LinkNotify jest generowane, gdy aplikacja będą ca źródłem zmienia dane

określone przez połą czenie DDE, jeżeli właściwość LinkMode aplikacji klienta jest

ustawiona na 3.

Składnia:

Private Sub obiekt _ LinkNotify ([Indeks As Integer])

gdzie:



sterują cych.

3.3.20. LinkOpenZdarzenie LinkOpen jest generowane, gdy konwersacja DDE jest inicjowana.




209

Składnia:

Private Sub Form_LinkOpen (Cancel As Integer)

Private Sub MDIForm_LinkOpen (Cancel As Integer)

Private Sub obiekt _ LinkOpen ([Indeks As Integer,] Cancel As Integer)

gdzie:



♦ cancel — wartość określają ca, czy polecenie zostało zaakceptowane(0 — tak, inna wartość — nie, standardowo — (–1).

3.3.21. Load

Zdarzenie Load jest generowane, gdy forma jest wczytywana.

Składnia:

Private Sub Form_Load ()

Private Sub MDIForm_Load ()

3.3.22. LostFocus

Zdarzenie LostFocus jest generowane, gdy obiekt przestaje być aktywny.

Składnia:

Private Sub Form_LostFocus()

Private Sub obiekt _ LostFocus ([Indeks As Integer])

gdzie:



3.3.23. MouseDown

Zdarzenie MouseDown jest generowane, gdy następuje wciśnięcie przycisku myszy.

Składnia:

Private Sub Form_MouseDown (Klawisz As Integer, Stan As Integer, X As

Single, Y As Single)

Private Sub MDIForm_MouseDown (Klawisz As Integer, Stan As Integer, X





210

Private Sub obiekt _ MouseDown ([Indeks As Integer,] Klawisz As

Integer, Stan As Integer, X As Single, Y As Single)

gdzie:



♦ klawisz — wartość reprezentują ca wciśnięty klawisz myszy,

♦ x , y — współrzędne kursora myszy,

♦ stan — wartość określają ca stan klawiszy Shift , Ctrl i Alt (1 — SHIFT ,2 — CTRL, 4 — ALT ).


przycisków.

Wartości i stałe dostępne dla argumentu klawisz:


vbLeftButton 1 Przyciśnięty lewy klawisz myszy

vbRightButto

n2 Przyciśnięty prawy klawisz myszy

vbMiddleButt

on4 Przyciśnięty środkowy klawisz myszy

Wartości i stałe dostępne dla argumentu stan:


vbShiftMa

sk1 Wybrany klawisz SHIFT

vbCtrlMas

k2 Wybrany klawisz CTRL

vbAltMask 4 Wybrany klawisz ALT

3.3.24. MouseMove

Zdarzenie MouseMove jest generowane podczas przesuwania wskaźnika myszy.




211

Składnia:

Private Sub Form_MouseMove (Klawisz As Integer, Stan As Integer, X As


Private Sub MDIForm_MouseMove (Klawisz As Integer, Stan As Integer, X


Private Sub obiekt _ MouseMove ([Indeks As Integer,] Klawisz As

Integer, Stan As Integer, X As Single, Y As Single)

gdzie:



sterują cych,




2 — CTRL, 4 — ALT ).


przycisków.

Wartości i stałe dostępne dla argumentu klawisz: patrz 3.3.23.

Wartości i stałe dostępne dla argumentu stan: patrz 3.3.23.

3.3.25. MouseUp

Zdarzenie MouseUp jest generowane, gdy następuje zwolnienie przycisku myszy.

Składnia:

Private Sub Form_MouseUp (Klawisz As Integer, Stan As Integer, X As


Private Sub MDIForm_MouseUp (Klawisz As Integer, Stan As Integer, X


Private Sub obiekt _ MouseUp ([Indeks As Integer,] Klawisz As Integer,

Stan As Integer, X As Single, Y As Single)

gdzie:








212


2 — CTRL, 4 — ALT ).


przycisków.

Wartości i stałe dostępne dla argumentu klawisz: patrz 3.3.23.

Wartości i stałe dostępne dla argumentu stan: 3.3.23.

3.3.26. Paint

Zdarzenie Paint jest generowane, gdy dotychczas zakryta część lub całość obiektu

zostanie odsłonięta.

Składnia:Private Sub Form_Paint()

Private Sub obiekt _ Paint ([Indeks As Integer])

gdzie:



sterują cych.

3.3.27. PathChange

Zdarzenie PathChange jest generowane, gdy nastą piła zmiana właściwości FileNa-me lub Path (w wyniku zmiany ścieżki dostępu do pliku).

Składnia:

Private Sub obiekt _ PathChange ([Indeks As Integer])

gdzie:



sterują cych.

3.3.28. PatternChange

Zdarzenie PatternChange jest generowane, gdy nastą piła zmiana właściwości Fi-

leName lub Pattern (w wyniku zmiany maski nazwy pliku).




213

Składnia:

Private Sub obiekt _ PatternChange ([Indeks As Integer])

gdzie:



3.3.29. QueryUnload

Zdarzenie QueryUnload jest generowane tuż przed zamknięciem formy lub aplikacji.

Składnia:

Private Sub Form_QueryUnload (Cancel As Integer, UnloadMode As

Integer)

Private Sub MDIForm_QueryUnload (Cancel As Integer, UnloadMode As

Integer)

gdzie:

♦ cancel — wartość określają ca, czy ma nastą pić zamknięcie (0 — pozwala,inna wartość — nie),

♦ unloadMode — wartość określają ca przyczynę wywołania zdarzenia.

Wartości i stałe dostępne dla argumentu unloadMode:


vbFormControlMenu

0 Użytkownik wybrał komendę Close z menu Control formy

vbFormCode 1 Została wywołana instrukcja Unload w kodzie programu


vbAppWindows 2 Aktualna sesja Microsoft Windows jest zamykana

vbAppTaskManager 3 Aplikację zamyka Task Manager systemu operacyjnego

vbFormMDIForm 4 Zamykana jest forma-potomek ( MDIChild ), ponieważ została

zamknięta forma-rodzic ( MDIForm)

3.3.30. Reposition

Zdarzenie Reposition jest generowane, gdy rekord staje się rekordem aktywnym.




214

Składnia:

Private Sub obiekt _ Reposition ([Indeks As Integer])

gdzie:



3.3.31. Resize

Zdarzenie Resize jest generowane przy zmianie rozmiaru obiektu.

Składnia:

Private Sub Form_Resize()

Private Sub obiekt _Resize (Wysokość As Single, Szerokość As Single)

gdzie:


♦ wysokość — wartość określają ca nową wysokość obiektu,

♦ szerokość — wartość określają ca nową szerokość obiektu.

3.3.32. Scroll

Zdarzenie Scroll jest generowane, gdy pasek przewijania (pionowy lub poziomy)

jest używany.

Składnia:

Private Sub dbgrid_Scroll (Cancel As Integer)

Private Sub obiekt _ Scroll()

gdzie:


♦ cancel — wartość określają ca nową wysokość obiektu.

3.3.33. Terminate

Zdarzenie Terminate jest generowane, gdy wszystkie odwołania do instancji obiektulub klasy zostaną usunięte z pamięci poprzez ustawienie wszystkich zmiennych od-wołują cych się do obiektu na wartość Nothing lub gdy ostatnia referencja do obiektuwychodzi poza zasięg zmiennych.




215

Składnia:

Private Sub obiekt _ Terminate()

gdzie:


3.3.34. Timer

Zdarzenie Timer jest generowane w określonych odstępach czasu, gdy odstęp ten jest

ustawiony we właściwości Interval kontrolki Timer .

Składnia:

Private Sub obiekt _ Timer ([Indeks As Integer])

gdzie:



3.3.35. Unload

Zdarzenie Unload jest generowane tuż przed zamknięciem formy.

Składnia:

Private Sub obiekt _Unload (Cancel As Integer)

gdzie:


♦ cancel — wartość określają ca, czy ma nastą pić zamknięcie (0 — pozwala,inna wartość — nie).

3.3.36. Validate

Zdarzenie Validate jest generowane tuż przed tym, jak rekord stanie się rekordem

aktywnym, przed metodą Update (z wyją tkiem gdy dane są zapisywane za pomocą metody UpdateRecord) i przed operacjami Delete, Unload lub Close.




216

Składnia:

Private Sub obiekt _ Validate ([Indeks As Integer,] Akcja As Integer,

Zapis As Integer)

gdzie:



♦ akcja — wartość określają ca operację wywołują cą dane zdarzenie,

♦ zapis — wartość określają ca, czy elementy zostały zmienione (True, False),

Wartości i stałe dostępne dla argumentu akcja:


vbDataActionCancel

0 operacja anulowana, gdy istnieje SubvbDataActionMoveFirst

1 metoda MoveFirst

vbDataActionMovePrev

ious2 metoda MovePrevious

vbDataActionMoveNext 3 metoda MoveNext

vbDataActionMoveLast 4 metoda MoveLast

vbDataActionAddNew 5 metoda AddNew

vbDataActionUpdate 6 operacja Update

vbDataActionDelete 7 metoda Delete

vbDataActionFind 8 metoda Find

vbDataActionBookmark 9 ustawiona właściwość Bookmark

vbDataActionClose 10 metoda Close

vbDataActionUnload 11 usunięcie formy z pamięci

3.4. Metody kontrolek standardowych

3.4.1. AddItem

Metoda AddItem dopisuje nowy element do listy kontrolek.




217

Składnia:

obiekt. AddItem ElementDodawany [, Pozycja]

gdzie:

♦ obiekt — obiekt wykorzystują cy tę metodę,

♦ elementDodawany (wymagany) — wyrażenie określają ce element, któryma zostać dodany do obiektu,

♦ pozycja (opcja) — liczba (całkowita) będą ca numerem pozycji, na którejbędzie dodany element (numeracja od 0).

3.4.2. Arrange

Metoda Arrange układa okna lub ikony wewną trz formy MDIForm w określonym

porzą dku.

Składnia:

obiekt. Arrange Styl

gdzie:


♦ styl (wymagany) — wyrażenie określają ce element, który ma zostaćdodany do obiektu.

Wartości i stałe dostępne dla argumentu Ułożenie:


vbCascade 0 nie zminimalizowane formy MDIChild — kaskadowo

vbTileHorizont

al1 nie zminimalizowane formy MDIChild — wyrównanie pionowe

vbTileVertical 2 nie zminimalizowane formy MDIChild — wyrównanie poziome

vbArrangeIcons 3 ułożenie ikon wszystkich zminimalizowanych form MDIChild

3.4.3. Assert

Metoda Assert przerywa wykonywanie programu na wierszu kodu, w którym zosta-

je wywołana.

Składnia:

obiekt. Assert Wyrażenie




219

Składnia:

obiekt.Clear

gdzie:

♦ obiekt — obiekt wykorzystują cy tę metodę.

3.4.6. Cls

Metoda Cls czyści grafik ę i tekst stworzone wcześniej na formie lub kontrolce

PictureBox.

Składnia:

obiekt.Cls

gdzie:


3.4.7. Drag

Metoda Drag rozpoczyna, przerywa lub kończy przecią ganie kontrolek.

Składnia:

obiekt.Drag [Czynność]

gdzie:

♦

obiekt — obiekt wykorzystują cy tę metodę,♦ zadanie (opcja) — wartość określają ca zadanie metody.

Wartości i stałe dostępne dla argumentu zadanie:


vbCancel 0 przerwanie przecią gania

vbBeginDra

g1 rozpoczęcie przecią gania

vbEndDrag 2 zakończenie przecią gania




220

3.4.8. EndDoc

Metoda EndDoc przerywa wysyłanie dokumentu do obiektu Printer, zwalniają c jednocześnie drukark ę.

Składnia:

obiekt.EndDoc

gdzie:


3.4.9. GetData

Metoda GetData pobiera grafik ę ze schowka systemowego.

Składnia:

obiekt.GetData ([Format])

gdzie:


♦ format (opcja) — wartość określają ca rozpoznawane formaty. Ustawieniena 0 lub jego brak powoduje automatycznie użycie odpowiedniego formatu.

Wartości i stałe dostępne dla argumentu format:


vbCFBitmap 2 format *.bmp

vbCFMetafil

e3 format *.wmf

vbCFDIB 8 format Device-independent bitmap (DIB)

vbCFPalette 9 paleta kolorów

3.4.10. GetFormat

Metoda GetFormat pobiera grafik ę ze schowka systemowego.

Składnia:

obiekt.GetFormat (Format)

gdzie:




221


♦ format (wymagany) — wartość określają ca rozpoznawany format.



vbCFLink &HBF00 format dynamicznej wymiany danych ( DDE )

vbCFText 1 format tekstowy

vbCFBitmap 2 format *.bmp

vbCFMetafi

le3 format *.wmf


vbCFDIB 8 format Device-independent bitmap ( DIB)

vbCFPalett

e9 paleta kolorów

3.4.11. GetText

Metoda GetText pobiera dane tekstowe ze schowka systemowego.

Składnia:

obiekt.GetText ([Format])

gdzie:♦ obiekt — obiekt wykorzystują cy tę metodę,

♦ format (opcja) — wartość określają ca rozpoznawane formaty.



vbCFLink &HBF00 format dynamicznej wymiany danych (DDE)

vbCFText 1 format tekstowy

vbCFRTF &HBF01 format *.rtf




222

3.4.12. Hide

Metoda Hide ukrywa obiekt Form lub MDIForm, ale nie usuwa go (sprawia, że jest

niewidoczny).

Składnia:

obiekt.Hide

gdzie:


3.4.13. Line

Metoda Line rysuje linię lub prostok ą t.

Składnia:

obiekt.Line [Step] [(X1, Y1)] — [Step] (X2, Y2), [Kolor ], [B[F]]

gdzie:


♦ Step (opcja) — słowo kluczowe określają ce przesunięcie współrzędnych

punktu począ tkowego względem współrzędnych określonych właściwościami

CurrentX i CurrentY obiektu,

♦ x1, y1 (opcja) — wartości określają ce współrzędne począ tku rysowania

w jednostkach określonych właściwością ScaleMode obiektu,

♦ Step (opcja) — słowo kluczowe określają ce, że podany punkt końcowy

rysowanej linii (figury) jest przesunięty relatywnie względem punktu

począ tkowego,

♦ x2, y2 (wymagany) — wartości określają ce współrzędne końca rysowania


♦ kolor (opcja) — wyrażenie określają ce kolor linii rysowanej figury,

♦ B (opcja) — wyrażenie, które jeżeli jest użyte, oznacza, że rysowany będzie

prostok ą t, a podawane współrzędne są współrzędnymi przeciwległych

wierzchołków,

♦ F (opcja) — wyrażenie, które jeżeli jest użyte, oznacza, że narysowany

prostok ą t ma zostać wypełniony tym samym kolorem, co jego krawędzie.




223

3.4.14. LinkExecute

Metoda LinkExecute przesyła polecenia do aplikacji źródłowej podczas operacji DDE.

Składnia:

obiekt.LinkExecute Polecenia

gdzie:


♦ polecenia — wyrażenie będą ce poleceniem lub cią giem poleceń do

wykonania.

3.4.15. LinkPoke

Metoda LinkPoke przenosi podczas operacji dynamicznej wymiany danych (DDE)zawartość kontrolki do aplikacji źródłowej.

Składnia:

obiekt.LinkPoke

gdzie:


3.4.16. LinkRequest

Metoda LinkRequest żą da od aplikacji źródłowej przesłania nowej zawartości kon-trolki podczas konwersacji DDE.

Składnia:

obiekt.LinkRequest

gdzie:


3.4.17. LinkSend

Metoda LinkSend przenosi zawartość kontrolki PictureBox do aplikacji docelo-wej podczas operacji dynamicznej wymiany danych (DDE).




225

Składnia:

obiekt.OLEDrag

gdzie:


3.4.21. PaintPicture

Metoda PaintPicture wyświetla zawartość pliku graficznego na obiekcie.

Składnia:

obiekt.PaintPicture Grafika, X1, Y1, Szerokosc1, Wysokosc1, X2, Y2,

Szerokosc2, Wysokosc2, Kod

gdzie:


♦ grafika (wymagany) — wyrażenie określają ce źródło wykorzystywanej

grafiki (Picture, Form lub PictureBox),

♦ x1, y1 (wymagany) — wartości określają ce współrzędne docelowe wyświetlenia

grafiki w jednostkach określonych właściwością ScaleMode obiektu,

♦ szerokość1 (opcja) — wartość określają ca docelową szerokość grafiki


♦ wysokość1 (opcja) — wartość określają ca docelową wysokość grafiki


♦ x2, y2 (opcja) — wartości określają ce współrzędne obszaru grafiki

przeznaczonego do wycięcia i wyświetlenia w jednostkach określonychwłaściwością ScaleMode obiektu,

♦ szerokość2 (opcja) — wartość określają ca źródłową szerokość grafiki


♦ wysokość2 (opcja) — wartość określają ca źródłową wysokość grafiki


♦ kod (opcja) — wyrażenie określają ce kod używane tylko z bitmapami

(vbMergeCopy lub vbSrcAnd) do wykonania na grafice przed jej

wyświetleniem.

3.4.22. PointMetoda Point wyświetla zawartość pliku graficznego na obiekcie.




226

Składnia:

obiekt.Point (X , Y )

gdzie:


♦ x , y (wymagany) — wartości określają ce poziomą i pionową współrzędną badanego punktu obiektu w skali określonej właściwością ScaleModeobiektu.

3.4.23. PopupMenu

Metoda PopupMenu wyświetla zawartość pliku graficznego na obiekcie.

Składnia:

obiekt.PopupMenu Nazwa, Styl, X , Y , CelPogrubienia

gdzie:


♦ nazwa (wymagany) — wyrażenie określają ce nazwę dla menu pop-up,

♦ styl (opcja) — wyrażenie określają ce docelowe położenie i zachowanie sięmenu pop-up. Dla łą czenia różnych stylów należy używać operatora or,

♦ x , y (opcja) — wartości określają ce współrzędne miejsca wyświetlenia sięmenu pop-up (w przypadku ich pominięcia menu zostanie wyświetlonew miejscu wskazywanym myszk ą ),

♦ celPogrubienia (opcja) — wyrażenie określają ce kontrolk ę w menu pop-

up przeznaczoną do wyróżnienia.

Wartości i stałe dostępne dla argumentu styl:


vbPopupMenuLeftAlig

n0 (Domyślna) lewa krawędź menu leży na współrzędnej X

vbPopupMenuLeftButton

0 (Domyślna) polecenia menu uruchamiane są kliknięciemlewego klawisza myszy

vbPopupMenuRightBut

ton2 Polecenia menu uruchamiane są kliknięciem lewego lub

prawego klawisza myszy

vbPopupMenuCenterAl

ign4 Menu centrowane jest na współrzędnej X

vbPopupMenuRightAli

gn8 Prawa krawędź menu leży na współrzędnej X




227

3.4.24. Print

Metoda Print wyświetla tekst w oknie Debug.

Składnia:obiekt.Print [Wyrażenie lub wyrażenia]

gdzie:


♦ nazwa (wymagany) — wyrażenie lub wyrażenia mają ce zostać wypisanena obiekcie.

Składnia argumentu Wyrażenie lub wyrażenia:

[Spc(n) | Tab[(n)]] [Wyrażenie] [Pozycja]

gdzie:♦ Spc(n) — słowo kluczowe oznaczają ce, że będą wstawiane znaki spacji

(n — liczba spacji do wstawienia),

♦ Tab[(n)] — słowo kluczowe oznaczają ce, że będą wstawiane znaki tabulacji(n — liczba tabulacji do wstawienia). Pominięcie liczby n oznaczawstawienie znaku począ tku następnej strefy drukowania (14 kolumn),

♦ wyrażenie — wyrażenie do wypisania na obiekcie,

♦ pozycja — wartość określają ca miejsce wstawiania następnego znaku.Pominięcie go oznacza, że następny znak będzie wstawiany w nowym wierszu.

3.4.25. PrintFormMetoda PrintForm powoduje wydrukowanie całej formy.

Składnia:

obiekt.PrintForm

gdzie:


3.4.26. PSet

Metoda PSet rysuje punkt o danym kolorze.




228

Składnia:

obiekt.PSet [Step] (X , Y ) [Kolor ]

gdzie:


♦ x , y (opcja) — wartości określają ce współrzędne rysowanego punktu,

♦ kolor (opcja) — wyrażenie określają ce kolor rysowanego punktu.

3.4.27. Refresh

Metoda Refresh odświeża obiekt.

Składnia:

obiekt.Refresh

gdzie:


3.4.28. RemoveItem

Metoda RemoveItem usuwa element z listy kontrolek.

Składnia:

obiekt.RemoveItem Pozycja

gdzie:


♦ pozycja — wartość określają ca miejsce na liście, z którego będzie element

usunięty.

3.4.29. Scale

Metoda Scale definiuje układ współrzędnych.

Składnia:

obiekt.Scale [(X1, Y1) — (X2, Y2)]

gdzie:





230

3.4.31. ScaleY

Metoda ScaleY konwertuje wartość wysokości obiektu z jednego na drugi rodzaj

jednostek.

Składnia:

obiekt.ScaleY (Wysokość, SkalaPrzed , SkalaPo)

gdzie:


♦ wysokość (opcja) — wartość określają ca liczbę jednostek doprzekonwertowania,

♦ skalaPrzed (opcja) — wyrażenie określają ce system jednostek, zktórego nastą pi konwersja,

♦ skalaPo (opcja) — wyrażenie określają ce system jednostek, na którynastą pi konwersja.

Wartości i stałe dostępne dla argumentów SkalaPrzed i SkalaPo: patrz 3.4.30.

3.4.32. SetData

Metoda SetData kopiuje grafik ę do schowka systemowego w określonym formacie.

Składnia:

obiekt.SetData Dana[, Format]

gdzie:


♦ dana (wymagany) — wartość określają ca grafik ę, która ma zostać umieszczonaw Clipboard ,

♦ format (opcja) — wartość określają ca rozpoznawane formaty. Ustawieniena 0 lub jego brak powoduje automatycznie użycie odpowiedniego formatu.



vbCFBitmap

2 format *.bmpvbCFMetafil

e3 format *.wmf

vbCFDIB 8 format Device-independent bitmap ( DIB)




231

vbCFPalette 9 paleta kolorów

3.4.33. SetFocus

Metoda SetFocus powoduje, że obiekt staje się aktywny.

Składnia:

obiekt.SetFocus

gdzie:


3.4.34. SetData

Metoda SetData kopiuje tekst do schowka systemowego w określonym formacie.

Składnia:

obiekt.SetData Dana[, Format]

gdzie:


♦ dana (wymagany) — wartość określają ca tekst, który ma zostaćumieszczony w Clipboard ,

♦ format (opcja) — wartość określają ca rozpoznawane formaty.



vbCFLink &HBF00 format dynamicznej wymiany danych (DDE)

vbCFText 1 format Text

vbCFRTF &HBF01 format Rich Text Format (*.rtf )

3.4.35. Show

Metoda Show wyświetla obiekt form lub MDIForm.




232

Składnia:

obiekt.Show [Modalność][, Właściciel]

gdzie:


♦ modalność (opcja) — wartość określają ca rodzaj modalności formy (0 —nie jest modalna, 1 — jest modalna), czyli czy można wykonywać inne

działania, nie ukrywają c lub nie usuwają c jej z pamięci,

♦ właściciel (opcja) — wartość określają ca właściciela wyświetlanej formy

(np. Me).

3.4.36. ShowColor

Metoda ShowColor wyświetla okno dialogowe Colors kontrolki CommonDialog.

Składnia:

obiekt.ShowColor

gdzie:


3.4.37. ShowFont

Metoda ShowFont wyświetla okno dialogowe Fonts kontrolki CommonDialog.

Składnia:obiekt.ShowFont

gdzie:


3.4.38. ShowHelp

Metoda ShowHelp uruchamia pomoc systemową (wyświetlają c konkretny plik po-

mocy, określony właściwościami HelpFile i HelpCommand kontrolki CommonDia-

log).




233

Składnia:

obiekt.ShowHelp

gdzie:


3.4.39. ShowOpen

Metoda ShowOpen wyświetla okno dialogowe Open kontrolki CommonDialog.

Składnia:

obiekt.ShowOpen

gdzie:


3.4.40. ShowPrinter

Metoda ShowPrinter wyświetla okno dialogowe Printer kontrolki CommonDialog.

Składnia:

obiekt.ShowPrinter

gdzie:


3.4.41. ShowSave

Metoda ShowSave wyświetla okno dialogowe SaveAs kontrolki CommonDialog.

Składnia:

obiekt.ShowSave

gdzie:





234

3.4.42. ShowWhatsThis

Metoda ShowWhatsThis wyświetla wskazany temat (właściwością WhatsThisHel-pID obiektu) z pliku pomocy, użyty poleceniem What ’s This?, menu PopUp systemu

operacyjnego.

Składnia:

obiekt.ShowWhatsThis

gdzie:


3.4.43. TextHeight

Metoda TextHeight zwraca wysokość tekstu, tak jakby został wyświetlony za po-

mocą aktualnie używanej czcionki, na obiekcie.

Składnia:

obiekt.TextHeight (Łańcuch)

gdzie:


♦ łańcuch (wymagany) — wyrażenie określają ce łańcuch tekstowy.

3.4.44. TextWidth

Metoda TextWidth zwraca szerokość tekstu, tak jakby został wyświetlony za pomo-

cą aktualnie używanej czcionki, na obiekcie.

Składnia:

obiekt.TextWidth (Łańcuch)

gdzie:


♦ łańcuch (wymagany) — wyrażenie określają ce łańcuch tekstowy.

3.4.45. WhatsThisMode

Metoda WhatsThisMode wprowadza gotowość do używania pomocy What’s This? wy-

branego obiektu, zmieniają c jednocześnie wskaźnik myszki na wskaźnik What’s This?.




Składnia:

obiekt. WhatsThisMode

gdzie:


3.4.46. ZOrder

Metoda ZOrder zmienia pozycję obiektu na liście z-order wewną trz poziomów gra-

ficznych.

visual basic. leksykon

Documents