You are on page 1of 232

Mojej Mamie

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 3


E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 4
Spis treści
Wstęp ....................................................................................................................................... 11
Rozdział 1. Podstawy obsługi programu VB ..................................................................... 13
1.1. Menu programu ....................................................................................................... 13
1.1.1. File ............................................................................................................ 13
1.1.2. Edit ............................................................................................................ 16
1.1.3. View .......................................................................................................... 20
1.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.............................................................................................. 39
1.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 ..................................................................... 47
2.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
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........................................................................................... 107
3.1.1. Animation................................................................................................ 107
3.1.2. CheckBox ................................................................................................ 108
3.1.3. ComboBox .............................................................................................. 109
3.1.4. CommandButton ..................................................................................... 110

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 5


Spis treści 6

3.1.5. CommonDialog ....................................................................................... 111


3.1.6. Data ......................................................................................................... 111
3.1.7. DBCombo ............................................................................................... 112
3.1.7. DBGrid.................................................................................................... 113
3.1.8. DBList ..................................................................................................... 116
3.1.9. Debug ...................................................................................................... 117
3.1.10. DirListBox............................................................................................... 117
3.1.11. DriveListBox........................................................................................... 118
3.1.12. FileListBox.............................................................................................. 119
3.1.13. Form ........................................................................................................ 120
3.1.14. Frame....................................................................................................... 122
3.1.15. HScroolBar.............................................................................................. 123
3.1.16. Image....................................................................................................... 124
3.1.17. Label........................................................................................................ 125
3.1.18. Line ......................................................................................................... 126
3.1.19. ListBox.................................................................................................... 126
3.1.20. MDIForm ................................................................................................ 127
3.1.21. Menu ....................................................................................................... 129
3.1.22. OLE ......................................................................................................... 129
3.1.23. OptionButton........................................................................................... 130
3.1.24. Panel........................................................................................................ 131
3.1.25. PictureBox............................................................................................... 131
3.1.26. Printer...................................................................................................... 133
3.1.27. ProgressBar ............................................................................................. 134
3.1.28. Shape ....................................................................................................... 135
3.1.29. Slider ....................................................................................................... 135
3.1.30. SSTab ...................................................................................................... 136
3.1.31. StatusBar ................................................................................................. 137
3.1.32. TabStrip................................................................................................... 138
3.1.33. TextBox................................................................................................... 139
3.1.34. ToolBar ................................................................................................... 141
3.1.35. Timer ....................................................................................................... 142
3.1.36. UpDown .................................................................................................. 142
3.1.37. UserControl ............................................................................................. 143
3.1.38. VScrollBar............................................................................................... 145
3.2. Właściwości kontrolek standardowych.................................................................. 145
3.2.1. Action...................................................................................................... 145
3.2.2. ActionControl.......................................................................................... 146
3.2.3. ActiveForm.............................................................................................. 146
3.2.4. Align........................................................................................................ 147
3.2.5. Alignment................................................................................................ 147
3.2.6. Appearance.............................................................................................. 148
3.2.7. Archive.................................................................................................... 148
3.2.8. AutoRedraw ............................................................................................ 149
3.2.9. AutoShowChildren.................................................................................. 149
3.2.10. AutoSize.................................................................................................. 149
3.2.11. BackColor ............................................................................................... 150
3.2.12. BorderColor............................................................................................. 151
3.2.13. BorderStyle.............................................................................................. 152
3.2.14. BorderWidth............................................................................................ 153
3.2.15. Cancel...................................................................................................... 153
3.2.16. Caption .................................................................................................... 154
3.2.17. Checked................................................................................................... 154
3.2.18. ClipControls ............................................................................................ 154
3.2.19. Columns (DBGrid) .................................................................................. 155

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 6


Spis treści 7

3.2.20. Columns (ListBox) .................................................................................. 155


3.2.21. Container ................................................................................................. 155
3.2.22. ControlBox .............................................................................................. 156
3.2.23. Controls ................................................................................................... 156
3.2.24. Count (VB Collections)........................................................................... 156
3.2.25. CurrentX, CurrentY................................................................................. 156
3.2.26. Database .................................................................................................. 157
3.2.27. DatabaseName......................................................................................... 157
3.2.28. DataChanged ........................................................................................... 158
3.2.29. DataField ................................................................................................. 158
3.2.30. DataSource .............................................................................................. 158
3.2.31. Default..................................................................................................... 158
3.2.32. DisabledPicture ....................................................................................... 159
3.2.33. DownPicture............................................................................................ 159
3.2.34. DragIcon.................................................................................................. 159
3.2.35. DragMode ............................................................................................... 160
3.2.36. DrawMode............................................................................................... 160
3.2.37. DrawStyle................................................................................................ 161
3.2.38. DrawWidth .............................................................................................. 161
3.2.39. Drive........................................................................................................ 162
3.2.40. Enabled.................................................................................................... 162
3.2.41. FileName ................................................................................................. 162
3.2.42. FillColor .................................................................................................. 163
3.2.43. FillStyle ................................................................................................... 163
3.2.44. Font ......................................................................................................... 164
3.2.45. FontBold.................................................................................................. 164
3.2.46. FontItalic ................................................................................................. 164
3.2.47. FontName ................................................................................................ 164
3.2.48. FontSize................................................................................................... 165
3.2.49. FontStrikethru.......................................................................................... 165
3.2.50. FontTransparent....................................................................................... 165
3.2.51. FontUnderline.......................................................................................... 165
3.2.52. ForeColor ................................................................................................ 166
3.2.53. hDC ......................................................................................................... 166
3.2.54. Hidden ..................................................................................................... 166
3.2.55. Height...................................................................................................... 166
3.2.56. HelpContextID ........................................................................................ 167
3.2.57. hWnd ....................................................................................................... 167
3.2.58. HideSelection .......................................................................................... 167
3.2.59. Icon.......................................................................................................... 168
3.2.60. Image....................................................................................................... 168
3.2.61. Index (ActiveX)....................................................................................... 168
3.2.62. Index (Control Array).............................................................................. 168
3.2.63. IntegralHeight.......................................................................................... 169
3.2.64. Interval .................................................................................................... 169
3.2.65. ItemData.................................................................................................. 169
3.2.66. KeyPreview ............................................................................................. 170
3.2.67. LargeChange ........................................................................................... 170
3.2.68. Left .......................................................................................................... 170
3.2.69. LinkItem.................................................................................................. 171
3.2.70. LinkMode ................................................................................................ 171
3.2.71. LinkTimeout............................................................................................ 172
3.2.72. LinkTopic ................................................................................................ 172
3.2.73. List .......................................................................................................... 173
3.2.74. ListCount................................................................................................. 173

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 7


Spis treści 8

3.2.75. ListIndex ................................................................................................. 173


3.2.76. Locked..................................................................................................... 174
3.2.77. MaskColor............................................................................................... 174
3.2.78. Max ......................................................................................................... 174
3.2.79. MaxButton............................................................................................... 175
3.2.80. MaxLength .............................................................................................. 175
3.2.81. MDIChild ................................................................................................ 175
3.2.82. Min .......................................................................................................... 176
3.2.83. MinButton ............................................................................................... 176
3.2.84. MouseIcon............................................................................................... 176
3.2.85. MousePointer .......................................................................................... 177
3.2.86. Moveable................................................................................................. 178
3.2.87. MultiLine................................................................................................. 178
3.2.88. MultiSelect .............................................................................................. 178
3.2.89. Name ....................................................................................................... 179
3.2.90. Negotiate ................................................................................................. 179
3.2.91. NegotiateMenus....................................................................................... 179
3.2.92. NegotiatePosition .................................................................................... 179
3.2.93. NegotiateToolbars ................................................................................... 180
3.2.94. NewIndex ................................................................................................ 180
3.2.95. Normal..................................................................................................... 180
3.2.96. OLEDragMode........................................................................................ 181
3.2.97. OLEDropMode........................................................................................ 181
3.2.98. Palette...................................................................................................... 182
3.2.99. PaletteMode............................................................................................. 182
3.2.100. Parent....................................................................................................... 183
3.2.101. PasswordChar.......................................................................................... 183
3.2.102. Path.......................................................................................................... 183
3.2.103. Pattern ..................................................................................................... 184
3.2.104. Picture ..................................................................................................... 184
3.2.105. ReadOnly................................................................................................. 184
3.2.106. ScaleHeight ............................................................................................. 185
3.2.107. ScaleLeft ................................................................................................. 185
3.2.108. ScaleMode............................................................................................... 185
3.2.109. ScaleTop.................................................................................................. 186
3.2.110. ScaleWidth .............................................................................................. 186
3.2.111. ScrollBars................................................................................................ 187
3.2.112. SellCount................................................................................................. 187
3.2.113. Selected ................................................................................................... 188
3.2.114. SelLength ................................................................................................ 188
3.2.115. SelStart .................................................................................................... 188
3.2.116. SelText .................................................................................................... 189
3.2.117. Shape ....................................................................................................... 189
3.2.118. Shortcut ................................................................................................... 190
3.2.119. ShowInTaskbar........................................................................................ 190
3.2.120. SmallChange ........................................................................................... 190
3.2.121. Sorted ...................................................................................................... 190
3.2.122. Stretch ..................................................................................................... 191
3.2.123. StartUpPosition ....................................................................................... 191
3.2.124. Style ........................................................................................................ 191
3.2.125. System ..................................................................................................... 192
3.2.126. TabIndex ................................................................................................. 193
3.2.127. TabStop ................................................................................................... 193
3.2.128. Tag .......................................................................................................... 193
3.2.129. Text ......................................................................................................... 193

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 8


Spis treści 9

3.2.130. ToolTipText ............................................................................................ 194


3.2.131. Top .......................................................................................................... 194
3.2.132. TopIndex ................................................................................................. 194
3.2.133. UseMaskColor......................................................................................... 195
3.2.134. UseMnemonic ......................................................................................... 195
3.2.135. Value ....................................................................................................... 195
3.2.136. Visible ..................................................................................................... 196
3.2.137. WhatsThisButton..................................................................................... 196
3.2.138. WhatsThisHelp........................................................................................ 196
3.2.138. WhatsThisHelpID.................................................................................... 197
3.2.139. Width....................................................................................................... 197
3.2.140. WindowList............................................................................................. 197
3.2.142. WindowState ........................................................................................... 198
3.2.143. WordWrap............................................................................................... 198
3.2.144. X1, Y1 — X2,Y2 .................................................................................... 198
3.3. Zdarzenia kontrolek standardowych ...................................................................... 199
3.3.1. Activate ................................................................................................... 199
3.3.2. Change..................................................................................................... 199
3.3.3. Click ........................................................................................................ 199
3.3.4. DblClick .................................................................................................. 200
3.3.5. DeActivate............................................................................................... 200
3.3.6. DragDrop................................................................................................. 200
3.3.7. DragOver................................................................................................. 201
3.3.8. DropDown............................................................................................... 201
3.3.9. Error ........................................................................................................ 202
3.3.10. GotFocus ................................................................................................. 202
3.3.11. Initialize................................................................................................... 202
3.3.12. ItemCheck ............................................................................................... 203
3.3.13. KeyDown ................................................................................................ 203
3.3.14. KeyPress.................................................................................................. 203
3.3.15. KeyUp ..................................................................................................... 204
3.3.16. LinkClose ................................................................................................ 204
3.3.17. LinkError................................................................................................. 205
3.3.18. LinkExecute ............................................................................................ 205
3.3.19. LinkNotify............................................................................................... 206
3.3.20. LinkOpen................................................................................................. 206
3.3.21. Load ........................................................................................................ 206
3.3.22. LostFocus ................................................................................................ 206
3.3.23. MouseDown ............................................................................................ 207
3.3.24. MouseMove............................................................................................. 208
3.3.25. MouseUp ................................................................................................. 208
3.3.26. Paint ........................................................................................................ 209
3.3.27. PathChange.............................................................................................. 209
3.3.28. PatternChange ......................................................................................... 210
3.3.29. QueryUnload ........................................................................................... 210
3.3.30. Reposition ............................................................................................... 211
3.3.31. Resize ...................................................................................................... 211
3.3.32. Scroll ....................................................................................................... 211
3.3.33. Terminate ................................................................................................ 212
3.3.34. Timer ....................................................................................................... 212
3.3.35. Unload ..................................................................................................... 212
3.3.36. Validate ................................................................................................... 213
3.4. Metody kontrolek standardowych.......................................................................... 213
3.4.1. AddItem................................................................................................... 213
3.4.2. Arrange.................................................................................................... 214

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 9


Spis treści 10

3.4.3. Assert....................................................................................................... 214


3.4.4. Circle ....................................................................................................... 215
3.4.5. Clear ........................................................................................................ 215
3.4.6. Cls ........................................................................................................... 216
3.4.7. Drag......................................................................................................... 216
3.4.8. EndDoc.................................................................................................... 216
3.4.9. GetData ................................................................................................... 217
3.4.10. GetFormat ............................................................................................... 217
3.4.11. GetText.................................................................................................... 218
3.4.12. Hide ......................................................................................................... 218
3.4.13. Line ......................................................................................................... 218
3.4.14. LinkExecute ............................................................................................ 219
3.4.15. LinkPoke ................................................................................................. 219
3.4.16. LinkRequest ............................................................................................ 220
3.4.17. LinkSend ................................................................................................. 220
3.4.18. Move ....................................................................................................... 220
3.4.19. NewPage ................................................................................................. 221
3.4.20. OLEDrag ................................................................................................. 221
3.4.21. PaintPicture ............................................................................................. 221
3.4.22. Point ........................................................................................................ 222
3.4.23. PopupMenu ............................................................................................. 222
3.4.24. Print ......................................................................................................... 223
3.4.25. PrintForm ................................................................................................ 223
3.4.26. PSet ......................................................................................................... 224
3.4.27. Refresh .................................................................................................... 224
3.4.28. RemoveItem ............................................................................................ 224
3.4.29. Scale ........................................................................................................ 225
3.4.30. ScaleX ..................................................................................................... 225
3.4.31. ScaleY ..................................................................................................... 226
3.4.32. SetData .................................................................................................... 226
3.4.33. SetFocus .................................................................................................. 227
3.4.34. SetText .................................................................................................... 227
3.4.35. Show........................................................................................................ 228
3.4.36. ShowColor............................................................................................... 228
3.4.37. ShowFont ................................................................................................ 228
3.4.38. ShowHelp ................................................................................................ 228
3.4.39. ShowOpen ............................................................................................... 229
3.4.40. ShowPrinter............................................................................................. 229
3.4.41. ShowSave ................................................................................................ 229
3.4.42. ShowWhatsThis ...................................................................................... 229
3.4.43. TextHeight............................................................................................... 230
3.4.44. TextWidth ............................................................................................... 230
3.4.45. WhatsThisMode ...................................................................................... 230
3.4.46. ZOrder ..................................................................................................... 231

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 10


Spis treści 11

Wstęp
Wyobraźmy sobie mechanika samochodowego, do którego przyjechał klient z
przebitą oponą. Nasz miły fachowiec jest człowiekiem zdolnym, energicznym i
pełnym zapał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 wyjąć dętkę, następnie zlokalizować miejsce przebicia, potem je zakleić, dętkę
włożyć z powrotem 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
wykorzystać 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łego ś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?
Zdecydowanie 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ć.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 11


Spis treści 12

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 12


Spis treści 13

Rozdział 1.
Podstawy obsługi programu VB
Aby zabrać się do jakiejkolwiek pracy za pomocą jakiegokolwiek programu
komputerowego, trzeba umieć się nim posługiwać. Na początku musi to być wiedza o
charakterze 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łynnym tworzeniu programów.

1.1.1. File
New Project
Opcja ta powoduje rozpoczęcie nowego projektu, od którego w VB wszystko się
zaczyna — 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).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 13


Spis treści 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ż
istnieją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, lecz
tylko 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.

Save Project As lub Save Project Group As


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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 14


Spis treści 15

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
wydrukować 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
wykonywalnego (*.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
niedawno pracowaliśmy. Inaczej mówiąc, stworzona jest swoista lista ostatnio
używanych plików.

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
zachowana, program umożliwia to, wyświetlając stosowne okno.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 15


Spis treści 16

1.1.2. Edit

Undo
Opcja przywracająca stan sprzed ostatniej operacji, takiej jak usuwanie czy wpisanie
tekstu w oknie kodu. Niestety, operacja ta nie przyniesie oczekiwanego skutku w
stosunku 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śniej
cofnę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śnie
w schowku systemowym.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 16


Spis treści 17

Copy
Wycina zaznaczoną kontrolkę lub tekst z okna projektu, umieszczając je jednocześnie
w 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ła
DDE 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 oknie
Code). W przypadku odnalezienia szukanego ciągu zostanie on zaznaczony — w
przeciwnym 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.

