Właściwość ClipControls

Właściwość ClipControls ustala lub zwraca wartość decydującą czy metody graficzne w zdarzeniu Paint odrysowują cały obiekt czy tylko nowo odsłonięty obszar (po zmianie rozmiarów lub przesłonięciu innym oknem). Określa również czy środowisko operacyjne Microsoft Windows tworzy wycięty obszar, który wyłącza niegraficzne kontrolki zawarte w obiekcie. W fazie uruchamiania właściwość jest tylko do odczytu.

Składnia właściwości ClipControls:

obiekt.ClipControls

obiekt to obiekt który wykorzystuje właściwość ClipControls, dostępny na liście
boolean to zwracana wartość typu Boolean określające sposób odtwarzania obiektów:

Wartość	Opis
True	(Domyślny) Metody graficzne w zdarzeniu Paint odtwarzają cały obiekt. Wycięty obszar jest tworzony wokół niegraficznych kontrolek na formie przed wykonaniem zdarzeniu Paint.
False	Metody graficzne w zdarzeniu Paint odtwarzają tylko nowo-odsłonięty obszar. Wycięty obszar nie jest tworzony wokół kontrolek niegraficznych przed zdarzeniem Paint. Złożona forma zwykle jest szybciej ładowana i odtwarzana, gdy właściwość ClipControls ma wartość False.

Wycinanie jest procesem określającym, które części Formy lub kontrolki container (jak kotrolki Frame lub PictureBox) są rysowane kiedy forma jest wyświetlana. Zarys formy i kontrolek jest tworzony w pamięci. System operacyjny Windows używa tego zarysu do rysowania niektórych części, takich jak tło, bez wpływu na inne części, lub jak zawartość kotrolki TextBox. Ponieważ wycięty obszar jest tworzony w pamięci, ustawienie właściwości na False może skrócić czas potrzebny na narysowanie lub odtworzenie formy.

Obszar wycięty zawiera najczęściej kontrolki, ale nie wycina wokół kontrolek Image, Label, Line lub Shape.
Należy unikać zagnieżdżania łączonych kontrolek z właściwością ClipControls ustawioną na True z kontrolką o właściwości ClipControls ustawioną na False (np. kontrolki CommandButton wewnątrz kontrolki PictureBox). Taki rodzaj zagnieżdżania kontrolek może powodować, że są one niepoprawnie odtwarzane. Aby uniknąć tego problemu, należy ustawić właściwość ClipControls obydwu, kontrolki container i kontrolki zagnieżdżonej na True.

Lista obiektów wykorzystujących właściwość ClipControls:
Form
Frame
PictureBox
PropertyPage
UseControl
UserDocument

Przykład użycia wlaściwości ClipControls:

Private Sub Form_Paint ()
BackColor = &HFFFFFF * Rnd 'ustaw losowy kolor tła
End Sub

Przykład pokazuje w jaki sposób zmiana właściwości ClipControls wpływa na sposób odtwarzania formy. Przy właściwości ClipControls ustawionej na True, przy każdej zmianie rozmiaru zmienia się kolor tła całej formy. Po zmianie właściwości ClipControls na False, przy każdej zmianie rozmiaru, nowym kolorem wypełniany jest tylko nowy obszar, reszta pozostaje bez zmian.
Aby sprawdzić działanie przykładu należy wprowadzić podany kod do sekcji deklaracji formy.

na górę strony...