Mojej Mamie

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

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

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

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

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

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

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

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

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

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.

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.

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[Author:md] .

	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.

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.

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.

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.

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.

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[Author:md] .

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.

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.

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,

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

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.

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

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.

	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.

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.

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.

	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ć[Author:md] , 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.

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.

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:

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

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

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.

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:

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.

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,

4. przypisywać nowe wartości zmiennym,

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

	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,

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




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




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

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.

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

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

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

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

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

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

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)
vbFirstFourDays	2	pierwszy tydzień, w którym są co najmniej cztery dni nowego roku
vbFirstFullWeek	2	pierwszy pełny tydzień nowego roku

Przykład:

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

DataUzytkownika = InputBox("Wprowadź datę...")

'użytkownik wpisuje wymyśloną przez siebie datę

Przedzialy = DateDiff("d", DataBiezaca, DataUzytkownika)

'wyliczenie liczby dni występujących między dwoma datami, okreś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

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

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
(:)	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)
dddddd	Wyświetla datę jako kompletną datę (dzień, miesiąc, rok) w postaci krótkiej daty systemowej (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 [Author:md] 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
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

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 [Author:md] 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

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"

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

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

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.

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

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

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.

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
Date	łańcuch zawierający datę w krótkim formacie zgodnym z ustawieniami 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.

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.

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.

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

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

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.

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

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
Currency	Wyświetla liczbę z separatorem tysięcy, jeżeli jest potrzebny; wyświetla dwie cyfry do prawej strony separatora dziesiętnego. Formatowanie jest oparte na ustawieniach lokalnych w systemie
Fixed	Wyświetla przynajmniej jedną cyfrę od lewej i dwie cyfry od prawej strony separatora dziesiętnego
Standard	Wyświetla liczbę z separatorem tysięcy, przynajmniej jedną cyfrę od lewej i dwie cyfry od prawej strony separatora dziesiętnego
Percent	Wyświetla liczbę pomnożoną przez 100 ze znakiem procentu (%) dołączonym 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

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

Znak	Opis
E+ E- e+ e-	Format wykładniczy. Umieszczenie jednego z symboli wykładniczych z prawej strony 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"

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"

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
vbProperCase	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
vbFromUnicode	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.

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" [Author:PGon]

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.

Przykład:

zmA="To jest tekst testowy"

zmB=LeftB(zmA, 22)

--> 'zmienna przyjmuje wartość "To jest tek" [Author:PGon]

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.

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:

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

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

• 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

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

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
vbVariant	12	Variant (tylko dla tablic Variant)

Stała	Wartość	Opis
vbDataObject	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)
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ń

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
vbArchive	32	plik został zmieniony od ostatniego wykonania kopii zapasowej

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.

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)

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"

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
vbDirectory	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 otwar­tego w trybie Input lub Binary.

Składnia:

Input(Numer, [#]NrPliku)

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

'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

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)
vbAbortRetryIgnore	2	przyciski Abort (Przerwij), Retry (Ponów) oraz Ignore (Zignoruj)
vbYesNoCancel	3	przyciski Yes (Tak), No (Nie) i Cancel (Anuluj)
vbYesNo	4	przyciski Yes (Tak) i No (Nie)

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

Przykład:

MsgBox("Czy jesteś mężczyzną?",

vbYesNo+vbQuestion+vbDefaultButton2, "Ankieta",

"Pomoc.hlp", 7)

'na ekranie wyświetli się okienko komunikatu, zawierające

'pytanie, dwa przyciski ("Yes" oraz "No"), określenie, że

'drugi przycisk jest domyślny, tytuł, określenie pliku

'pomocy, określenie tematu w pliku pomocy

2.2.6.17. Seek

Funkcja Seek zwraca wartość typu Long, określającą następną pozycję odczytu lub zapisu otwartego pliku.

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, Input	pozycja bajta, na którym będzie wykonana następna operacja

Przykład:

zm1=Loc(3)

'zmienna przyjmie wartość, określającą następną pozycję

'zapisu lub odczytu podanego pliku

2.2.6.18. SetAttr

Funkcja SetAttr ustawia atrybuty określonego pliku.

Składnia:

SetAttr ŚcieżkaDoPliku, Atrybuty

gdzie:

• ŚcieżkaDoPliku (wymagany) — dowolne wyrażenie łańcuchowe będą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

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
vbMinimizedNoFocus	6	Okno jest zminimalizowane. Aktualnie aktywne okno pozostaje aktywne

Przykład:

Shell("C:\Windows\Notepad.exe",1)

'uruchomiona zostanie wskazana aplikacja jako aktywna

2.2.7. Pozostałe

2.2.7.1. DoEvents

Funkcja DoEvents oddaje sterowanie, aby system operacyjny mógł wykonać inne zdarzenia.

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




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

• 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

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 [Author:md] można stworzyć standardowy przycisk.

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

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

ComboBox	Label
CheckBox	ListBox
DBCombo	MSFlexGrid
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

• 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

• 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

• 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

• 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 [Author:md] 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

• 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

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

• 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

• 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

• 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

• 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

• 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

• 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

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

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

• 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

• 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

• 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

• 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

• 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

• 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

3.1.25. PictureBox

Kontrolki --> Image [Author:md] 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

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

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

• 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 [Author:md] 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

• 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

• 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

• 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

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

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)