Replace
Po wybraniu tej opcji pojawi się okienko dialogowe Replace, w którym określamy
cią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 na
następną pozycję tabulatora.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 17


Spis treści 18

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ępne
dla obiektu poprzedzającego kropkę (.). Polecenie to wyświetla także wszystkie
dostę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ć
automatycznie — 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 wypisanej
właściwości, poprzedzonej znakiem równości (=). Polecenie to działa także dla
funkcji z argumentami, które są stałymi.

Podczas pisania kodu programu lista ta w razie potrzeby może się otwierać
automatycznie — należy w tym celu włączyć opcję Auto List Members w zakładce
Editor okienka dialogowego Options.

Quick Info
Wyświetla składnię dla zmiennej, funkcji, instrukcji, metody lub procedury, którą
zaznaczymy w oknie kodu.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 18


Spis treści 19

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
oddzielenia go od następnego parametru.

Podczas pisania kodu programu pomoc ta w razie potrzeby może się otwierać
automatycznie — należy w tym celu włączyć opcję Auto Quick Info w zakładce Editor
okienka dialogowego Options.

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
instrukcja zawiera funkcje lub instrukcje jako parametry, Parameter Info pokazuje
informacje o pierwszej takiej funkcji lub instrukcji.

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


Quick Info.

Complete Word
Opcja uzupełniająca pozostałą, nie wpisaną część słowa, o ile na podstawie już
wpisanych 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.

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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 19


Spis treści 20

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 kursor
znajduje się na fragmencie kodu związanym z istniejącym obiektem tegoż projektu.

Definition
Wskazuje lokalizację zdefiniowania zmiennej lub procedury, wskazanej położeniem
kursora 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
tylko w oknie kodu.

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 20


Spis treści 21

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

Immediate Window
Pokazuje okno Immediate, a w nim informacje związane ze sprawdzaniem błędów
w 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 na
stosie 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
wyraż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.

Gdy Visual Basic wykonuje procedurę, jest ona dodawana do listy aktualnie
wywołanych procedur. Jeżeli procedura ta wywoła inną procedurę, to obie są na liście
jako aktualnie 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 21


Spis treści 22

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

Properties Window
Wyświetla okno Properties, w którym wymienione są właściwości dostępne dla
zaznaczonej formy, kontrolki, klasy, kontrolki użytkownika, strony właściwości,
dokumentu 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
obiektó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


programu.

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

Dostępne tylko w czasie projektowania.

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 22


Spis treści 23

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)
zdefiniowano) — 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


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

1.1.4. Project

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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 23


Spis treści 24

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
wstawić 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 kontrolkę 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
wstawić 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ędzy
projekty. 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 24


Spis treści 25

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ć
bibliotekę 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
przeglądać właściwości dostępne dla aktywnego projektu.

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,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 25


Spis treści 26

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


obiektu zaznaczonego jako ostatni,
♦ 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
obiektu zaznaczonego jako ostatni,
♦ 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
zaznaczonego jako ostatni.

Dostępne ustawienia:
♦ 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 26


Spis treści 27

Horizontal Spacing
Zmienia rozmiar poziomej przestrzeni pomiędzy zaznaczonymi obiektami, nie
zmieniając położenia obiektów skrajnych.

Dostępne ustawienia:
♦ 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
zmieniając położenia obiektów skrajnych.

Dostępne ustawienia:
♦ 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 27


Spis treści 28

Dostępne ustawienia:
♦ 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:

Dostępne ustawienia:
♦ Bring to Front — przesuwa zaznaczone obiekty nad wszystkie inne
obiekty,
♦ Send To Back — przesuwa zaznaczone obiekty pod wszystkie inne
obiekty.

Lock Controls
Powoduje unieruchomienie wszystkich kontrolek, aby nie uległy przypadkowemu
przesunięciu.

1.1.6. Debug

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 28


Spis treści 29

Step Into
Wykonuje kod programu po kolei — po jednej instrukcji. Użycie tej opcji podczas
projektowania spowoduje rozpoczęcie wykonywania programu i wejście, przed
wykonaniem pierwszej instrukcji, w tryb Break Mode (przerwania).

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

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

Step Out
Wykonuje pozostałe wiersze funkcji aktualnie wykonywanej.

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

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”.

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

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ć lub
usuwać wyrażenia Watch.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 29


Spis treści 30

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

Quick Watch
Wyświetla okienko dialogowe Quick Watch, zawierające aktualną wartość
zaznaczonego 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
zdefiniowanego wyrażenia Watch.

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

Toggle Breakpoint
Ustawia lub usuwa punkt przerwania (fragment kodu, przy którym wykonywanie
zostanie automatycznie przerwane). Nie można ustawić punktu przerwania przy
fragmencie 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 tego
polecenia możemy wybrać wiersz kodu zlokalizowany przed lub po aktualnie
zaznaczonym wierszu. Używa się jej do ponownego uruchomienia instrukcji w
aktualnej procedurze 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 30


Spis treści 31

1.1.7. Run
Start
Uruchamia projekt ustawiony jako Start Up w Project Explorer — standardowo jest
to projekt bieżący.

Start With Full Compile


Uruchamia projekt, dokonując wcześniej jego pełnej kompilacji, niezależnie od
ustawień opcji Compile On Demand i Background Compile w zakładce General
okienka dialogowego 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,


ponieważ uruchomienie takiego projektu poleceniem Start, przy włączonej opcji
Compile On Demand, może powodować, iż błędy w czasie kompilacji zostaną
wykryte dopiero 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 oknie
kodu ze wskaźnikiem zatrzymania na lewym marginesie (w przypadku gdy jest
zaznaczona opcja Margin Indicator Bar w zakładce Editor Format okienka dialogowego
Options).

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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 31


Spis treści 32

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óżne
własności programu Visual Basic.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 32


Spis treści 33

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 do
danych i zarządzać nimi.

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

Add-In Manager...
Rozszerzenia dodatkowe Add-Ins. Wymienione są tutaj odnośniki do wszystkich
dodatkowych programów zainstalowanych dla pakietu Visual Basic, rozszerzających
jego standardowe możliwości.

1.1.10. Window

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

Opcja dostępna tylko w oknie kodu.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 33


Spis treści 34

Tile Horizontally
Dzieli okno kodu na dwie równe części w poziomie. W pierwszym pokazuje okno
kodu, 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śniejszym 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 34


Spis treści 35

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
systemie 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żniejszymi
oknami w programie Visual Basic. Znajomość ich rozkładu bardzo pomoże w
sprawnym wykorzystywaniu narzędzi Visual Basic.

1.2.1. Call Stack


Okienko wyświetlające wszystkie wykonywane procedury podczas przejścia z trybu
wykonywania kodu do trybu przerwania.

Procedura dodawana jest do listy aktualnie wywołanych procedur wtedy, gdy jest ona
wywoł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
listy 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:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 35


Spis treści 36

♦ Show — powoduje wskazanie wywoływanego właśnie wiersza kodu


w 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 kursor
w 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 pozycji
z 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 36


Spis treści 37

♦ 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
dodawalnych obiektów do aktualnego projektu.

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 jej
nazwy, 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 37


Spis treści 38

W przypadku zaznaczenia opcji Select Items Only na liście wyświetlone zostaną tylko
kontrolki 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


nazwy, 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ą tylko
pliki projektantów aktualnie dołączone do projektu.

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


pliku 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


kwadrat 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 38


Spis treści 39

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
obiekcie Form lub innym, umiejscowionym na nim, powoduje
wyświetlenie okna Code w miejscu go dotyczącym.
♦ Umiejscowienie obiektu Form na ekranie monitora podczas uruchomienia
projektowanego 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 monitora
podczas 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 jej
lewy przycisk).

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


Form Layout:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 39


Spis treści 40

Resolution Guides
Pokazuje umiejscowienie obiektu Form w tworzonej aplikacji dla innej
rozdzielczości monitora niż obecna. Będą jednak pokazane tylko rozdzielczości
mniejsze od 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 pionie
wzglę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
wewnę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. Immediate
Okienko wywoływane automatycznie podczas przejścia z trybu wykonywania
kodu w tryb przerwania.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 40


Spis treści 41

Bezpośrednio po pojawieniu się jest puste i ma aktywny kursor. Można w nim wpisać (lub
wkleić) fragment kodu i zaraz go uruchomić poprzez naciśnięcie klawisza ENTER. Kod
wpisany za pośrednictwem tego okienka nie może zostać zapisany z jego poziomu we
wł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. Locals
Wyświetla wszelkie zadeklarowane zmienne w bieżącej procedurze wraz z ich
wartościami. Okienko to w przypadku wywołania jest automatycznie aktualizowane
przy każdym przejściu ze stanu wykonywania programu do trybu przerwania i gdy
zawartość 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,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 41


Spis treści 42

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


aktywnego 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ź
jego począ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,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 42


Spis treści 43

♦ 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,
♦ Show/Hide Search Result (przycisk — dwie strzałki w górę) — otwiera
lub ukrywa okienko z alfabetycznie wypisanymi rezultatami wyszukiwania.

1.2.9. Project
Wyświetla zhierarchizowaną strukturę zawartości otwartego projektu (projektów), na
któ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. Properties
Okienko zawierające listę wszystkich właściwości, dostępnych dla zaznaczonego
obiektu wraz z ich ustawieniami, umożliwiające jednocześnie ich modyfikację.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 43


Spis treści 44

W okienku rozwijalnym wymienione są wszystkie obiekty możliwe w danej chwili do


modyfikacji. 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 ten
moż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. Toolbox
Zawiera miniatury kontrolek Visual Basic, dostępnych w aktualnym projekcie. Oprócz
kontrolek standardowych do projektu można dokładać kontrolki własne lub inne

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 44


Spis treści 45

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

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


lub do 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


miniaturek kontrolki w oknie Toolbox pojawia się nazwa danej kontrolki. O tym, czy

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 45


Spis treści 46

te podpowiedzi 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 46


Spis treści 47

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

Ponadto prawdziwy programista nigdy nie ogranicza się do znajomości tylko i


wyłącznie jednego języka programowania — a pamięć, jak wiadomo, bywa czasami
zawodna.

2.1. Instrukcje sterujące


2.1.1. Do
Do 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 nigdy
nie będzie spełniony.

Przykład:
Do While zmienna1 > 52
Zmienna2 = 0
Loop

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

Składnia:
Do
Blok instrukcji

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 47


Spis treści 48

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ędzie
speł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, że
w pierwszym przebiegu warunek nie jest spełniony.

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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 48


Spis treści 49

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,
♦ 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 49


Spis treści 50

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ędzie
speł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.

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 50


Spis treści 51

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
kolejnych słowach ElseIf. Wykonany może być jednak tylko jeden blok instrukcji,
wystę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.

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 51


Spis treści 52

2.1.4. Select Case


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

Składnia:
Select Case Wyrażenie
Case 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 podanym
wyrażeniem a wartością, i w zależności od wyniku wybiera jeden odpowiedni blok
kodu do wykonania. Sprawdzanych relacji może być wiele.

Składnia:
Select Case Wyrażenie
Case Is Relacja1
Blok instrukcji
Case Is Relacja2
Blok instrukcji
Case Is Relacja3
Blok instrukcji
Case Else
Blok instrukcji
End Select

Przykład:
Select Case Kwota
Case Is <= 800

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 52


Spis treści 53

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 Else
Komunikat = 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
kluczowym Case i w zależności od wyniku wybiera jeden odpowiedni blok kodu do
wykonania. Sprawdzanych warunków może być wiele.

Składnia:
Select Case Wyrażenie
Case Wartość1a To Wartość1b
Blok instrukcji
Case 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 Else
Komunikat = MsgBox("Jesteś już dorosły — zarabiaj na siebie")
End Select

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ę
systemową.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 53


Spis treści 54

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 odejmowanego
przedział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
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óry
okreś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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 54


Spis treści 55

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ące daty wykorzystywane do obliczeń,
♦ PierwszyDzieńTygodnia (opcja) — stała, która określa pierwszy dzień
tygodnia — gdy nie zostanie określona, domyślnie przyjmowana jest
niedziela,

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
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,

Stała Wartość Opis

vbUseSystem 0 użyj ustawień NLS API


vbFirstJan 1 tydzień zawierający 1 stycznia (domyślnie)
vbFirstFourDay
s 2 pierwszy tydzień, w którym są co najmniej cztery dni nowego roku

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 55


Spis treści 56

vbFirstFullWee
k 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ślonymi
zmiennymi

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ślnie
przyjmowana jest niedziela,
♦ 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 daty
komunikat = 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 56


Spis treści 57

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 100


do 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
reprezentującego datę.

Składnia:
DateValue(Data)

Przykład:
Dim varData As Variant
Komunikat = DateValue("1999-11-25")
'Przypisanie zmiennej, wartości liczbowej podanej daty

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ę.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 57


Spis treści 58

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 pierwszy
dzień 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ęści
uł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
Long Time Wyświetla datę wg formatu długiej daty, ustawionego przez system, uwzględniając
godzinę, minutę i sekundę
Medium Date Wyświetla datę wg formatu średniej daty, odpowiedniego do wersji języka
aplikacji typu host
Medium Time Wyświetla czas w formacie 12-godzinnym
Short Date Wyświetla datę wg formatu krótkiej daty, ustawionego przez system
Short Time Wyświetla czas w formacie 24-godzinnym

Znaki używane podczas samodzielnego tworzenia formatów dla daty i czasu:

Znak Opis

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 58


Spis treści 59

(:) Separator czasu oddzielający godziny, minuty i sekundy


(/) Separator daty oddzielający dzień, miesiąc i rok
c Wyświetla datę jako ddddd i czas jako ttttt, w tej kolejności. Wyświetla tylko datę, jeżeli
nie ma części ułamkowej wartości liczbowej daty, i wyświetla tylko czas, jeżeli nie ma
części całkowitej
d Wyświetla dzień jako liczbę bez zera na początku (np. 3 zamiast 03)
dd Wyświetla dzień jako liczbę z zerem na początku (np. 03 zamiast 3)
ddd Wyświetla dzień w skrócie (skróty ang. np.: Thu, Fri)
dddd Wyświetla dzień jako pełną nazwę (nazwy ang. np.: Thursday, Friday)
ddddd Wyświetla datę jako kompletną datę (dzień, miesiąc, rok) w postaci krótkiej daty systemowej
(najczęściej m/d/yy)
ddddd Wyświetla datę jako kompletną datę (dzień, miesiąc, rok) w postaci krótkiej daty systemowej
d (najczęściej mmmm dd, yyyy)
w Wyświetla dzień tygodnia w postaci liczby (od 1 dla niedzieli do 7 dla soboty)
ww Wyświetla tydzień w roku jako liczbę (od 1 do 54)
m Wyświetla miesiąc jako liczbę bez zera na początku (od 1 do 12). Jeżeli występuje
bezpośrednio po „h” lub „hh” — minuty są wyświetlone zamiast miesiąca
mm Wyświetla miesiąc jako liczbę z zerem na początku (od 01 do 12). Jeżeli występuje
bezpośrednio po „h” lub „hh” — minuty są wyświetlone zamiast miesiąca
mmm Wyświetla miesiąc w skrócie (skróty ang. np.: Jan, Dec)
mmmm Wyświetla miesiąc jako pełną nazwę (nazwy ang. np.: January, December)
q Wyświetla kwartał roku jako liczbę (od 1 do 4)
y Wyświetla dzień jako liczbę (od 1 do 366)
yy Wyświetla rok jako dwucyfrową liczbę (od 00 do 99)
yyyy Wyświetla rok jako czterocyfrową liczbę (od 100 do 9999)
h Wyświetla godzinę jako liczbę bez zera na początku (od 0 do 23)
hh Wyświetla godzinę jako liczbę z zerem na początku (od 00 do 23)
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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 59


Spis treści 60

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")
'zmienna przyjmie wartość 22

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:
♦ Czas (wymagany) — wyrażenie numeryczne lub zmienna reprezentująca czas.

Przykład:
Komunikat = Minute("22:53:29")
'zmienna przyjmie wartość 53

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 60


Spis treści 61

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

2.2.1.13. Second
Funkcja Minute 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:
♦ Czas (wymagany) — wyrażenie numeryczne lub zmienna reprezentująca czas.

Przykład:
Komunikat = Minute("22:53:29")
'zmienna przyjmie wartość 29

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 61


Spis treści 62

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łynęły od północy.

Składnia:
Timer

Przykład:
Komunikat = Timer
'przy założeniu, że obecnie jest np. godz. O:59,
'zmienna przyjmie wartość 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.

