Kontrolka ProgressBar

Właściwości | Zdarzenia | Metody

Kontrolka ProgressBar pokazuje stan zaawansowania długotrwałych operacji przez wypełnianie kolejnych części prostokąta.

Kotrolka ProgressBar przedstawia określony zakres i pozycję. Zakres odzwierciedla całą wykonywaną operację podczas gdy pozycja określa stopień zaawansowania jej wykonywania. Właściwości Min i Max określają zakres wartości kontrolki ProgressBar. Właściwość Value określa bieżącą pozycję wewnątrz tego zakresu. Ponieważ dla pokazania stopnia zaawansowania wypełniane są kolejne fragmenty kontrolki, wartość właściwości Value określa ilość wypełnionych fragmentów. W zależności od rozmiarów kontrolki i zakresu zmian, właściwość Value określa, kiedy zostanie zapełniony następny fragment.

Właściwości Width i Height kontrolki ProgressBar określają liczbę i rozmiar wypełnianych fragmentów kontrolki. Im więcej tych fragmentów, tym bardziej dokładny jest obraz postępu wykonywanych operacji. Aby zwiększyć liczbę wypełnianych fragmentów należy zmniejszyć wysokość kontrolki lub zwiększyć jej długość. Wartość właściwości BorderStyle również ma wpływ na ilość wypełnianych fragmentów.

Można wykorzystać właściwość Align kontrolki ProgressBar aby automatycznie ustalić pozycję kontrolki na górze, na dole lub z boku formy.

Aby uzyskać pasek postępu wyraźnie przedstawiający stopień zaawansowania operacji należy ustawić długość kontrolki ProgressBar przynajmniej 12 razy większy niż jej wysokość.

Najczęściej wartość właściwości Value kontrolki ProgressBar jest zmieniana wewnątrz pętli For lub Do.

Poniższy przykład wypełnia kontrolkę ProgressBar w pętli For:

Dim varI
ProgressBar1.Min=0  'dolna wartość 0
ProgressBar1.Max=500  'górna wartość 500
ProgressBar1.Value=0  'wartość początkowa
ProgressBar1.Visible=True  'kontrolka widoczna
For varI=0 to 500  'pętla od 0 do 500
   ProgressBar1.Value=varI  'kolejna wartość
Next varI

Kontrolka ProgressBar jest częścią grupy kontrolek ActiveX, które znajdują się w pliku COMCTL32.OCX. Aby używać kontrolki ProgressBar, należy dołączyć plik COMCTL32.OCX do projektu. Przy rozpowszechnianiu aplikacji należy instalować plik COMCTL32.OCX w folderze System sytemu Microstoft Windows (System32 w Windows NT).

Właściwości:

Align	sposób wyświetlania obiektu
Appearance (ActiveX)	wygląd kontrolek
BorderStyle (ActiveX)	rodzaj obramowania
Container	pojemnik obiektu
DragIcon	wskaźnik przy operacjach drag-and-drop
DragMode	tryb operacji drag-drop
Enabled (ActiveX)	reakcja na zdarzenia użytkownika
Height (ActiveX)	wysokość obiektu
hWnd (ActiveX)	uchwyt obiektu
Left (ActiveX)	położenie lewej krawędzi obiektu
Max (ActiveX)	wartość maksymalna kontrolki
Min (ActiveX)	wartość minimalna kontrolki
MouseIcon	kursor myszki użytkownika
MousePointer (ActiveX)	kursor myszki
Name	identyfikator obiektu
Negotiate	sposób wyświetlania wyrównanej kontrolki
Object (ActiveX)	obiekt w kontrolce
OLEDropMode (ActiveX)	sposób przechwytywania operacji drop
Parent	właściciel obiektu
TabIndex	kolejność przełączania Tab
Tag (ActiveX)	dodatkowe dane obiektu
ToolTipText	podpowiedzi dla użytkownika
Top (ActiveX)	położenie górnej krawędzi obiektu
Value (ActiveX)	wartość kontrolki
Visible (ActiveX)	ukrywanie obiektu
WhatsThisHelpID	numer kontekstu pomocy
Width (ActiveX)	szerokość obiektu

na górę strony...

Zdarzenia:

Click (ActiveX)	wciśnięcie przycisku myszy
DragDrop	zakończenie przeciągania obiektu
DragOver	przeciąganie obiektu
MouseDown	wciśnięcie klawisza myszy
MouseMove	przesuwanie wskaźnika myszy
MouseUp	wciśnięcie klawisza myszy
OLECompleteDrag (ActiveX)	poinformowanie komponentu docelowego o zakończeniu operacji OLE drag/drop
OLEDragDrop (ActiveX)	opuszczanie komoponentu źródłowego na docelowym w operacji OLE drag/drop
OLEDragOver (ActiveX)	przeciąganie jednego komponentu nad drugim w operacji OLE drag/drop
OLEGiveFeedback (ActiveX)	zakończono zdarzenie OLEDragOver
OLESetData (ActiveX)	brak danych w odpowiednim formacie dla komponentu docelowego w operacji OLE drag/drop
OLEStartDrag (ActiveX)	zainicjowanie operacji OLE drag/drop

na górę strony...

Metody:

Drag	rozpoczęcie, zakończenie lub przerwanie przeciąganie kontrolki
Move	zmiana położenia obiektu
OLEDrag (ActiveX)	rozpoczęcie operacji drag/drop
ShowWhatsThis	wyświetlenie pomocy What's This?
ZOrder	zmiana kolejności z-order obiektów

na górę strony...