• 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

• 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

• 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 [Author:md]

• ExitFocus — utracenie fokusa

• 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

• 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[Author:md] 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

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

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

3.2.5. Alignment

Właściwość --> Align [Author:md] 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
vbLeftJustify		0	Domyślna. Tekst wyrównany do lewej. Kontrolka wyrównana do prawej
vbRightJustify		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
vbLeftJustify	0	Domyślna. Tekst wyrównany do lewej
vbRightJustify	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

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

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

• 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
vbApplicationWorkspace	&H8000000C	kolor tła aplikacji wykorzystującej MDIForm
vbHighlight	&H8000000D	kolor tła wybranych elementów kontrolki
vbHighlightText	&H8000000E	kolor tekstu wybranych elementów
vbButtonFace	&H8000000F	kolor przycisków
vbButtonShadow	&H80000010	kolor cieniowania przycisków
vbGrayText	&H80000011	kolor niedostępnego tekstu
vbButtonText	&H80000012	kolor tekstu przycisków
vbInactiveCaptionText	&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. 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ń
vbSizableToolWindow	5	Obramowanie zawiera przycisk Zamknij i pasek tytułowy o zmniejszonym rozmiarze. Jest możliwość zmiany rozmiaru. Forma z tym ustawieniem nie jest pokazywana na pasku zadań

Wartości dostępne dla argumentu obramowanie (dla kontrolek: Image, Label, 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
vbBSDashDotDot	5	Obramowanie z kreska-kropka-kropka
vbBSInsideSolid	6	Obramowanie wewnętrzne ciągłe. Zewnętrzna krawędź ramki pełni rolę zewnętrznej krawędzi kształtu

3.2.14. BorderWidth

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

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 kon­trolki 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.

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ść.

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

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.

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 [Author:md] 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).

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

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

• 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

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.

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:

• 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
vbDownwardDiagonal	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ć.

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.

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

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

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

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

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

• 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ść,

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

6. Gdy celem konwersacji DDE są kontrolki — kontrolce docelowej pozwala na formie zainicjować konwersację określoną przez właściwości LinkTopic i LinkItem.

7. 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
vbLinkAutomatic		1	Automatyczny — kontrolka docelowa zostaje automatycznie uaktualniana za każdym razem, gdy zmieniają się połączone dane
vbLinkManual		2	Ręczny — kontrolka docelowa jest uaktualniana tylko po wywołaniu 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
vbLinkSource	1	Kontrolki Label, PictureBox, TextBox będące na formie, mogą dostarczać dane do aplikacji docelowej, która ustanowiła konwersację DDE z formą Jeżeli połączenie już istnieje, obiekt docelowy zostaje automatycznie poinformowany, kiedy zawartość kontrolek się zmieni Aplikacja docelowa może przesłać także dane do kontrolek Label, PictureBox, TextBox na formie

3.2.71. LinkTimeout

Właściwość LinkTimeout określa (lub zwraca) wartość, określającą czas 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):

2. Gdy celem konwersacji DDE są kontrolki — aplikację docelową i temat połączenia (podstawowy zbiór danych używanych w aplikacji).