Składnia:
TimeSerial(godzina, minuta, sekunda)

gdzie:
♦ godzina (wymagany) — liczba typu Integer z zakresu 0 do 23
reprezentująca godzinę,
♦ minuta (wymagany) — liczba typu Integer z zakresu 0 do 59
reprezentująca minutę,
♦ sekunda (wymagany) — liczba typu Integer z zakresu 0 do 59
reprezentująca sekundę.

Przykład:
Komunikat = TimeSerial(12, 54, 27)
'zmienna przyjmie wartość w formacie czasu; "12:54:27"

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 62


Spis treści 63

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ę,

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


tygodnia (patrz 2.2.1.3).

Wartości zwracane przez funkcję Weekday:

Stała Wartość Opis

vbSunday 1 niedziela (domyślnie)


vbMonday 2 poniedziałek
vbTuesday 3 wtorek
vbWednesday 4 środa

Stała Wartość Opis

vbThursday 5 czwartek
vbFriday 6 piątek

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 63


Spis treści 64

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ą
numer 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")
'zmienna przyjmie wartość 1998

2.2.2. Konwertujące
2.2.2.1. Array
Funkcja Array zwraca wartość typu Variant, zawierającą tablicę.

Składnia:
Array(ListaArgumentów)

gdzie:
♦ ListaArgumentów (wymagany) — lista wartości, oddzielonych od
siebie 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
reprezentują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)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 64


Spis treści 65

'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ą
liczbą, zostanie ona zaokrąglona do najbliższej poprawnej liczby.

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


poprzedzają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

Przykład:
Dim zm1 As Variant
zm1 = 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
szesnastkowym) zapisem wprowadzonej jako parametr wartości.

Składnia:
Hex(Wartość)

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 65


Spis treści 66

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

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


poprzedzają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 Variant
zm1 = 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:
♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne lub
łańcuchowe.

Przykład:
zmiennaA=5
zmiennaB=5
wynik=CBool(zmiennaA=zmiennaB)
'zmienna "wynik" przyjmuje wartość TRUE,
'ponieważ wyrażenie jest prawdziwe

zmiennaA=0
wynik=CBool(zmiennaA)
'zmienna "wynik" przyjmuje wartość FALSE

2.2.2.5. CByte
Funkcja CByte konwertuje wprowadzone wyrażenie na typ Byte.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 66


Spis treści 67

Składnia:
CByte(Wyrażenie)

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

Przykład:
zmA=245.5643
varByte=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.12129
zmB=CCur(zmA*2)
'po konwersji wyniku wyrażenia zmA*2 (312.24258)
'do typu zmienna zmB przyjmuje wartość 312.2426

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ńcuchowe okreś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).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 67


Spis treści 68

Przykład:
zmA="1969, Luty 12" 'podstawienie daty
zmC=CDate(zmA) 'konwersja do typu Data
zmB="4:35:47" 'podstawienie czasu
zmC=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.

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 miejsc
dziesię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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 68


Spis treści 69

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 zakresie
32,768 do 32,767 (część ułamkowa zostaje zaokrąglona, w przypadku
0,5 — zawsze „w dół”).

Przykład:
zmA= 12,5
zmB=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ół”).

Przykład:
zmA= 123.5
zmB=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-45
do 3,402823E38 dla wartości dodatnich.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 69


Spis treści 70

Przykład:
zmA= 312.365
zmB=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


łańcuch zawierający datę w krótkim formacie zgodnym z ustawieniami
Date
systemowymi
Null błąd (run-time)
Empty (pusty) łańcuch zerowej długości ("")
Error (błąd) słowo Error poprzedzone numerem błędu
Inne wartości numeryczne łańcuch zawierający te wartości

Przykład:
zmA=515.333
zmB=CSng(zmA)
'konwersja wyniku wyrażenia na typ String

2.2.2.14. CVar
Funkcja CVar konwertuje wprowadzone wyrażenie na typ Variant.

Składnia:
CVar(Wyrażenie)

gdzie:
♦ Wyrażenie (wymagany) — dowolne wyrażenie numeryczne lub
łańcuchowe.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 70


Spis treści 71

Przykład:
zmA="28694"
zmB=CVar(zmA)
'konwersja wyniku wyrażenia na typ Variant

2.2.3. Matematyczne
2.2.3.1. Abs
Funkcja Abs zwraca wartość bezwzględną podanej wartości podanego typu.

Składnia:
Abs(wartość)

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

Przykład:
zmA=326,3
zmB=Abs (zmA) 'zmienna przyjmuje wartość 326.3
zmC=Abs(-89.6) 'zmienna przyjmuje wartość 89.6

2.2.3.2. Atn
Funkcja Atn zwraca wartość funkcji arcus tangens (typu Double) podanego kąta.

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łą
matematyczną 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 71


Spis treści 72

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 numeryczne
określające kąt w radianach.

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:
♦ Wartość (wymagany) — typu Double lub dowolne wyrażenie
numeryczne.

Funkcja Fix 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ą większą (lub równą) od podanej.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 72


Spis treści 73

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:
♦ Wartość (wymagany) — typu Double lub dowolne wyrażenie
numeryczne.

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.

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ść)]

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 73


Spis treści 74

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

Wartości zwracane przez funkcję:

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.

Składnia:
Sgn(Wartość)

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

Wartości zwracane przez funkcję:

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 74


Spis treści 75

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
numeryczne okreś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
Double.

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 wygenerowany
błą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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 75


Spis treści 76

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ą


odpowiednio do instrukcji zawartych w wyrażeniu.

Składnia:
Format (Wyrażenie[, Format [, PierwszyDzieńTygodnia[,
PierwszyTydzieńRoku]]])

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

♦ 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ńRoku 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
zawiera 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 76


Spis treści 77

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 format
wyś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
średnikami.

Przy użyciu Otrzymany wynik

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


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


Wyświetla liczbę z separatorem tysięcy, jeżeli jest potrzebny; wyświetla dwie
Currency cyfry do prawej strony separatora dziesiętnego. Formatowanie jest oparte na
ustawieniach lokalnych w systemie
Wyświetla przynajmniej jedną cyfrę od lewej i dwie cyfry od prawej strony
Fixed
separatora dziesiętnego
Wyświetla liczbę z separatorem tysięcy, przynajmniej jedną cyfrę od lewej
Standard
i dwie cyfry od prawej strony separatora dziesiętnego
Wyświetla liczbę pomnożoną przez 100 ze znakiem procentu (%) dołączonym
Percent do prawej strony, zawsze wyświetla dwie cyfry po prawej stronie separatora
dziesiętnego
Scentific Używa standardowego formatu wykładniczego

Yes/No
Wyś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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 77


Spis treści 78

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
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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 78


Spis treści 79

Znak Opis

E+ E– e+ Format wykładniczy. Umieszczenie jednego z symboli wykładniczych z prawej strony


e– znakó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 ("))

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"

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 79


Spis treści 80

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"

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
litery.

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"

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 80


Spis treści 81

2.2.4.3. UCase
Funkcja LCase zwraca łańcuch znakowy (typu String) przekonwertowany na duże
litery.

Składnia:
LCase(Łańcuch)

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

Przykład:
zmA = UCase("To jEst teKsT", "<")
'zmienna przyjmuje wartość "TO JEST TEKST"

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:

Stała Wartość Opis

vbUpperCase 1 konwersja na duże litery


vbLowerCase 2 konwersja na małe litery
vbProperCas
e 3 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 81


Spis treści 82

vbFromUnico
de 128 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
specyfikacji bez początkowych spacji.

Składnia:
LTrim(Łańcuch)

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

Przykład:
zmA=" To Jest Tekst"
zmB=LTrim(zmA)
'zmienna przyjmuje wartość "To Jest Tekst"

2.2.4.6. RTrim
Funkcja RTrim zwraca łańcuch znakowy (typu String) przekonwertowany wg
specyfikacji bez końcowych spacji.

Składnia:
RTrim(Łańcuch)

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

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
specyfikacji bez początkowych i końcowych spacji.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 82


Spis treści 83

Składnia:
Trim(Łańcuch)

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

Przykład:
zmA=" To Jest Tekst "
zmB=Ltrim(zmA)
'zmienna przyjmuje wartość "To Jest Tekst"

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:
♦ Łańcuch (wymagany) — dowolne wyrażenie łańcuchowe,

♦ 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:
♦ Łańcuch (wymagany) — dowolne wyrażenie łańcuchowe,

♦ 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 83


Spis treści 84

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ą
liczbę znaków od prawej strony łańcucha.

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

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

♦ 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:
♦ Łańcuch (wymagany) — dowolne wyrażenie łańcuchowe,

♦ 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 84


Spis treści 85

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,
♦ 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ą
liczbę 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
samych znaków.

Składnia:
String(Długość, Znak)

gdzie:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 85


Spis treści 86

♦ 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.

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:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 86


Spis treści 87

♦ NazwaZmiennej (wymagany) — identyfikator zmiennej.

Przykład:
zmA=29
zmB=IsArray(varZmienna) 'varCzyTablica=False
'zmienna zmB przyjmuje wartość False, ponieważ sprawdzana
'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 wymiaru
tablicy, 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 dopuszczalny
numer indeksu dla elementów wybranego wymiaru tablicy.

Składnia:
UBound(NazwaZmiennej [,NumerWymiaru])

gdzie:
♦ NazwaZmiennej (wymagany) — identyfikator zmiennej zawierającej
tablicę,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 87


Spis treści 88

♦ 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 Variant
Dim zmB (33) As Variant

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ć konwertowana
zmA="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ą, czy
badane wyrażenie może być konwertowane na liczbę.

Składnia:
IsNumeric(Wyrażenie)

gdzie:
♦ Wyrażenie (wymagany) — dowolne wyrażenie łańcuchowe lub
numeryczne.

Przykład:
zmA="253.105"
zmB=IsNumeric(zmA)
'zmienna zmB przyjmuje wartość True, ponieważ sprawdzana

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 88


Spis treści 89

'zmienna może być konwertowana


zmA="Tekst testowy"
zmB=IsNumeric(zmA)
'zmienna zmB przyjmuje wartość False, ponieważ sprawdzana
'zmienna nie może być konwertowana

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=Null
zmB=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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 89


Spis treści 90

Składnia:
IsMissing(NazwaArgumentu)

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:

Stała Wartość Opis

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 90


Spis treści 91

vbVariant 12 Variant (tylko dla tablic Variant)

Stała Wartość Opis

vbDataObje
ct 13 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=False
zmB=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ątkiem zmiennych 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)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 91


Spis treści 92

Double wartość typu Double (zmiennoprzecinkowa)

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
uruchamianiu 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ń

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 92


Spis treści 93

2.2.6.2. CurDir
Funkcja CurDir zwraca wartość typu String, zawierającą bieżącą ścieżkę dyskową.

Składnia:
CurDir[(Dysk)]

gdzie:
♦ Dysk (opcja) — wyrażenie łańcuchowe określające istniejący dysk. Gdy
nie zostanie podany lub zostanie podany w postaci łańcucha o zerowej
długości (""), funkcja zwróci ścieżkę na bieżącym dysku.

Przykład:
zmA=CurDir
'zmienna przyjmuje wartość bieżącej ścieżki
'na bieżącym dysku

zmA=CurDir("D")
'zmienna przyjmuje wartość bieżącej ścieżki
'na dysku „D”

2.2.6.3. Dir
Funkcja Dir zwraca wartość typu String, reprezentującą nazwę pliku i katalogu
znalezionego wg specyfikacji lub atrybuty pliku lub nazwę wolumenu dysku.

Składnia:
Dir [(ŚcieżkaDostępu [, Atrybuty])]

gdzie:
♦ ŚcieżkaDostępu (opcja) — wyrażenie łańcuchowe określające nazwę
pliku. Może też zawierać nazwę katalogu i dysk,
♦ Atrybuty (opcja) — wyrażenie określające stałe lub wartości
reprezentujące atrybuty plików. Gdy zostanie pominięte, zwrócone będą
nazwy wszystkich znalezionych plików w podanej lokalizacji.

Wartości i stałe argumentu Atrybuty:

Stała Wartość Opis

vbNormal 0 normalny (domyślny)


vbHidden 2 ukryty
vbSystem 4 systemowy
vbVolume 16 nazwa wolumenu, jeżeli jest określony, inne parametry są ignorowane
vbArchiv
e 32 plik został zmieniony od ostatniego wykonania kopii zapasowej

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 93


Spis treści 94

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ą
systemową 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 94


Spis treści 95

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
pliku.

Składnia:
FileAttr(NrPliku, ZwracanyTyp)

gdzie:
♦ NrPliku (wymagany) — wyrażenie typu Integer zawierające numer
otwartego pliku,
♦ ZwracanyTyp (wymagany) — wyrażenie typu Integer określające
rodzaj zwróconej wartości. Argument może przyjąć wartość 1 lub 2, przy
czym wartość 2 wykorzystywana jest tylko w systemach 16-bitowych i nie
jest obsługiwana w systemach 32-bitowych.

Wartości zwracane przez funkcję, w przypadku gdy wartość argumentu


ZwracanyTyp 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 ostatniej
modyfikacji pliku.

Składnia:
FileDateTime(ŚcieżkaDoPliku)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 95


Spis treści 96

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
numerem, 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"

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 96


Spis treści 97

2.2.6.10. GetAttr
Funkcja GetAttr zwraca wartość typu Integer, określającą atrybut pliku lub
katalogu (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ę:

Stała Wartość Opis

vbNormal 0 normalny (domyślny)


vbReadOnly 1 tylko do odczytu
vbHidden 2 ukryty
vbSystem 4 systemowy
vbDirector
y
16 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)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 97


Spis treści 98

gdzie:
♦ Numer (wymagany) — wyrażenie numeryczne określające numer znaku
do zwrócenia,
♦ NrPliku (wymagany) — wyrażenie typu Integer zawierające numer
otwartego 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
pasku tytuł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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 98


Spis treści 99

'położeniu

2.2.6.13. LoadPicture
Funkcja LoadPicture ładuje plik z grafiką do właściwości formy — Picture (patrz
3.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
zapisu otwartego pliku.

Składnia:
Loc(NrPliku)

gdzie:
♦ NrPliku (wymagany) — wyrażenie typu Integer zawierające numer
otwartego pliku.

Wartości zwracane przez funkcję:

Tryb Zwracana wartość

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 99


Spis treści 100

2.2.6.15. LOF
Funkcja LOF zwraca wartość typu Long, reprezentującą rozmiar otwartego wcześniej
pliku w bajtach.

Składnia:
LOF(NrPliku)

gdzie:
♦ NrPliku (wymagany) — wyrażenie typu Integer zawierające numer
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ści
okreś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 pasku
tytułowym okienka,
♦ 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.

Wartości i stałe argumentu Przyciski:

Stała Wartość Opis

vbOKOnly 0 tylko przycisk OK (Dobrze)


vbOKCancel 1 przyciski OK (Dobrze) oraz Cancel (Anuluj)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 100


Spis treści 101

vbAbortRetryIgnor 2 przyciski Abort (Przerwij), Retry (Ponów) oraz Ignore (Zignoruj)


e
vbYesNoCancel 3 przyciski Yes (Tak), No (Nie) i Cancel (Anuluj)
vbYesNo 4 przyciski Yes (Tak) i No (Nie)

Stała Wartość Opis

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 0 okno modalne dla aplikacji, użytkownik musi zareagować
l
vbSystemModal 4096 okno modalne dla systemu, wszystkie aplikacje są zawieszone,
dopóki użytkownik nie zareaguje
vbMsgBoxHelpButto 16384 dodaje przycisk Help (Pomoc)
n
VbMsgBoxSetForegr 65536 okienko komunikatu będzie zawsze „na wierzchu”
ound
vbMsgBoxRight 524288 tekst jest wyrównany do prawej
vbMsgBoxRtlReadin 1048576 tekst w systemach arabskich i hebrajskich (czytany od prawej do
g 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 101


Spis treści 102

Składnia:
Seek(NrPliku)

gdzie:
♦ NrPliku (wymagany) — wyrażenie typu Integer zawierające numer
otwartego pliku.

Wartości zwracane przez funkcję:

Tryb Zwracana wartość

Random numer następnego rekordu do odczytu lub zapisu w pliku


Binary, Output, Append, pozycja bajta, na którym będzie wykonana następna operacja
Input

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ące
poprawną ś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:

Stała Wartość Opis

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 102


Spis treści 103

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ące poprawną ścieżką dostępu do uruchamianej aplikacji (wraz z jej
ewentualnymi argumentami wiersza poleceń),
♦ StylOkna (opcja) — wyrażenie lub stała określająca styl okna
uruchamianej aplikacji.

Wartości i stałe atrybutu StylOkna:

Stała Wartość Opis

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
vbNormalNoFocus 4 Okno ma normalny rozmiar i pozycję. Aktualnie aktywne okno
pozostaje aktywne
vbMinimizedNoFoc 6 Okno jest zminimalizowane. Aktualnie aktywne okno pozostaje
us 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ć
inne zdarzenia.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 103


Spis treści 104

Składnia:
DoEvents()

Przykład:
If zm1=2500 Then
DoEvents
'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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 104


Spis treści 105

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
podanym numerze.

Składnia:
QBColor(Kolor)

gdzie:
♦ Kolor (wymagany) — wyrażenie typu Integer będące prawidłowym
numerem 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)
7 biały (White)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 105


Spis treści 106

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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 106


Spis treści 107

Rozdział 3.
Obiekty w VB
Obiekty w Visual Basicu odgrywają kluczową rolę. Nie trzeba od samych podstaw
kodować wyświetlania grafiki czy rozwijanego menu. Zamiast tego wstawiamy
gotowe 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
niezmiernie łatwa. Otóż nie — sprawne i efektywne korzystanie z obiektów wymaga
wiedzy 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ć
pliki AVI bez dźwięków.

Próba załadowania pliku *.avi, zawierającego dźwięk, lub pliku w innym formacie
zakoń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
♦ 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 107


Spis treści 108

♦ 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ór
może paść na więcej niż jedną). Wyświetla ona znak potwierdzenia przy wybranej opcji.

Dostępne zdarzenia:
♦ Click (ActiveX) — wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — generowane po naciśnięciu przycisku
♦ KeyPress — generowane po naciśnięciu i zwolnieniu przycisku
♦ KeyUp — generowane po zwolnieniu przycisku
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę


♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 108


Spis treści 109

3.1.3. ComboBox
Kontrolka ComboBox jest listą rozwijalną, do której użytkownik może sam
wprowadzić wartości lub korzystać z już wyświetlanych. Dodawać lub usuwać
wartości z listy można programowo, za pomocą odpowiednich metod.

Dostępne zdarzenia:
♦ Change — zmiana wartości kontrolki
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ DrapDown — rozwinięcie ComboBox do listy
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — generowane po naciśnięciu przycisku
♦ KeyPress — generowane po naciśnięciu i zwolnieniu przycisku
♦ KeyUp — generowane po zwolnieniu przycisku
♦ LostFocus — utracenie fokusa
♦ Scroll — zmiana pozycji na pasku przewijania

Dostępne metody:
♦ AddItem — dodanie elementu do listy kontrolki

♦ Clear — wyczyszczenie zawartości kontrolki

♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop


♦ Refresh — odświeżenie zawartości obiektu

♦ RemoveItem — usunięcie elementu z listy kontrolki

♦ SetFocus — przeniesienie fokusa na kontrolkę


♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.4. CommandButton
Za pomocą kontrolki Button można stworzyć standardowy przycisk.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 109


Spis treści 110

Dostępne zdarzenia:
♦ Click (ActiveX) — wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — generowane po naciśnięciu przycisku
♦ KeyPress — generowane po naciśnięciu i zwolnieniu przycisku
♦ KeyUp — generowane po zwolnieniu przycisku
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę


♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.5. CommonDialog
Kontrolka CommonDialog umożliwia wykorzystanie standardowych okien
dialogowych. Kontrolka ta wykorzystuje standardową bibliotekę Windows —
commdlg.dll. Aby móc stosować tę kontrolkę, biblioteka commdlg.dll musi się
znajdować w katalogu 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 110


Spis treści 111

♦ 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
programie zapewnia przede wszystkim możliwość manipulowania danymi poprzez
inne, skojarzone kontrolki. Z kontrolką Data, a co za tym idzie z bazą danych, można
skojarzyć następujące kontrolki:
♦ ComboBo ♦ Label
x
♦ CheckBox ♦ ListBox
♦ DBComb ♦ MSFlexGrid
o
♦ DBGrid ♦ OLEContainer
♦ DBList ♦ PictureBox
♦ Image ♦ TextBox

Dostępne zdarzenia:
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ Error — wystąpił błąd zewnętrzny Visual Basic
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 111


Spis treści 112

♦ Resize — zmiana rozmiaru obiektu


♦ Validate — inny rekord ma stać się bieżącym

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop


♦ Refresh — odświeżenie zawartości obiektu

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ UpdateControls — wyświetlenie bieżącego rekordu w kontrolkach


połączonych
♦ UpdateRecord — zapisanie wartości kontrolek połączonych

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.7. DBCombo
Kontrolka DBCombo tworzy okno rozwijalne, automatycznie wypełniane z bazy
danych, 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ć
wykorzystywane do edytowania wybranego pola. Za jej pomocą można szybko
przeszukiwać elementy skojarzone z odpowiednią kontrolką Data.

Dostępne zdarzenia:
♦ Change — zmiana wartości kontrolki
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 112


Spis treści 113

♦ MouseUp — wciśnięcie przycisku myszy


♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refill — odświeżenie zawartości listy

♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.7. DBGrid
Kontrolka DBGrid służy do wyświetlania zawartości pól bazy danych w
uporządkowanej formie, przypominającej Accessa. Jest to zbiór wierszy i kolumn,
zawartych w jednej tabeli. Liczbę wyświetlanych wierszy i kolumn można określać
poprzez odpowiednie właściwości (maksymalna liczba wierszy jest uzależniona od
zasobów systemowych komputera, kolumn zaś można wyświetlić 1700). Wartości w
poszczególnych komórkach tabeli mogą być edytowane.

Dostępne zdarzenia:
♦ 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 113


Spis treści 114

♦ 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
♦ Change — zmiana wartości kontrolki
♦ Click — wciśnięcie przycisku myszy
♦ ColEdit — edytowanie kolumny
♦ ColResize — zmiana rozmiarów kolumny
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ Error — wystąpił błąd zewnętrzny Visual Basic
♦ GotFocus — otrzymanie fokusa
♦ HeadClick — kliknięcie nagłówka kolumny
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OnAddNew — wywołanie operacji AddNew
♦ RowColChange — zmiana bieżącej komórki
♦ RowResize — zmiana rozmiaru wiersza
♦ Scroll — zmiana pozycji na pasku przewijania
♦ SelChange — zmiana zaznaczenia
♦ SplitChange — zmiana bieżącej wykorzystywanej linii podziału
♦ UnboundAddData — dodanie nowego rekordu do kontrolki nie połączonej

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 114


Spis treści 115

♦ UnboundDeleteRow — usunięcie rekordu kontrolki nie połączonej


♦ UnboundGetRelativeBookmark — wyświetlanie danych kontrolki nie
połą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

♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ GetBookmark — zakładka wybranego wiersza


♦ HoldFields — zapamiętanie ustawień bieżącej kolumny

♦ Move — zmiana położenia obiektu

♦ Rebind — odtworzenie kontrolki

♦ Refresh — odświeżenie zawartości obiektu

♦ RowBookmark — zakładka widzialnych wierszy kontrolki


♦ RowContaining — indeks komórki o określonych współrzędnych

♦ RowTop — współrzędne określonego wiersza

♦ Scroll — zmiana pozycji na pasku przewijania

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ SplitContaining — linia podziału o określonych współrzędnych


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.8. DBList
Kontrolka DBGrid 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.

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 115


Spis treści 116

♦ DblClick — podwójne wciśnięcie przycisku myszy


♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop Refill odświeżenie zawartości


listy
♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 116


Spis treści 117

3.1.9. Debug
Za pomocą obiektu Debug możliwa jest kontrola programu w fazie jego
wykonywania.

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ów
wraz ze ścieżkami dostępu do nich.

Dostępne zdarzenia:
♦ Change — zmiana zawartości kontrolki
♦ Click — wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 117


Spis treści 118

♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop


♦ Scroll — zmiana pozycji na pasku przewijania

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop


♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.11. DriveListBox
Kontrolka DriveListBox wyświetla w sposób hierarchiczny listę dostępnych napędów
dyskowych.

Dostępne zdarzenia:
♦ Change — zmiana zawartości kontrolki
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 118


Spis treści 119

♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop


♦ Scroll — zmiana pozycji na pasku przewijania

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop


♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.12. FileListBox
Kontrolka FileListBox wyświetla w sposób hierarchiczny listę dostępnych plików
w wybranym wcześniej katalogu (folderze).

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w operacji OLE drag/drop

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 119


Spis treści 120

♦ 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop
♦ PathChange — zmiana ścieżki dostępu
♦ PatternChange — zmiana maski plików
♦ Scroll — zmiana pozycji na pasku przewijania

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

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).

Dostępne zdarzenia:
♦ Activate — obiekt staje się aktywny
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DeActivate — obiekt staje się nieaktywny
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ Initialize — tworzenie nowej instancji obiektu
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 120


Spis treści 121

♦ KeyUp — zwolnienie klawisza


♦ 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
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie 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

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

♦ Move — zmiana położenia obiektu


♦ OLEDrag — rozpoczęcie operacji drag/drop

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 121


Spis treści 122

♦ 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

♦ Refresh — odświeżenie zawartości obiektu


♦ 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

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ 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?

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.14. Frame
Kontrolka Frame jest ramką, dzięki której można grupować inne kontrolki.

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w operacji OLE drag/drop

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 122


Spis treści 123

♦ 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu


♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.15. HScroolBar
Kontrolka HScrollBar jest poziomym paskiem przewijania, pozwalającym na
nawigację różnorakimi listami. Po określeniu dopuszczalnych zakresów zmian
kontrolki może być wykorzystana jako wskaźnik wartości.

Dostępne zdarzenia:
♦ Change — zmiana wartości kontrolki
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ Scroll — zmiana pozycji na pasku przewijania

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki
♦ Move — zmiana położenia obiektu

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 123


Spis treści 124

♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.16. Image
Kontrolki Image umożliwiają wyświetlanie obrazków graficznych (*.bmp, *.ico,
*.wmf, *.emf, *.jpeg, *.gif).

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu


♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 124


Spis treści 125

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.17. Label
Kontrolka Label pozwala wyświetlić tekst bez możliwości jego modyfikacji.

Dostępne zdarzenia:
♦ Change — zmiana wartości kontrolki
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ LinkClose — zakończenie konwersacji DDE
♦ LinkError — błąd konwersacji DDE
♦ LinkNotify — zmiana danych konwersacji DDE
♦ LinkOpen — inicjacja konwersacji DDE
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

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)
♦ LinkPoke — przeniesienie zawartości obiektu do aplikacji źródła ciągu
poleceń podczas operacji dynamicznej wymiany danych (DDE)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 125


Spis treści 126

♦ 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)
♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop


♦ Refresh — odświeżenie zawartości obiektu

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.18. Line
Kontrolka Line pozwala wstawiać na formularzu linie.

Dostępne metody:
♦ Refresh — odświeżenie zawartości obiektu

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.19. ListBox
Kontrolka ListBox pozwala wyświetlić listę określonych elementów, aby umożliwić
ich wybór.

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ ItemCheck — wybranie lub usunięcie elementu z listy
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 126


Spis treści 127

♦ MouseMove — przesuwanie wskaźnika myszy


♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop
♦ Scroll — zmiana pozycji na pasku przewijania

Dostępne metody:
♦ AddItem — dodanie elementu do listy kontrolki
♦ Clear — wyczyszczenie zawartości kontrolki

♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu


♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu

♦ RemoveItem — usunięcie elementu z listy kontrolki

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.20. MDIForm
Obiekt MDIForm jest częścią interfejsu użytkownika, stworzonego przez pisany
program. Jest również formą zawierającą w sobie formy potomne (kontenerem).

Dostępne zdarzenia:
♦ Activate — obiekt staje się aktywny
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 127


Spis treści 128

♦ DeActivate — obiekt staje się nieaktywny


♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ 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
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop
♦ QueryUnload — zamykana jest forma lub aplikacja
♦ Resize — zmiana rozmiaru obiektu
♦ Terminate — usunięto wszystkie referencje obiektu
♦ UnLoad — usunięcie obiektu z pamięci

Dostępne metody:
♦ Arrange — ułożenie okien lub ikon wewnątrz obiektu

♦ Hide — ukrycie obiektu

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop


♦ PopupMenu — wyświetlenie menu pop-up

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 128


Spis treści 129

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ Show — wyświetlenie obiektu

♦ WhatsThisMode — włączenie trybu What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.21. Menu
Kontrolka Menu tworzy w pisanej aplikacji standardowe menu, mogące zawierać
polecenia, podmenu i separatory.

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy

3.1.22. OLE
Kontrolka OLE pozwala na wstawianie do tworzonego programu obiektów z innych
aplikacji.

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ Resize — zmiana rozmiaru obiektu
♦ Updated — zmiana danych obiektu

Dostępne metody:
♦ Close — zamknięcie obiektu

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 129


Spis treści 130

♦ 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

♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki


♦ FetchVerbs — uaktualnienie listy akcji obiektu

♦ InsertObjDlg — wyświetlenie okna dialogowego Insert Object

♦ Move — zmiana położenia obiektu

♦ 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

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ Update — pobranie nowych danych z aplikacji obiektu

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.23. OptionButton
Kontrolka OptionButton daje użytkownikowi możliwość dokonania wyboru opcji (wybór
może paść tylko na jedną). Wyświetla znak potwierdzenia przy wybranej opcji.

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 130


Spis treści 131

♦ KeyUp — zwolnienie klawisza


♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu


♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.24. Panel
Obiekt Panel jest panelem używanym zazwyczaj do pokazywania bieżącego stanu
aplikacji (jest jej paskiem stanu).

Zdarzeń i metod brak

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 131


Spis treści 132

3.1.25. PictureBox
Kontrolki Image umożliwiają wyświetlanie obrazków graficznych (*.bmp, *.ico,
*.wmf, *.emf, *.jpeg, *.gif).

Dostępne zdarzenia:
♦ Change — zmiana wartości kontrolki
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LinkClose — zakończenie konwersacji DDE
♦ LinkError — błąd konwersacji DDE
♦ LinkNotify — zmiana danych konwersacji DDE
♦ LinkOpen — inicjacja konwersacji DDE
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w operacji OLE drag/drop
♦ OLEDragOver — przeciąganie jednego komponentu nad drugim w operacji
OLE drag/drop
♦ OLEGiveFeedback — zakończono zdarzenie OLEDragOver w operacji
OLE drag/drop
♦ OLESetData — brak danych w odpowiednim formacie dla komponentu
docelowego w operacji OLE drag/drop
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop
♦ Paint — odsłonięcie części obiektu
♦ Resize — zmiana rozmiaru obiektu

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 132


Spis treści 133

Dostępne metody:
♦ Circle — narysowanie elipsy, okręgu lub łuku na obiekcie
♦ Cls — wyczyszczenie grafik stworzonych na obiekcie
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Line — narysowanie linii lub prostokąta na obiekcie


♦ 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)
♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ PaintPicture — narysowanie zawartości pliku na obiekcie

♦ Point — pobranie wartości koloru RGB określonego punktu na obiekcie

♦ PSet — narysowanie punktu o określonym kolorze na obiekcie


♦ Refresh — odświeżenie zawartości obiektu

♦ 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

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ TextHeight — zwrócenie wysokości tekstu w aktualnie wybranej
czcionce
♦ TextWidth — zwrócenie szerokości tekstu w aktualnie wybranej czcionce

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.26. Printer
Obiekt Printer pozwala na komunikację z zainstalowaną w systemie drukarką.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 133


Spis treści 134

Dostępne metody:
♦ Circle — narysowanie elipsy, okręgu lub łuku na obiekcie

♦ EndDoc — kończy drukowanie i zwalnia drukarkę

♦ KillDoc — przerwanie bieżącego wydruku

♦ Line — narysowanie linii lub prostokąta na obiekcie

♦ NewPage — rozpoczyna drukowanie nowej strony


♦ PaintPicture — narysowanie zawartości pliku na obiekcie

♦ 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

♦ TextHeight — zwrócenie wysokości tekstu w aktualnie wybranej


czcionce
♦ TextWidth — zwrócenie szerokości tekstu w aktualnie wybranej czcionce

3.1.27. ProgressBar
Kontrolka ProgressBar stosowana jest zazwyczaj do graficznego pokazywania
stopnia zaawansowania w wykonaniu różnych operacji.

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w operacji OLE drag/drop
♦ OLEDragOver — przeciąganie jednego komponentu nad drugim w operacji
OLE drag/drop
♦ OLEGiveFeedback — zakończono zdarzenie OLEDragOver

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 134