3. 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:

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

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

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

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 [Author:md] 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.[Author:PGon]

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ść
vbArrowHourglass	13	Strzałka i klepsydra
vbArrowQuestion	14	Strzałka i znak zapytania
vbSizeAll	15	Zmiana wszystkich rozmiarów
vbCustom	99	Ikona użytkownika określona przez właściwość MouseIcon

3.2.86. Moveable

Właściwość Moveable określa (lub zwraca) wartość, określającą, czy obiekt może być przemieszczany.

Składnia:

obiekt.Moveable [=wartość]

gdzie:

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

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.

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

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
vbOLEDragAutomatic	1	Wszystkie operacje OLE drag/drop obsługiwane są automatycznie

3.2.97. OLEDropMode

Właściwość OleDropMode określa (lub zwraca) wartość, określającą sposób 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

Stała	Wartość	Opis
vbOLEDropAutomatic	2	Komponent docelowy akceptuje OLE drop, jeżeli obiekt DataObject 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
vbPaletteModeHalfTone	0	(Domyślna) --> systemowej palety półtonów[Author:md]
vbPaletteModeUseZOrder	1	Paleta z najwyżej w porządku znajdującej się kontrolki posiadającej paletę
vbPaletteModeCustom	2	Paleta określona we właściwości Palette
vbPaletteModeContainer	3	Paleta containerów dla containerów obsługujących właściwość Palette

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

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 Icon metafile GIF JPEG	Rodzaj grafiki w pliku

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.

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

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
vbCharacters	4	Jednostka miary to znak (poziomo = 120 twipów na jednostkę, pionowo = 240 twipów na jednostkę)
vbInches	5	Jednostka miary to cal
vbMilimeters	6	Jednostka miary to milimetr
vbCentimeters	7	Jednostka miary to centymetr

3.2.109. ScaleTop

Właściwość ScaleTop określa (lub zwraca) pionową współrzędną dla lewej i górnej krawędzi obiektu.

Składnia:

obiekt.ScaleTop [= wartość]

gdzie:

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

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
vbHorizontal	1	Kontrolka posiada poziomy pasek przewijania
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.

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.

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
vbShapeRoundedRectangle	4	kształt prostokąta o zaokrąglonych rogach
vbShapeRoundedSquare	5	kształt kwadratu o zaokrąglonych rogach

3.2.118. Shortcut

Właściwość --> Shape [Author:md] 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.

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
vbStartUpWindowsDefault	3	lewy górny róg ekranu

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
vbButtonStandard	0	(Domyślna) kontrolka CheckBox jest wyświetlana jako pole wyboru z etykietą, OptionButton jako przycisk opcji z etykietą, a CommandButton jako przycisk bez dodatkowej grafiki
vbButtonGraphical	1	Kontrolki są wyświetlane w stylu graficznym (jako przyciski)

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-DownList	2	Lista opuszczana w dół, a wyboru można dokonać tylko z niej

Wartości i stałe dostępne dla właściwości Style (dla kontrolki ListBox):

Stała	Wartość	Opis
vbListBoxStandard	0	(Domyślna) wyświetlana jako lista pozycji tekstowych
vbListBoxCheckBox	1	Wyświetlana z polami wyboru przy każdej pozycji listy

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.

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ć kla­wisza 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.

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 [Author:md] 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ść,

• 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ść,

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

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

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
vbMinimized	1	Wyświetlane jako zminimalizowane do ikony
vbMaximized	2	Wyświetlane jako zmaksymalizowane do rozmiaru ekranu

3.2.143. WordWrap

Właściwość WordWrap określa (lub zwraca) wartość, --> określającą rozmiar kontrolki Label dostosowuje się automatycznie do rozmiaru tekstu w sobie zawartego[Author:md] .

Składnia:

obiekt.WordWrap [= boolean]

gdzie:

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

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

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

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,

• 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.[Author:PGon]

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,

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

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

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:

• 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
vbRightButton	2	Przyciśnięty prawy klawisz myszy
vbMiddleButton	4	Przyciśnięty środkowy klawisz myszy

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

Stała	Wartość	Opis
vbShiftMask	1	Wybrany klawisz SHIFT
vbCtrlMask	2	Wybrany klawisz CTRL
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)

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.

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,

• 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
vbFormControlMenu	0	Użytkownik wybrał komendę Close z menu Control formy
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,

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

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

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