Spis treści 135

♦ OLESetData — brak danych w odpowiednim formacie dla komponentu


docelowego w operacji OLE drag/drop
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu


♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

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:
♦ Move — zmiana położenia obiektu

♦ Refresh — odświeżenie zawartości obiektu

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.29. Slider
Kontrolka Shape jest suwakiem i służy do zmiany określonych wartości w tworzonym
programie.

Dostępne zdarzenia:
♦ Change — zmiana wartości kontrolki
♦ Click — wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 135


Spis treści 136

♦ MouseDown — wciśnięcie przycisku myszy


♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop
♦ Scroll — przewinięcie kontrolki

Dostępne metody:
♦ ClearSel — wyczyszczenie zaznaczenia

♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ GetNumTicks — pobranie liczby znaczników


♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.30. SSTab
Kontrolka SSTab umożliwia tworzenie standardowych zakładek, gdzie na każdej z nich
można umieszczać inne kontrolki.

Dostępne zdarzenia:
♦ Click — kliknięcie na zakładce
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 136


Spis treści 137

♦ DragOver — przeciąganie obiektu


♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ SetFocus — przekazuje fokus obiektowi

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.31. StatusBar
Kontrolka StatusBar jest paskiem stanu tworzonej aplikacji, używanym zazwyczaj do
pokazywania bieżącego stanu aplikacji.

Dostępne zdarzenia:
♦ Click — wciśnięcie przycisku myszy

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 137


Spis treści 138

♦ DblClick — podwójne wciśnięcie przycisku myszy


♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop
♦ PanelClick — wciśnięcie przycisku myszy nad panelem
♦ PanelDblClick — podwójne wciśnięcie przycisku myszy nad panelem

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu


♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.32. TabStrip
Kontrolka TabStrip umożliwia tworzenie standardowych zakładek, gdzie na każdej z nich
można umieszczać inne kontrolki.

Dostępne zdarzenia:
♦ BeforeClick — kliknięcie zakładki
♦ Click — wciśnięcie przycisku myszy

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 138


Spis treści 139

♦ DragDrop — zakończenie przeciągania obiektu


♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki

♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przekazuje fokus obiektowi


♦ ShowWhatsThis — wyświetlenie pomocy What’s This?

♦ ZOrder — zmiana kolejności z-order obiektów

3.1.33. TextBox
Kontrolka TextBox jest polem tekstowym, do którego użytkownik może sam
wprowadzić wartości lub edytować już wyświetlane.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 139


Spis treści 140

Dostępne zdarzenia:
♦ Change — zmiana wartości kontrolki
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LinkClose — zakończenie konwersacji DDE
♦ LinkError — błąd konwersacji DDE
♦ LinkNotify — zmiana danych konwersacji DDE
♦ LinkOpen — inicjacja konwersacji DDE
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

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)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 140


Spis treści 141

♦ 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)
♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu

♦ SetFocus — przeniesienie fokusa na kontrolkę

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.34. ToolBar
Kontrolka Toolbar zawiera kolekcję obiektów Button i służy do tworzenia pasków
narzędziowych dla tworzonej aplikacji.

Dostępne zdarzenia:
♦ ButtonClick — kliknięcie przycisku Button
♦ Change — zakończenie dostosowywania kontrolki przez użytkownika
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w operacji OLE drag/drop
♦ OLEDragOver — przeciąganie jednego komponentu nad drugim w operacji
OLE drag/drop
♦ OLEGiveFeedback — zakończono zdarzenie OLEDragOver

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 141


Spis treści 142

♦ OLESetData — brak danych w odpowiednim formacie dla komponentu


docelowego w operacji OLE drag/drop
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop

Dostępne metody:
♦ Customize — wywołanie okna dialogowego Customize

♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki


♦ Move — zmiana położenia obiektu

♦ OLEDrag — rozpoczęcie operacji drag/drop

♦ Refresh — odświeżenie zawartości obiektu RestoreToolbar, odtworzenie


stanu początkowego kontrolki
♦ SaveToolbar — zapisanie ustawień kontrolki w pliku

♦ ShowWhatsThis — wyświetlenie pomocy What’s This?


♦ ZOrder — zmiana kolejności z-order obiektów

3.1.35. Timer
Kontrolka Timer jest niewidoczna podczas działania programu i służy do
wykonywania jakiegokolwiek kodu programu w ściśle określonych odstępach czasu.

Dostępne zdarzenia:
♦ 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).

Dostępne zdarzenia:
♦ Change — zmiana bieżącej wartości
♦ DownClick — wciśnięcie dolnego przycisku kontrolki
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 142


Spis treści 143

♦ MouseMove — przesuwanie wskaźnika myszy


♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop
♦ UpClick — wciśnięcie górnego przycisku kontrolki

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki
♦ Move — zmiana położenia obiektu
♦ OLEDrag (ActiveX) — rozpoczęcie operacji drag/drop
♦ SetFocus — przekazuje fokus obiektowi
♦ ShowWhatsThis — wyświetlenie pomocy What’s This?
♦ ZOrder — zmiana kolejności z-order obiektów

3.1.37. UserControl
Obiekt UserControl jest obiektem bazowym dla tworzenia kontrolek ActiveX.

Dostępne zdarzenia:
♦ AccessKeyPress — wciśnięcie klawiszy dostępu kontrolki
♦ AmbientChanges — zmiana właściwości ambient
♦ AsyncReadComplete — odczyt danych z pliku lub adresu URL
♦ Click — wciśnięcie przycisku myszy
♦ DblClick — podwójne wciśnięcie przycisku myszy
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu EnterFocus otrzymania fokusa
♦ ExitFocus — utracenie fokusa

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 143


Spis treści 144

♦ GotFocus — otrzymanie fokusa


♦ Hide — zmiana właściwości Visible
♦ Initialize — tworzenie nowej instancji obiektu InitProperties,
utworzenie kontrolki
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ MouseDown — wciśnięcie przycisku myszy
♦ MouseMove — przesuwanie wskaźnika myszy
♦ MouseUp — wciśnięcie przycisku myszy
♦ OLECompleteDrag — poinformowanie komponentu docelowego
o zakończeniu operacji OLE drag/drop
♦ OLEDragDrop — opuszczanie komponentu źródłowego na docelowym
w 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
♦ OLEStartDrag — zainicjowanie operacji OLE drag/drop
♦ Paint — odsłonięcie części obiektu ReadProperties, załadowanie starej
instancji obiektu
♦ Resize — zmiana rozmiaru obiektu Show (UserControl), zmiana
właściwości Visible
♦ Terminate — usunięto wszystkie referencje obiektu WriteProperties,
zapisanie instancji obiektu

Dostępne metody:
♦ AsyncRead — czytanie danych z pliku lub adresu URL
♦ CancelAsyncRead — przerwanie odczytywania danych
CanPropertyChange, zapytanie o możliwość zmiany właściwości
połączonej
♦ Circle — narysowanie elipsy, okręgu lub łuku na obiekcie
♦ Cls — wyczyszczenie grafik stworzonych na obiekcie
♦ Line — narysowanie linii lub prostokąta na obiekcie

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 144


Spis treści 145

♦ OLEDrag — rozpoczęcie operacji drag/drop


♦ PaintPicture — narysowanie zawartości pliku na obiekcie
♦ Point — pobranie wartości koloru RGB określonego punktu na obiekcie
♦ PopupMenu — wyświetlenie menu pop-up PropertyChanged,
poinformowanie pojemnika o zmianie właściwości
♦ PSet — narysowanie punktu o określonym kolorze na obiekcie
♦ Refresh — odświeżenie zawartości obiektu
♦ 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
♦ SetFocus — przeniesienie fokusa na kontrolkę Size, zmiana rozmiarów
kontrolki
♦ TextHeight — zwrócenie wysokości tekstu w aktualnie wybranej
czcionce
♦ TextWidth — zwrócenie szerokości tekstu w aktualnie wybranej czcionce

3.1.38. VScrollBar
Kontrolka HScrollBar jest pionowym paskiem przewijania, pozwalającym na
nawigację różnorakimi listami. Po określeniu dopuszczalnych zakresów zmian
kontrolki może być wykorzystana jako wskaźnik wartości.

Dostępne zdarzenia:
♦ Change — zmiana wartości kontrolki
♦ DragDrop — zakończenie przeciągania obiektu
♦ DragOver — przeciąganie obiektu
♦ GotFocus — otrzymanie fokusa
♦ KeyDown — wciśnięcie klawisza
♦ KeyPress — wciśnięcie klawisza ASCII
♦ KeyUp — zwolnienie klawisza
♦ LostFocus — utracenie fokusa
♦ Scroll — zmiana pozycji na pasku przewijania

Dostępne metody:
♦ Drag — rozpoczęcie, zakończenie lub przerwanie przeciągania kontrolki
♦ Move — zmiana położenia obiektu

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 145


Spis treści 146

♦ Refresh — odświeżenie zawartości obiektu


♦ SetFocus — przeniesienie fokusa na kontrolkę
♦ ShowWhatsThis — wyświetlenie pomocy What’s This?
♦ ZOrder — zmiana kolejności z-order obiektów

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

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
fokus, gdy ta forma była aktywna.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 146


Spis treści 147

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — określenie sposobu wyświetlania okna dialogowego.

Wartości i stałe dostępne dla argumentu wartość:

Stała Wartość Opis

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
vbAlignBotto
m
2 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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 147


Spis treści 148

3.2.5. Alignment
Właściwość Align określa (lub zwraca) miejsce wyświetlania obiektu na ekranie.

Składnia:
obiekt.Alignment [=wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — określenie rodzaju wyświetlanego okna dialogowego.

Wartości i stałe dostępne dla argumentu wartość (dla kontrolek CheckBox i


OptionButton):

Stała Wartość Opis

vbLeftJustif
y
0 Domyślna. Tekst wyrównany do lewej. Kontrolka wyrównana do prawej

vbRightJusti
fy
1 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):

Stała Wartość Opis

vbLeftJustif
y
0 Domyślna. Tekst wyrównany do lewej

vbRightJusti
fy
1 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):

Stała Wartość Opis

dbgLeft 0 Tekst wyrównany do lewej


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

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 148


Spis treści 149

3.2.6. Appearance
Właściwość Appearance określa (lub zwraca) sposób wyświetlania kontrolek.

Składnia:
obiekt.Appearance

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

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
FileListBox wyświetla pliki z atrybutem Archive.

Składnia:
obiekt.Archive [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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. AutoRedraw
Właściwość AutoRedraw określa (lub zwraca) wartość, określającą sposób
automatycznego odtwarzania grafiki stworzonej przez metody graficzne.

Składnia:
obiekt.AutoRedraw [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 149


Spis treści 150

♦ boolean — wyrażenie typu Boolean określające sposób wyświetlania


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
formy potomne MDIChild są automatycznie wyświetlane po załadowaniu.

Składnia:
obiekt.AutoShowChildren [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wyrażenie typu Boolean określające sposób wyświetlania


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
automatycznie zmienia swój rozmiar, dostosowując go do pokazania całej swej
zawartości.

Składnia:
obiekt.AutoSize [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wyrażenie typu Boolean określające sposób wyświetlania


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.

Składnia:
obiekt.BackColor [=color]

gdzie:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 150


Spis treści 151

♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ color — wartość lub stała, określająca kolor tła obiektu.

Wartości i stałe dostępne dla argumentu color:

Stała Wartość Opis

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

Stała Wartość Opis


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
vbApplicationWorksp
ace
&H8000000C kolor tła aplikacji wykorzystującej MDIForm

vbHighlight &H8000000D kolor tła wybranych elementów kontrolki


vbHighlightText &H8000000E kolor tekstu wybranych elementów
vbButtonFace &H8000000F kolor przycisków
vbButtonShadow &H80000010 kolor cieniowania przycisków
vbGrayText &H80000011 kolor niedostępnego tekstu
vbButtonText &H80000012 kolor tekstu przycisków

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 151


Spis treści 152

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ obramowanie — wartość lub stała określająca rodzaj obramowania


obiektu.

Wartości i stałe dostępne dla argumentu obramowanie (dla kontrolki Form):

Stała Wartość Opis

vbBSNone 0 Brak obramowania


vbFixedSingle 1 Obramowanie pojedyncze ciągłe. Może zawierać menu kontroli,
pasek tytułowy, przycisk Maksymalizuj i przycisk Minimalizuj.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 152


Spis treści 153

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 5 Obramowanie zawiera przycisk Zamknij i pasek tytułowy
ow 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,


OLEContainer, 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):

Stała Wartość Opis

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 Obramowanie wewnętrzne ciągłe. Zewnętrzna krawędź ramki pełni rolę


id
6
zewnętrznej krawędzi kształtu

3.2.14. BorderWidth
Właściwość BorderWidth określa (lub zwraca) szerokość obramowania obiektu.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 153


Spis treści 154

Składnia:
obiekt.BorderWidth [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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
przyciskiem Anuluj. Może to być kontrolka CommandButton lub inny obiekt
wewnątrz kontrolki OLEContainer, zachowujący się jak przycisk poleceń.

Składnia:
obiekt.Cancel [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ napis — wyświetlany tekst.

3.2.17. Checked
Właściwość Checked określa (lub zwraca) wartość, określającą, czy znak
zaznaczenia będzie wyświetlany obok polecenia w menu.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 154


Spis treści 155

Składnia:
obiekt.Checked [= boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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
graficzne w zdarzeniu Paint obrysowują cały obiekt, czy tylko nowo odsłonięty obszar
(po zmianie 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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 jest tworzony wycięty obszar, False — metody graficzne w zdarzeniu
Paint odtwarzają tylko nowo odsłonięty obszar, a wokół niegraficznych
kontrolek na 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:
♦ obiekt — obiekt wykorzystujący tę właściwość.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 155


Spis treści 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
kolumnach wyświetlane są elementy listy. Jeżeli jest przewijana poziomo, właściwość
Columns określa liczbę wyświetlanych kolumn.

Składnia:
obiekt.Columns [= Wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ pojemnik — wyrażenie reprezentujące obiekt, który może być


pojemnikiem dla innych kontrolek (obiekt).

3.2.22. ControlBox
Właściwość ControlBox określa (lub zwraca) wartość, określającą, czy menu
kontroli 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).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 156


Spis treści 157

3.2.23. Controls
Właściwość Controls zwraca referencję do kolekcji Controls obiektu.
Wykorzystywana np. do zmiany właściwości wszystkich kontrolek danego typu.

Składnia:
obiekt.Controls

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

3.2.24. Count (VB Collections)


Właściwość Count (VB Collections) zwraca liczbę obiektów w kolekcji.
Wykorzystywana np. do zmiany właściwości wszystkich kontrolek danego typu.

Składnia:
obiekt.Count

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 157


Spis treści 158

Składnia:
obiekt.Database
Set obiektdatabase = obiekt.Database

Tylko edycje VB Professional i VB Enterprise.

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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ł
danych ODBC.

3.2.28. DataChanged
Właściwość DataChanked 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ wartość — wyrażenie określające, czy dane się zmieniły (True — dane
w kontrolce są inne niż dane w bieżącym rekordzie, False — domyślne,
są takie same).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 158


Spis treści 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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. DataSource
Wł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
kodzie 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ boolean — wyrażenie określające, czy przycisk poleceń jest przyciskiem
domyś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
grafiki, gdy kontrolka jest wyłączona (właściwość Enabled = False).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 159


Spis treści 160

Składnia:
obiekt.DisabledPicture [=Obraz]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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 przy
operacjach drag/drop (przeciągnij-upuść).

Składnia:
obiekt.DragIcon [=Ikona]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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żywany ręczny, czy automatyczny tryb operacji drag/drop (przeciągnij-upuść).

Składnia:
obiekt.DragMode [=wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 160


Spis treści 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ wygląd — wyrażenie określające wygląd zewnętrzny.

Wartości i stałe dostępne dla argumentu Wygląd:

Stała Wartość Opis

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

Stała Wartość Opis


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
vbWhiteness 16 biały

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 161


Spis treści 162

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — wyrażenie określające rodzaj linii.

Wartości i stałe dostępne dla argumentu wartość:

Stała Wartość Opis

vbSolid 0 ciągła
vbDash 1 kreska
vbDot 2 kropka
vbDashDot 3 kreska-kropka
vbDashDotDot 4 kreska-kropka-kropka
vbInvisible 5 niewidoczna
vbInsideSolid 6 wewnętrzna ciągła

3.2.38. DrawWidth
Właściwość DrawWidth określa (lub zwraca) szerokość linii rysowanych przez
metody graficzne.

Składnia:
obiekt.DrawWidth [=rozmiar]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ rozmiar — wartość określająca szerokość rysowanej linii w pikselach


(1 – 32 767).

3.2.39. Drive
Właściwość Drive określa (lub zwraca) wybrany dysk w czasie wykonywania programu.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 162


Spis treści 163

Składnia:
obiekt.Drive [= Dysk]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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
reagować na zdarzenia generowane przez użytkownika.

Składnia:
obiekt.Enabled [= Boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wyrażenie określające, czy obiekt ma reagować na zdarzenia


generowane przez użytkownika, czy też nie.

3.2.41. FileName
Właściwość FileName określa (lub zwraca) ścieżkę i nazwę wybranego pliku.

Składnia:
obiekt.FileName [= plik]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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.

Składnia:
obiekt.FillColor [= kolor]

gdzie:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 163


Spis treści 164

♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ kolor — wartość określająca, jaki kolor ma być użyty do wypełniania


kształtów (patrz 3.2.11).

3.2.43. FillStyle
Właściwość FillStyle określa (lub zwraca) wzór użyty do wypełnienia kontrolek
Shape oraz figury stworzone przez metody graficzne Circle i Line.

Składnia:
obiekt.FillStyle [= styl]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ styl — wyrażenie określające rodzaj wypełnienia.

Wartości i stałe dostępne dla argumentu styl:

Stała Wartość Opis

vbFSSolid 0 ciągłe
vbFSTransparent 1 przezroczysty
vbHorizontalLine 2 pionowe linie
vbVerticalLine 3 poziome linie
vbUpwardDiagonal 4 ukośne do góry

Stała Wartość Opis

vbDownwardDiagona
l 5 ukośne w dół

vbCross 6 krzyżyk
vbDiagonalCross 7 ukośny krzyżyk

3.2.44. Font
Właściwość Font zwraca obiekt typu Font, którego właściwości można zmieniać.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 164


Spis treści 165

Składnia:
obiekt.Font

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ boolean — wyrażenie określające, czy czcionka ma przyjąć wskazywany
styl (True — ma przyjąć, False — nie przyjmuje).

3.2.46. FontItalic
Patrz 3.2.45.

3.2.47. FontName
Właściwość FontName określa (lub zwraca) rodzaj czcionki używanej do
wyświetlania tekstu w kontrolkach.

Składnia:
obiekt.FontName [= Czcionka]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ czcionka — nazwa czcionki przeznaczonej do użycia.

3.2.48. FontSize
Właściwość FontSize określa (lub zwraca) rozmiar czcionki używanej do
wyświetlania tekstu w kontrolkach.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 165


Spis treści 166

Składnia:
obiekt.FontSize [= rozmiar]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ boolean — wyrażenie określające, czy przycisk poleceń jest przyciskiem
domyślnym (True — domyślnie, wyświetla tekst i grafikę w tle w przestrzeni
wokół 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.

Składnia:
obiekt.ForeColor [= kolor]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 166


Spis treści 167

♦ kolor — wartość określająca, jaki kolor ma być użyty do wypełniania


kształ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:
♦ obiekt — obiekt wykorzystujący tę właściwość.

3.2.54. Hidden
Właściwość Hidden określa (lub zwraca) wartość, określającą, czy kontrolka
FileListBox wyświetla pliki z atrybutem Hidden.

Składnia:
obiekt.Archive [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wyrażenie typu Boolean określające sposób wyświetlania


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.

Składnia:
obiekt.Height [=wysokość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wysokość — wartość określająca wysokość obiektu lub kolumny.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 167


Spis treści 168

3.2.56. HelpContextID
Właściwość HelpContextID określa (lub zwraca) numer kontekstu skojarzony z
obiektem (np. w pliku pomocy). Pozwala na wprowadzenie pomocy kontekstowej w
tworzonej aplikacji.

Składnia:
obiekt. HelpContextID [=Wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — wartość określająca numer kontekstu skojarzonego


z obiektem.

3.2.57. hWnd
Właściwość HWnd zwraca uchwyt (handle) do kontrolki lub do obiektu form.

Składnia:
obiekt.HWnd

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

3.2.58. HideSelection
Właściwość HideSelection określa (lub zwraca) wartość, określającą, czy
zaznaczony tekst będzie podświetlony, gdy kontrolka przestanie być aktywna (straci
fokus).

Składnia:
obiekt.HideSelection [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wyrażenie określające stan podświetlenia tekstu po utracie


fokusa przez kontrolkę (True — domyślnie, będzie podświetlony, False — nie
będzie).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 168


Spis treści 169

3.2.59. Icon
Właściwość Icon zwraca ikonę, wyświetlaną, gdy obiekt form jest minimalizowany.

Składnia:
obiekt.Icon

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

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:
♦ obiekt — obiekt wykorzystujący tę właściwość.

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:
♦ obiekt — obiekt wykorzystujący tę właściwość.

3.2.62. Index (Control Array)


Właściwość Index określa (lub zwraca) liczbę, która identyfikuje kontrolkę w tablicy
kontrolek (jeżeli jest ona częścią tablicy kontrolek).

Składnia:
obiekt[(liczba)].Index

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 169


Spis treści 170

♦ liczba — wartość identyfikująca daną kontrolkę w tablicy kontrolek


(liczba całkowita).

3.2.63. IntegralHeight
Właściwość IntegralHeight określa (lub zwraca) wartość, określającą, czy
kontrolka wyświetla fragmenty elementów.

Składnia:
obiekt.HideSelection [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wartość określająca, czy kontrolka automatycznie zmienia


rozmiar (True — domyślne, kontrolka zmienia rozmiar, aby wyświetlać tylko
elementy w całości, False — kontrolka nie zmienia swego rozmiaru).

3.2.64. Interval
Właściwość Interval określa (lub zwraca) czas w milisekundach pomiędzy
wywołaniami zdarzenia Timer kontrolki Timer.

Składnia:
obiekt.Interval [= czas]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ czas — wartości określające liczbę milisekund pomiędzy wystąpieniami
zdarzenia Timer (1 – 65535).

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ index — numer elementu w danym obiekcie,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 170


Spis treści 171

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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
Value pasków przewijania HScrollBar i VScrollBar podczas kliknięcia przez
użytkownika w obszarze między strzałkami przewijania.

Składnia:
obiekt.LargeChange [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — liczba całkowita określająca wartość zmiany właściwości


Value.

3.2.68. Left
Wł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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 171


Spis treści 172

♦ wartość — liczba określająca odległość.

3.2.69. LinkItem
Właściwość LinkItem określa (lub zwraca) dane przesyłane do kontrolki
docelowej w czasie konwersacji z inną aplikacją (DDE).

Składnia:
obiekt.LinkItem [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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
konwersacjach DDE i aktywuje połączenie.
4. Gdy celem konwersacji DDE są kontrolki — kontrolce docelowej
pozwala na formie zainicjować konwersację określoną przez właściwości
LinkTopic i LinkItem.
5. Gdy źródłem konwersacji DDE są formy — aplikacji docelowej pozwala
zainicjować konwersację z formą źródłową.

Składnia:
obiekt.LinkMode [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:

Stała Wartość Opis

vbLinkNone 0 (Domyślna) brak współdziałania DDE


vbLinkAutomati 1 Automatyczny — kontrolka docelowa zostaje automatycznie
c uaktualniana za każdym razem, gdy zmieniają się połączone dane
vbLinkManual 2 Ręczny — kontrolka docelowa jest uaktualniana tylko po wywołaniu
metody LinkRequest

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 172


Spis treści 173

metody 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:

Stała Wartość Opis

vbLinkNone 0 (Domyślna) brak współdziałania DDE


vbLinkSourc 1 Kontrolki Label, PictureBox, TextBox będące na formie, mogą dostarczać
e 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
oczekiwania kontrolki na odpowiedź wiadomości DDE.

Składnia:
obiekt.LinkTimeout [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — liczba określająca czas oczekiwania (1 sekunda = 10).

3.2.72. LinkTopic
Właściwość LinkTopic określa (lub zwraca):
6. Gdy celem konwersacji DDE są kontrolki — aplikację docelową i temat połączenia
(podstawowy zbiór danych używanych w aplikacji).
7. 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:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 173


Spis treści 174

♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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 (jest
ona tablicą, w której każdy element jest pozycją listy).

Składnia:
obiekt.List (Indeks) [= pozycja]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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.

Składnia:
obiekt.ListCount

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

3.2.75. ListIndex
Właściwość ListIndex określa (lub zwraca) indeks aktualnie zaznaczonej
pozycji w kontrolce.

Składnia:
obiekt.ListIndex [= Indeks]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ index — liczba określająca indeks aktualnej pozycji w liście (–1 — żadna


pozycja nie jest zaznaczona, N — zaznaczona jest pozycja o indeksie N).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 174


Spis treści 175

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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
zostanie zamaskowany (będzie przezroczysty).

Składnia:
obiekt.MaskColor [= kolor]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ kolor — wartość lub stała określająca kolor tła do zamaskowania (patrz


3.2.11).

3.2.78. Max
Właściwość Max określa (lub zwraca) dopuszczalną maksymalną wartość właściwości
Value.

Składnia:
obiekt.Max [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — liczba określająca maksymalną wartość (0 – 32000).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 175


Spis treści 176

3.2.79. MaxButton
Właściwość MaxButton określa (lub zwraca) wartość, określającą, czy forma posiada
przycisk Maksymalizacji.

Składnia:
obiekt.MaxButton [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wartość określająca, czy Maksymalizuj istnieje


(True — domyślnie, forma ma przycisk Maksymalizuj, False — nie ma).

3.2.80. MaxLength
Właściwość MaxLenght określa (lub zwraca) wartość, określającą maksymalną
liczbę znaków, wprowadzanych do kontrolki TextBox. Jeżeli jej nie określimy,
oznaczać to będzie, że nie ma limitu wpisywanych znaków.

Składnia:
obiekt.MaxLength [=wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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
formą potomną (MDIChild).

Składnia:
obiekt.MDIChild [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wartość określająca, czy forma jest formą potomną


(True — forma jest formą potomną, False — domyślne, nie jest).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 176


Spis treści 177

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — liczba określająca minimalną wartość (0 – 32000).

3.2.83. MinButton
Właściwość MaxButton określa (lub zwraca) wartość, określającą, czy forma posiada
przycisk Minimalizacji.

Składnia:
obiekt.MinButton [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wartość określająca, czy Maksymalizuj istnieje


(True — domyślnie, forma ma przycisk Minimalizacji, False — nie ma).

3.2.84. MouseIcon
Właściwość MouseIson określa (lub zwraca) ikonę wskaźnika myszki.

Składnia:
obiekt.MouseIcon = LoadPicture(lokalizacja)
obiekt.MouseIcon [=Obrazek]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ lokalizacja — wartość określająca ścieżkę dostępu i nazwę pliku ikony,

♦ wartość — właściwość Picture obiektu Form, kontrolka PictreBox lub


Image.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 177


Spis treści 178

3.2.85. MousePointer
Właściwość MousePointer określa (lub zwraca) wartość, określającą typ
wyświetlanego wskaźnika myszy.

Składnia:
obiekt.MousePointer [=Wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — wyrażenie określające typ wyświetlanego wskaźnika myszy.

Wartości i stałe dostępne dla argumentu wartość:

Stała Wartość Opis

vbDefault 0 (Domyślna) kształt określony przez obiekt


vbArrow 1 Strzałka
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
ss 13 Strzałka i klepsydra

vbArrowQuestio
n 14 Strzałka i znak zapytania

vbSizeAll 15 Zmiana wszystkich rozmiarów


vbCustom 99 Ikona użytkownika określona przez właściwość MouseIcon

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 178


Spis treści 179

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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 kontrolka
TextBox może zawierać i wyświetlić wiele wierszy tekstu.

Składnia:
obiekt.MultiLine [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ boolean — wartość określająca, czy w kontrolce może wystąpić wiele
wierszy 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
FlieListBox i ListBox oraz jak ten wielokrotny wybór będzie przeprowadzany.

Składnia:
obiekt.MultiSelect [=wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ wartość — wartość określająca, czy można dokonywać wyboru wielu
elementów za jednym razem.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 179


Spis treści 180

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
nazwę czcionki obiektu.

Składnia:
obiekt.Name [=nazwa]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ nazwa — nazwa obiektu lub czcionki.

3.2.90. Negotiate
Właściwość Negotiate ustala wartość (True, False), określającą, czy kontrolka
wyrównana właściwością Align może być wyświetlana na formie zawierającej paski
narzę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.
Dostę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
osadzony lub połączony na formie i wyświetla swoje menu. Dostępna tylko w fazie
projektowania.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 180


Spis treści 181

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. NegotiateToolbars
Właściwość NegotiateToolbars ustala wartość (True, False), określającą, czy
paski narzędziowe aktywnego obiektu aktywnej formy potomnej MDIChild są
wyświetlane na formie — rodzicu (MDIForm). Dostępna tylko w fazie projektowania

3.2.94. NewIndex
Właściwość NewIndex zwraca indeks ostatnio dodanego elementu kontrolek
ComboBox i ListBox.

Składnia:
obiekt.NewIndex

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

3.2.95. Normal
Właściwość Normal określa (lub zwraca) wartość, określającą, czy kontrolka
FileListBox wyświetla pliki z atrybutem Normal.

Składnia:
obiekt.Normal [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wyrażenie określające sposób wyświetlania plików


(True — domyślny, pozwala na wyświetlanie, False — nie pozwala).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 181


Spis treści 182

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — wyrażenie określające sposób obsługiwania operacji OLE


drag/drop.

Wartości i stałe dostępne dla argumentu wartość:

Stała Wartość Opis

vbOLEDragManual 0 (Domyślna) wszystkie operacje OLE drag/drop obsługuje programista


vbOLEDragAutomat 1 Wszystkie operacje OLE drag/drop obsługiwane są automatycznie
ic

3.2.97. OLEDropMode
Właściwość OleDropMode określa (lub zwraca) wartość, określającą sposób
przechwytywania operacji drop przez komponent docelowy.

Składnia:
obiekt.OLEDropMode [=wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — wyrażenie określające metodę przechwytywania operacji


drag/drop przez komponent.

Wartości i stałe dostępne dla argumentu wartość:

Stała Wartość Opis

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ąc
programiście na obsługę operacji OLE drop w kodzie programu

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 182


Spis treści 183

Stała Wartość Opis

vbOLEDropAutoma 2 Komponent docelowy akceptuje OLE drop, jeżeli obiekt DataObject


tic zawiera dane w formacie przez niego rozpoznawanym. Jeżeli
OLEDropMode jest ustawione na vbOLEDropAutomatic, 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ plik — nazwa i ścieżka dostępu do pliku zawierającego paletę.

3.2.99. PaletteMode
Właściwość PaletteMode określa (lub zwraca) wartość, określającą, jaka paleta
zostanie wykorzystana przez kontrolki obiektu.

Składnia:
obiekt.PaletteMode [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — wyrażenie określające używaną paletę.

Wartości i stałe dostępne dla argumentu wartość:

Stała Wartość Opis

vbPaletteModeHalfTo 0 (Domyślna) systemowej palety półtonów


ne
vbPaletteModeUseZOr 1 Paleta z najwyżej w porządku znajdującej się kontrolki
der posiadającej paletę
vbPaletteModeCustom 2 Paleta określona we właściwości Palette
vbPaletteModeContai 3 Paleta containerów dla containerów obsługujących właściwość
ner Palette

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 183


Spis treści 184

Stała Wartość Opis

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:
♦ obiekt — obiekt wykorzystujący tę właściwość.

3.2.101. PasswordChar
Właściwość PasswordChar określa (lub zwraca) wartość, określającą znaki
wyświetlane w kontrolce TextBox podczas wpisywania tekstu przez użytkownika.

Składnia:
obiekt.PasswordChar [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ ścieżka — wyrażenie określające ścieżkę dyskową.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 184


Spis treści 185

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — wyrażenie określające wyświetlane pliki (np. *.*, *.arj lub


*.doc). Domyślnym ustawieniem jest *.*, czyli wszystkie pliki.

3.2.104. Picture
Właściwość Picture określa (lub zwraca) grafikę do wyświetlenia w kontrolce.

Składnia:
obiekt.Picture [= plik]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ plik — wyrażenie określające nazwę pliku (wraz ze ścieżką dostępu)


z grafiką do wyświetlenia.

Wartości dostępne dla argumentu plik:

Wartość Opis

None (Domyślna) brak grafiki


Bitmap Rodzaj grafiki w pliku
Icon
metafile
GIF
JPEG

3.2.105. ReadOnly
Właściwość ReadOnly określa (lub zwraca) wartość, określającą, czy kontrolka
FileListBox wyświetla pliki z atrybutem ReadOnly.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 185


Spis treści 186

Składnia:
obiekt.ReadOnly [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ boolean — wyrażenie określające sposób wyświetlania plików
(True — domyślny, pozwala na wyświetlanie, False — nie pozwala).

3.2.106. ScaleHeight
Właściwość ScaleHeight określa (lub zwraca) liczbę pionowego, wewnętrznego
wymiaru obiektu.

Składnia:
obiekt.ScaleHeight [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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ść]

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 186


Spis treści 187

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — liczba (całkowita) określająca jednostkę miary.

Wartości i stałe dostępne dla argumentu wartość:

Stała Wartość Opis

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)
vbPoints 2 Jednostka miary to punkt (72 punkty = 1 cal)
vbPixels 3 Jednostka miary to piksel
vbCharacter 4 Jednostka miary to znak (poziomo = 120 twipów na jednostkę, pionowo =
s 240 twipów na jednostkę)
vbInches 5 Jednostka miary to cal
vbMilimeter 6 Jednostka miary to milimetr
s
vbCentimete 7 Jednostka miary to centymetr
rs

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 187


Spis treści 188

Składnia:
obiekt.ScaleWidth [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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.

Składnia:
obiekt.ScrollBars [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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 1 Kontrolka posiada poziomy pasek przewijania
l
vbVertical 2 Kontrolka posiada pionowy pasek przewijania
vbBoth 3 Kontrolka posiada obydwa paski przewijania

3.2.112. SellCount
Właściwość SellCount zwraca liczbę zaznaczonych pozycji w kontrolce ListBox.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 188


Spis treści 189

Składnia:
obiekt.SellCount

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

3.2.113. Selected
Właściwość Selected określa (lub zwraca) status zaznaczenia pozycji w kontrolce
ListBox i FileListBox.

Właściwość niedostępna na etapie projektowania.

Składnia:
obiekt.Selected (Indeks) [= Boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ ile — liczba (całkowita) określająca liczbę zaznaczonych znaków
(od 0 do maksymalnej długości tekstu).

3.2.115. SelStart
Właściwość SelStart określa (lub zwraca) liczbę zaznaczonych znaków.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 189


Spis treści 190

Składnia:
obiekt.SelStart[= index]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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

Składnia:
obiekt.SelText[= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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
Shape.

Składnia:
obiekt.Shape[= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — wyrażenie określające wygląd kontrolki.

Wartości i stałe dostępne dla argumentu wartość:

Stała Wartość Opis

vbShapeRectangle 0 kształt prostokąta


vbShapeRectangle 1 kształt kwadratu
vbShapeOval 2 kształt owalu
vbShapeCircle 3 kształt koła
vbShapeRoundedRectan 4 kształt prostokąta o zaokrąglonych rogach
gle

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 190


Spis treści 191

gle
vbShapeRoundedSquare 5 kształt kwadratu o zaokrąglonych rogach

3.2.118. Shortcut
Właściwość Shape określa klawisz dostępu dla obiektu Menu. Dostępna tylko w fazie
projektowania.

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:
♦ obiekt — obiekt wykorzystujący tę właściwość.

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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — liczba całkowita określająca wartość zmiany właściwości


Value.

3.2.121. Sorted
Właściwość Sorted określa (lub zwraca) wartość (True, False), określającą, czy
elementy kontrolki będą automatycznie sortowane wg alfabetu.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 191


Spis treści 192

Składnia:
obiekt.ShowInTaskbar

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

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.

Składnia:
obiekt.Stretch [= Boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ boolean — wyrażenie określające, czy grafika dopasowuje swój rozmiar


(True — grafika dopasowuje się do rozmiaru kontrolki, False — domyślne,
kontrolka dopasowuje się do rozmiaru grafiki).

3.2.123. StartUpPosition
Właściwość StartUpPosition określa (lub zwraca) wartość, określającą pozycję
obiektu Form lub MDIForm, pojawiającego się na ekranie po raz pierwszy.

Składnia:
obiekt.StartUpPosition [= pozycja]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ pozycja — wyrażenie określające pozycję obiektu.

Wartości i stałe dostępne dla argumentu pozycja:

Stała Wartość Opis

vbStartUpManual 0 brak początkowych ustawień


vbStartUpOwner 1 środek obiektu, do którego należy forma
vbStartUpScreen 2 środek całego ekranu
vbStartUpWindowsDefa 3 lewy górny róg ekranu
ult

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 192


Spis treści 193

3.2.124. Style
Właściwość Style określa (lub zwraca) wartość, określającą typ wyświetlania i
zachowania się kontrolki.

Składnia:
obiekt.Style

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość.

Wartości i stałe dostępne dla właściwości Style (dla kontrolki CheckBox,


CommandButton lub OptionButton):

Stała Wartość Opis

vbButtonStanda 0 (Domyślna) kontrolka CheckBox jest wyświetlana jako pole


rd wyboru z etykietą, OptionButton jako przycisk opcji z etykietą,
a CommandButton jako przycisk bez dodatkowej grafiki
vbButtonGraphi 1 Kontrolki są wyświetlane w stylu graficznym (jako przyciski)
cal

Wartości i stałe dostępne dla właściwości Style (dla kontrolki ComboBox):

Stała Wartość Opis

vbComboDropDown 0 (Domyślna) lista opuszczana w dół


vbComboSimple 1 Lista nie opuszczana w dół
vbComboDrop- 2 Lista opuszczana w dół, a wyboru można dokonać tylko z niej
DownList

Wartości i stałe dostępne dla właściwości Style (dla kontrolki ListBox):

Stała Wartość Opis

vbListBoxStandar 0 (Domyślna) wyświetlana jako lista pozycji tekstowych


d
vbListBoxCheckBo 1 Wyświetlana z polami wyboru przy każdej pozycji listy
x

3.2.125. System
Właściwość System określa (lub zwraca) wartość, określającą, czy kontrolka
FileListBox wyświetla pliki z atrybutem ReadOnly.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 193


Spis treści 194

Składnia:
obiekt.System [=boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ boolean — wyrażenie określające sposób wyświetlania plików
(True — domyślny, pozwala na wyświetlanie, False — nie pozwala).

3.2.126. TabIndex
Właściwość TabIndex określa (lub zwraca) kolejność przechodzenia między
obiektami klawiszem Tab.

Składnia:
obiekt.TabIndex[= index]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ boolean — wyrażenie określające, czy obiekt może otrzymać fokus
poprzez uż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
potrzebne dla programu.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 194


Spis treści 195

Składnia:
obiekt.Tag [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ wartość — wyrażenie identyfikujące obiekt.

3.2.129. Text
Właściwość Tekst określa (lub zwraca) tekst wyświetlany w kontrolce.

Składnia:
obiekt.Text [= tekst]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 195


Spis treści 196

♦ 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.

Składnia:
obiekt.TopIndex [= index]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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
skojarzony z właściwością MaskColor jest używany jako maska (tworząc przezroczyste
obszary).

Składnia:
obiekt.UseMaskColor [= boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 196


Spis treści 197

♦ 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).

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
zwraca) aktualnie wskazywaną wartość przez pasek przewijania.

Składnia:
obiekt.Value [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ wartość — wartość określająca pozycję lub stan kontrolki.

3.2.136. Visible
Właściwość Visible określa (lub zwraca) wartość, określającą, czy obiekt jest
widoczny, czy ukryty dla użytkownika.

Składnia:
obiekt.Visible [= boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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ślającą, czy przycisk What’s This? pojawia się na pasku tytułowym formy.

Składnia:
obiekt.WhatsThisButton

gdzie:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 197


Spis treści 198

♦ obiekt — obiekt wykorzystujący tę właściwość,

3.2.138. WhatsThisHelp
Właściwość WhatsThisHelp określa (lub zwraca) wartość, określającą, czy pomoc
kontekstowa używa menu pop-up What’s This? systemu operacyjnego, czy głównej
pomocy.

Składnia:
obiekt.WhatsThisHelp [= boolean]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ boolean — wyrażenie określające, czy używane jest menu pop-up What’s
This? (True — techniki What’s This? są wykorzystywane do uruchamiania
pomocy, False — domyślne, do wywołania pomocy wykorzystywany jest
klawisz F1).

3.2.138. WhatsThisHelpID
Właściwość WhatsThisHelpID określa (lub zwraca) wartość, określającą numer
kontekstu w pliku pomocy, wywoływany dla obiektu.

Składnia:
obiekt.WhatsThisHelpID [= indeks]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ szerokość — wartość określająca szerokość obiektu lub kolumny.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 198


Spis treści 199

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:
♦ obiekt — obiekt wykorzystujący tę właściwość.

3.2.142. WindowState
Właściwość WindowState określa (lub zwraca) wartość, określającą sposób
wyświetlania okna formy.

Składnia:
obiekt.WindowState [= wartość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę właściwość,
♦ wartość — wartość określająca sposób wyświetlania okna obiektu.

Wartości i stałe dostępne dla argumentu wartość:

Stała Wartość Opis

vbNormal 0 (Domyślna) wyświetlane standardowo


vbMinimize 1 Wyświetlane jako zminimalizowane do ikony
d
vbMaximize 2 Wyświetlane jako zmaksymalizowane do rozmiaru ekranu
d

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:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 199


Spis treści 200

♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę właściwość,

♦ 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:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 200


Spis treści 201

♦ 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
zwolnienie przycisku).

Składnia:
Private Sub Form_Click()
Private Sub obiekt_Click ([Indeks As Integer])

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,
♦ 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
(podwó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ów
sterujących.

3.3.5. DeActivate
Zdarzenie DeActivate jest generowane, gdy obiekt przestaje być obiektem
aktywnym.

Składnia:
Private Sub obiekt_DeActivate ()

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 201


Spis treści 202

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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


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 As
Single, 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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterują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”).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 202


Spis treści 203

3.3.8. DropDown
Zdarzenie DropDown jest generowane, gdy w ComboBox rozwijamy listę. Nie
zachodzi, gdy właściwość Style jest ustawiona na 1.

Składnia:
Private Sub obiekt_DropDown ([Indeks As Integer])

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących.

3.3.9. Error
Zdarzenie Error jest generowane, gdy wystąpi błąd dostępu do danych podczas
wykonywania programu.

Składnia:
Private Sub obiekt_Error ([Indeks As Integer,] Błąd As Integer,
Odpowiedź As Integer)

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,
♦ indeks — wartość określająca element sterujący w tablicy elementów
sterujących,
♦ 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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 203


Spis treści 204

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących.

3.3.11. Initialize
Zdarzenie Initialize jest generowane, gdy aplikacja tworzy instancję Form,
MDIForm, PropertyPage, UserControl lub klasy.

Składnia:
Private Sub obiekt_Initialize()

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,
♦ 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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 204


Spis treści 205

♦ indeks — wartość określająca element sterujący w tablicy elementów


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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących,
♦ znakAscii — kod ASCII reprezentujący wciśnięty klawisz.

3.3.15. KeyUp
Zdarzenie 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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


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).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 205


Spis treści 206

Wartości te mogą być dodawane, co oznaczać będzie wciśnięcie jakiejś kombinacji tych
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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących,
♦ 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
7 Wszystkie połączenia ze źródłem są zajęte (maksymalnie 128 połączeń z jednym
źródłem)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 206


Spis treści 207

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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ 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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących.

3.3.20. LinkOpen
Zdarzenie LinkOpen jest generowane, gdy konwersacja DDE jest inicjowana.

Składnia:
Private Sub Form_LinkOpen (Cancel As Integer)
Private Sub MDIForm_LinkOpen (Cancel As Integer)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 207


Spis treści 208

Private Sub obiekt_LinkOpen ([Indeks As Integer,] Cancel As Integer)

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,
♦ indeks — wartość określająca element sterujący w tablicy elementów
sterujących,
♦ 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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących.

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
As Single, Y As Single)
Private Sub obiekt_MouseDown ([Indeks As Integer,] Klawisz As
Integer, Stan As Integer, X As Single, Y As Single)

gdzie:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 208


Spis treści 209

♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących,
♦ 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).

Wartości te mogą być dodawane, co oznaczać będzie wciśnięcie jakiejś kombinacji tych
przycisków.

Wartości i stałe dostępne dla argumentu klawisz:

Stała Wartość Opis

vbLeftButton 1 Przyciśnięty lewy klawisz myszy


vbRightButto 2 Przyciśnięty prawy klawisz myszy
n
vbMiddleButt 4 Przyciśnięty środkowy klawisz myszy
on

Wartości i stałe dostępne dla argumentu stan:

Stała Wartość Opis

vbShiftMa 1 Wybrany klawisz SHIFT


sk
vbCtrlMas 2 Wybrany klawisz CTRL
k
vbAltMask 4 Wybrany klawisz ALT

3.3.24. MouseMove
Zdarzenie MouseMove jest generowane podczas przesuwania wskaźnika myszy.

Składnia:
Private Sub Form_MouseMove (Klawisz As Integer, Stan As Integer, X As
Single, Y As Single)
Private Sub MDIForm_MouseMove (Klawisz As Integer, Stan As Integer, X
As Single, Y As Single)
Private Sub obiekt_MouseMove ([Indeks As Integer,] Klawisz As
Integer, Stan As Integer, X As Single, Y As Single)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 209


Spis treści 210

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących,
♦ 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).

Wartości te mogą być dodawane, co oznaczać będzie wciśnięcie jakiejś kombinacji tych
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
Single, Y As Single)
Private Sub MDIForm_MouseUp (Klawisz As Integer, Stan As Integer, X
As Single, Y As Single)
Private Sub obiekt_MouseUp ([Indeks As Integer,] Klawisz As Integer,
Stan As Integer, X As Single, Y As Single)

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących,
♦ 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).

Wartości te mogą być dodawane, co oznaczać będzie wciśnięcie jakiejś kombinacji tych
przycisków.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 210


Spis treści 211

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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących.

3.3.27. PathChange
Zdarzenie PathChange jest generowane, gdy nastąpiła zmiana właściwości
FileName lub Path (w wyniku zmiany ścieżki dostępu do pliku).

Składnia:
Private Sub obiekt_PathChange ([Indeks As Integer])

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,
♦ indeks — wartość określająca element sterujący w tablicy elementów
sterujących.

3.3.28. PatternChange
Zdarzenie PatternChange jest generowane, gdy nastąpiła zmiana właściwości
FileName lub Pattern (w wyniku zmiany maski nazwy pliku).

Składnia:
Private Sub obiekt_PatternChange ([Indeks As Integer])

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 211


Spis treści 212

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących.

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:

Stała Wartość Opis

vbFormControlMen 0 Użytkownik wybrał komendę Close z menu Control formy


u
vbFormCode 1 Została wywołana instrukcja Unload w kodzie programu

Stała Wartość Opis

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.

Składnia:
Private Sub obiekt_Reposition ([Indeks As Integer])

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 212


Spis treści 213

♦ indeks — wartość określająca element sterujący w tablicy elementów


sterujących.

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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,

♦ 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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,
♦ cancel — wartość określająca nową wysokość obiektu.

3.3.33. Terminate
Zdarzenie Terminate jest generowane, gdy wszystkie odwołania do instancji obiektu
lub klasy zostaną usunięte z pamięci poprzez ustawienie wszystkich zmiennych
odwołujących się do obiektu na wartość Nothing lub gdy ostatnia referencja do
obiektu wychodzi poza zasięg zmiennych.

Składnia:
Private Sub obiekt_Terminate()

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 213


Spis treści 214

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:
♦ obiekt — obiekt wykorzystujący to zdarzenie,
♦ indeks — wartość określająca element sterujący w tablicy elementów
sterujących.

3.3.35. Unload
Zdarzenie Unload jest generowane tuż przed zamknięciem formy.

Składnia:
Private Sub obiekt_Unload (Cancel As Integer)

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,
♦ 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.

Składnia:
Private Sub obiekt_Validate ([Indeks As Integer,] Akcja As Integer,
Zapis As Integer)

gdzie:
♦ obiekt — obiekt wykorzystujący to zdarzenie,
♦ indeks — wartość określająca element sterujący w tablicy elementów
sterujących,
♦ akcja — wartość określająca operację wywołującą dane zdarzenie,
♦ zapis — wartość określająca, czy elementy zostały zmienione (True, False),

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 214


Spis treści 215

Wartości i stałe dostępne dla argumentu akcja:

Stała Wartość Opis

vbDataActionCancel 0 operacja anulowana, gdy istnieje Sub


vbDataActionMoveFirs 1 metoda MoveFirst
t
vbDataActionMovePrev 2 metoda MovePrevious
ious
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.

Składnia:
obiekt.AddItem ElementDodawany [, Pozycja]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ elementDodawany (wymagany) — wyrażenie określające element, który


ma zostać dodany do obiektu,
♦ pozycja (opcja) — liczba (całkowita) będąca numerem pozycji, na której
będzie dodany element (numeracja od 0).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 215


Spis treści 216

3.4.2. Arrange
Metoda AddItem układa okna lub ikony wewnątrz formy MDIForm w określonym
porządku.

Składnia:
obiekt.Arrange Styl

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ 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:

Stała Wartość Opis

vbCascade 0 nie zminimalizowane formy MDIChild — kaskadowo


vbTileHorizont 1 nie zminimalizowane formy MDIChild — wyrównanie pionowe
al
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
zostaje wywołana.

Składnia:
obiekt.Assert Wyrażenie

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ wyrażenie (wymagany) — wyrażenie określające, czy program ma zostać


przerwany (True — kontynuować, False — przerwać).

3.4.4. Circle
Metoda Circle rysuje okrąg, elipsę lub łuk.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 216


Spis treści 217

Składnia:
obiekt.Circle [Step] (X, Y), Promień [, Kolor, Początek, Koniec,
Spłaszczenie]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ Step (wymagany) — słowo kluczowe określające przesunięcie


współrzędnych środka względem współrzędnych określonych
właściwościami CurrentX i CurrentY obiektu,
♦ x, y (wymagany) — wyrażenie określające współrzędne środka okręgu,
elipsy lub łuku w jednostkach określonych właściwością ScaleMode
obiektu,
♦ promień (wymagany) — wyrażenie określające promień okręgu, elipsy
lub łuku w jednostkach określonych właściwością ScaleMode obiektu,
♦ kolor (opcja) — wyrażenie określające kolor linii rysowanej figury,

♦ początek (opcja) — wyrażenie stosowane podczas rysowania łuków


i określające wartość (w radianach) kąta początku (domyślnie 0 radianów),
♦ koniec (opcja) — wyrażenie stosowane podczas rysowania łuków
i określające wartość (w radianach) kąta końca (domyślnie π radianów),
♦ spłaszczenie (opcja) — wyrażenie określające współczynnik
proporcjonalności okręgu (domyślnie: 1.0, co oznacza, że dla każdego
rodzaju karty i monitora okrąg będzie „okrągły”).

3.4.5. Clear
Metoda Clear czyści zawartość kontrolki ComboBox, ListBox lub schowka
systemowego.

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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 217


Spis treści 218

Składnia:
obiekt.Cls

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

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:

Stała Wartość Opis

vbCancel 0 przerwanie przeciągania


vbBeginDra 1 rozpoczęcie przeciągania
g
vbEndDrag 2 zakończenie przeciągania

3.4.8. EndDoc
Metoda EndDoc przerywa wysyłanie dokumentu do obiektu Printer, zwalniając
jednocześnie drukarkę.

Składnia:
obiekt.EndDoc

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.9. GetData
Metoda GetData pobiera grafikę ze schowka systemowego.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 218


Spis treści 219

Składnia:
obiekt.GetData ([Format])

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ format (opcja) — wartość określająca rozpoznawane formaty. Ustawienie
na 0 lub jego brak powoduje automatycznie użycie odpowiedniego formatu.

Wartości i stałe dostępne dla argumentu format:

Stała Wartość Opis

vbCFBitmap 2 format *.bmp


vbCFMetafil 3 format *.wmf
e
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:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ format (wymagany) — wartość określająca rozpoznawany format.

Wartości i stałe dostępne dla argumentu format:

Stała Wartość Opis

vbCFLink &HBF00 format dynamicznej wymiany danych (DDE)


vbCFText 1 format tekstowy
vbCFBitmap 2 format *.bmp
vbCFMetafi 3 format *.wmf
le

Stała Wartość Opis

vbCFDIB 8 format Device-independent bitmap (DIB)

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 219


Spis treści 220

vbCFPalett 9 paleta kolorów


e

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.

Wartości i stałe dostępne dla argumentu format:

Stała Wartość Opis

vbCFLink &HBF00 format dynamicznej wymiany danych (DDE)


vbCFText 1 format tekstowy
vbCFRTF &HBF01 format *.rtf

3.4.12. Hide
Metoda Hide ukrywa obiekt Fofm lub MDIForm, ale nie usuwa go (sprawia, że jest
niewidoczny).

Składnia:
obiekt.Hide

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.13. Line
Metoda Line rysuje linię lub prostokąt.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 220


Spis treści 221

Składnia:
obiekt.Line [Step] [(X1, Y1)] — [Step] (X2, Y2), [Kolor], [B[F]]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ 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
w jednostkach określonych właściwością ScaleMode obiektu,
♦ 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.

3.4.14. LinkExecute
Metoda LinkExecute przesyła polecenia do aplikacji źródłowej podczas operacji DDE.

Składnia:
obiekt.LinkExecute Polecenia

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ 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.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 221


Spis treści 222

Składnia:
obiekt.LinkPoke

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.16. LinkRequest
Metoda LinkRequest żąda od aplikacji źródłowej przesłania nowej zawartości
kontrolki podczas konwersacji DDE.

Składnia:
obiekt.LinkRequest

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.17. LinkSend
Metoda LinkSend przenosi zawartość kontrolki PictureBox do aplikacji
docelowej podczas operacji dynamicznej wymiany danych (DDE).

Składnia:
obiekt.LinkSend

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.18. Move
Metoda Move powoduje zmianę położenia obiektu.

Składnia:
obiekt.Move Lewa [, Górna, Szerokość, Wysokość]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ lewa (wymagany) — wartość określająca poziomą (X) współrzędną lewej
krawędzi obiektu,
♦ górna (opcja) — wartość określająca pionową (X) współrzędną górnej
krawędzi obiektu,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 222


Spis treści 223

♦ szerokość (opcja) — wartość określająca szerokość obiektu po


przesunięciu,
♦ wysokość (opcja) — wartość określająca wysokość obiektu po przesunięciu.

3.4.19. NewPage
Metoda NewPage kończy drukowanie strony i rozpoczyna drukować następną
(przesyłając do obiektu Printer).

Składnia:
obiekt.NewPage

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.20. OLEDrag
Metoda OLEDrag wymusza na komponencie rozpoczęcie operacji drag/drop.

Składnia:
obiekt.OLEDrag

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

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:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ 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,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 223


Spis treści 224

♦ szerokość1 (opcja) — wartość określająca docelową szerokość grafiki


w jednostkach określonych właściwością ScaleMode obiektu,
♦ wysokość1 (opcja) — wartość określająca docelową wysokość grafiki
w jednostkach określonych właściwością ScaleMode obiektu,
♦ x2, y2 (opcja) — wartości określające współrzędne obszaru grafiki
przeznaczonego do wycięcia i wyświetlenia w jednostkach określonych
właściwością ScaleMode obiektu,
♦ szerokość2 (opcja) — wartość określająca źródłową szerokość grafiki
w jednostkach określonych właściwością ScaleMode obiektu,
♦ wysokość2 (opcja) — wartość określająca źródłową wysokość grafiki
w jednostkach określonych właściwością ScaleMode obiektu,
♦ 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. Point
Metoda Point wyświetla zawartość pliku graficznego na obiekcie.

Składnia:
obiekt.Point (X, Y)

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ 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ą ScaleMode
obiektu.

3.4.23. PopupMenu
Metoda PopupMenu wyświetla zawartość pliku graficznego na obiekcie.

Składnia:
obiekt.PopupMenu Nazwa, Styl, X, Y, CelPogrubienia

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ 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,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 224


Spis treści 225

♦ 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świetlone
w 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:

Stała Wartość Opis

vbPopupMenuLeftAlig 0 (Domyślna) lewa krawędź menu leży na współrzędnej X


n
vbPopupMenuLeftButt 0 (Domyślna) polecenia menu uruchamiane są kliknięciem
on lewego klawisza myszy
vbPopupMenuRightBut 2 Polecenia menu uruchamiane są kliknięciem lewego lub
ton prawego klawisza myszy
vbPopupMenuCenterAl 4 Menu centrowane jest na współrzędnej X
ign
vbPopupMenuRightAli 8 Prawa krawędź menu leży na współrzędnej X
gn

3.4.24. Print
Metoda Print wyświetla tekst w oknie Debug.

Składnia:
obiekt.Print [Wyrażenie lub wyrażenia]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ nazwa (wymagany) — wyrażenie lub wyrażenia mające zostać wypisane
na 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 oznacza
wstawienie znaku początku następnej strefy drukowania (14 kolumn),
♦ wyrażenie — wyrażenie do wypisania na obiekcie,

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 225


Spis treści 226

♦ 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. PrintForm
Metoda PrintForm powoduje wydrukowanie całej formy.

Składnia:
obiekt.PrintForm

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.26. PSet
Metoda PSet rysuje punkt o danym kolorze.

Składnia:
obiekt.PSet [Step] (X, Y) [Kolor]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ 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:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.28. RemoveItem
Metoda RemoveItem usuwa element z listy kontrolek.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 226


Spis treści 227

Składnia:
obiekt.RemoveItem Pozycja

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ 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:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ x1, y1 (opcja) — wartości określające współrzędne górnego, lewego rogu
obiektu,
♦ x2, y2 (opcja) — wartości określające współrzędne dolnego, prawego rogu
obiektu.

3.4.30. ScaleX
Metoda ScaleX konwertuje wartość szerokości obiektu z jednego na drugi rodzaj jednostek.

Składnia:
obiekt.ScaleX (Szerokość, SkalaPrzed, SkalaPo)

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ szerokość (opcja) — wartość określająca liczbę jednostek do


przekonwertowania,
♦ skalaPrzed (opcja) — wyrażenie określające system jednostek, z którego
nastąpi konwersja,
♦ skalaPo (opcja) — wyrażenie określające system jednostek, na który nastąpi
konwersja.

Wartości i stałe dostępne dla argumentów SkalaPrzed i SkalaPo:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 227


Spis treści 228

Stała Wartość Opis

vbUser 0 Użytkownika
vbTwips 1 Jednostka miary to twip (1440 twipów = 1 cal, 567 twipów =
1 centymetr)
vbPoints 2 Jednostka miary to punkt (72 punkty na logiczny cal)
vbPixels 3 Jednostka miary to piksel
vbCharacters 4 Jednostka miary to znak (poziomo = 120 twipów na jednostkę,
pionowo = 240 twipów na jednostkę)

Stała Wartość Opis

vbInches 5 Jednostka miary to cal


vbMillimeters 6 Jednostka miary to milimetr
vbCentimeters 7 Jednostka miary to centymetr
vbHiMetric 8 System miary to HiMetric
vbContainerPosit 9 Jednostkami miary są jednostki używane przez container kontrolek
ion 10 dla określenia ich pozycji
vbContainerSize

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:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ wysokość (opcja) — wartość określająca liczbę jednostek do
przekonwertowania,
♦ skalaPrzed (opcja) — wyrażenie określające system jednostek, z
którego nastąpi konwersja,
♦ skalaPo (opcja) — wyrażenie określające system jednostek, na który
nastąpi konwersja.

Wartości i stałe dostępne dla argumentów SkalaPrzed i SkalaPo: patrz 3.4.30.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 228


Spis treści 229

3.4.32. SetData
Metoda SetData kopiuje grafikę do schowka systemowego w określonym formacie.

Składnia:
obiekt.SetData Dana[, Format]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ dana (wymagany) — wartość określająca grafikę, która ma zostać
umieszczona w Clipboard,
♦ format (opcja) — wartość określająca rozpoznawane formaty. Ustawienie
na 0 lub jego brak powoduje automatycznie użycie odpowiedniego formatu.

Wartości i stałe dostępne dla argumentu format:

Stała Wartość Opis

vbCFBitmap 2 format *.bmp


vbCFMetafil 3 format *.wmf
e
vbCFDIB 8 format Device-independent bitmap (DIB)
vbCFPalette 9 paleta kolorów

3.4.33. SetFocus
Metoda SetFocus powoduje, że obiekt staje się aktywny.

Składnia:
obiekt.SetFocus

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.34. SetText
Metoda SetData kopiuje tekst do schowka systemowego w określonym formacie.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 229


Spis treści 230

Składnia:
obiekt.SetData Dana[, Format]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ dana (wymagany) — wartość określająca tekst, który ma zostać
umieszczony w Clipboard,
♦ format (opcja) — wartość określająca rozpoznawane formaty.

Wartości i stałe dostępne dla argumentu format:

Stała Wartość Opis

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.

Składnia:
obiekt.Show [Modalność][, Właściciel]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ 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:

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 230


Spis treści 231

♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.37. ShowFont
Metoda ShowFont wyświetla okno dialogowe Fonts kontrolki CommonDialog.

Składnia:
obiekt.ShowFont

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.38. ShowHelp
Metoda ShowHelp uruchamia pomoc systemową (wyświetlając konkretny plik
pomocy, określony właściwościami HelpFile i HelpCommand kontrolki
CommonDialog).

Składnia:
obiekt.ShowHelp

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.39. ShowOpen
Metoda ShowOpen wyświetla okno dialogowe Open kontrolki CommonDialog.

Składnia:
obiekt.ShowOpen

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.40. ShowPrinter
Metoda ShowPrinter wyświetla okno dialogowe Printer kontrolki CommonDialog.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 231


Spis treści 232

Składnia:
obiekt.ShowPrinter

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.41. ShowSave
Metoda ShowSave wyświetla okno dialogowe SaveAs kontrolki CommonDialog.

Składnia:
obiekt.ShowSave

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.42. ShowWhatsThis
Metoda ShowWhatsThis wyświetla wskazany temat (właściwością
WhatsThisHelpID obiektu) z pliku pomocy, użyty poleceniem What’s This?, menu
PopUp systemu operacyjnego.

Składnia:
obiekt.ShowWhatsThis

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.43. TextHeight
Metoda TextHeight zwraca wysokość tekstu, tak jakby został wyświetlony za
pomocą aktualnie używanej czcionki, na obiekcie.

Składnia:
obiekt.TextHeight (Łańcuch)

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ łańcuch (wymagany) — wyrażenie określające łańcuch tekstowy.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 232


Spis treści 233

3.4.44. TextWidth
Metoda TextWidth zwraca szerokość tekstu, tak jakby został wyświetlony za
pomocą aktualnie używanej czcionki, na obiekcie.

Składnia:
obiekt.TextWidth (Łańcuch)

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,

♦ ł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?
wybranego obiektu, zmieniając jednocześnie wskaźnik myszki na wskaźnik What’s This?.

Składnia:
obiekt.WhatsThisMode

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę.

3.4.46. ZOrder
Metoda ZOrder zmienia pozycję obiektu na liście z-order wewnątrz poziomów
graficznych.

Składnia:
obiekt.Zorder [Pozycja]

gdzie:
♦ obiekt — obiekt wykorzystujący tę metodę,
♦ łańcuch (opcja) — wartość określająca pozycję obiektu w stosunku do
innych instancji tego samego obiektu (0 lub pominięcie — przeniesienie na
początek, 1 — przeniesienie na koniec).

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 233


Spis treści 234

Uwagi do:
Visual Basic. Leksykon
8. W przygotowanym tekście niepotrzebnie zastosowano spacje
nierozdzielające. Przed składem i tak trzeba je likwidować.
9. Niepotrzebnie wstawiono rysunki do tabel.
10. Strona 21. i 40. — zastosowano styl Lista numerowana, ja uważam że
powinien być Lista wypunktowana.
11. W rozdziale 1. zmieniłem styl Nagłówek 5 na Nagłówek 4.
12. W rozdziale 3. zastosowano wypunktowania bez przecinków i kropki na
końcu. Zastanawiałem się co z tym zrobić i doszedłem do wniosku że nie
stanowią one zdania więc może tak zostać. Zlikwidował bym jedynie
dwukropki po tytule (Nagłówek 5).
13. Zgodnie z tym co niedawno omawialiśmy —pozostawiłem zastosowany
przez autora styl Wytłuszczenie.
14. W przygotowanym do składu tekście zastosowano dodatkowe style dla
pogrubień czy pochyleń tekstu. Jest to bardzo dobre rozwiązanie (szczególnie
w listingach) — nie można bowiem “zgubić” tych wyróżnień podczas składu.
15. Po składzie książka ma 232 strony.
16. Niejednolicie zastosowano numeracje punktów – proszę o sprawdzenie
czy tak ma być, czy nie.

E:\TAKIE TAM\KSIĄŻKI\Visual Basic\eBooks.PL.Leksykon.-.Visual.Basic.(osiol.NET)\vb leksykon.doc 234

You might also like