Stała	Wartość	Opis
vbDataActionCancel	0	operacja anulowana, gdy istnieje Sub
vbDataActionMoveFirst	1	metoda MoveFirst
vbDataActionMovePrevious	2	metoda MovePrevious
vbDataActionMoveNext	3	metoda MoveNext
vbDataActionMoveLast	4	metoda MoveLast
vbDataActionAddNew	5	metoda AddNew
vbDataActionUpdate	6	operacja Update
vbDataActionDelete	7	metoda Delete
vbDataActionFind	8	metoda Find
vbDataActionBookmark	9	ustawiona właściwość Bookmark
vbDataActionClose	10	metoda Close
vbDataActionUnload	11	usunięcie formy z pamięci

3.4. Metody kontrolek standardowych

3.4.1. AddItem

Metoda AddItem dopisuje nowy element do listy kontrolek.

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

3.4.2. Arrange

Metoda --> AddItem [Author:md] 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
vbTileHorizontal	1	nie zminimalizowane formy MDIChild — wyrównanie pionowe
vbTileVertical	2	nie zminimalizowane formy MDIChild — wyrównanie poziome
vbArrangeIcons	3	ułożenie ikon wszystkich zminimalizowanych form MDIChild

3.4.3. Assert

Metoda Assert przerywa wykonywanie programu na wierszu kodu, w którym 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.

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.

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
vbBeginDrag	1	rozpoczęcie przeciągania
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.

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
vbCFMetafile	3	format *.wmf
vbCFDIB	8	format Device-independent bitmap (DIB)
vbCFPalette	9	paleta kolorów

3.4.10. GetFormat

Metoda GetFormat pobiera grafikę ze schowka systemowego.

Składnia:

obiekt.GetFormat (Format)

gdzie:

• 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
vbCFMetafile	3	format *.wmf

Stała	Wartość	Opis
vbCFDIB	8	format Device-independent bitmap (DIB)
vbCFPalette	9	paleta kolorów

3.4.11. GetText

Metoda GetText pobiera dane tekstowe ze schowka systemowego.

Składnia:

obiekt.GetText ([Format])

gdzie:

• obiekt — obiekt wykorzystujący tę metodę,

• format (opcja) — wartość określająca rozpoznawane formaty.

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 [Author:md] 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.

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.

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,

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

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

• 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
vbPopupMenuLeftAlign	0	(Domyślna) lewa krawędź menu leży na współrzędnej X
vbPopupMenuLeftButton	0	(Domyślna) polecenia menu uruchamiane są kliknięciem lewego klawisza myszy
vbPopupMenuRightButton	2	Polecenia menu uruchamiane są kliknięciem lewego lub prawego klawisza myszy
vbPopupMenuCenterAlign	4	Menu centrowane jest na współrzędnej X
vbPopupMenuRightAlign	8	Prawa krawędź menu leży na współrzędnej X

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,

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

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:

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
vbContainerPosition vbContainerSize	9 10	Jednostkami miary są jednostki używane przez container kontrolek dla określenia ich pozycji

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.

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
vbCFMetafile	3	format *.wmf
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[Author:md]

Metoda SetData kopiuje tekst 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 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:

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

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 [Author:md] 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.

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 [Author:md] 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).

10 Visual Basic. Leksykon

Spis treści 9

44 Visual Basic. Leksykon

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

90 Visual Basic. Leksykon

Rozdział 2. ♦ Podstawy programowania w VB 89

234 Visual Basic. Leksykon

Rozdział 3. ♦ Obiekty w VB 233

???

Czym?

Co??? Programy, opcje???

Tu chyba powinno być 1000 albo 0100 (czterocyfrowa!)

Chyba Second!!!

Do językowej: nie dopisywać nic!!! Tak ma być :-)))

Do językowej: nie dopisywać nic!!! Tak ma być :-)))

CommandButton???

Chyba DBList!

Dobrze?

Chyba Slider!

???

Nie VScrollBar???

chyba Alignment

chyba DataChanged

Chyba Min

Do autora: coś się nie zgadza przy zmiennych...

????

Czy Shortcut???

Czy Text???

???

Brak zmiennej indeks w składni a jest w opisie...

Chyba Arrange!!!!!!!!!

A nie Form???

SetText czy SetData

???

???

---