Skryptowanie komponentów graficznych
W skrócie
- Dowiedz się, jak tworzyć formularze skryptowe i dodawać kontrolki z panelu Tool Palette.
- Poznaj sposoby sprawdzania właściwości, znajdowania metod i generowania procedur obsługi zdarzeń związanych z interakcjami użytkownika.
- Poznaj ustawienia sterujące wyglądem formularza, zachowaniem okna, obsługą klawiatury i początkowym fokusem.
Niniejsza dokumentacja przedstawia obsługiwane komponenty graficzne do tworzenia skryptów oraz ich główne właściwości i metody.
Wizualne komponenty formularzy dostępne w skryptach Altium Designer pochodzą głównie z biblioteki Visual Component Library (VCL) firmy Embarcadero, która jest zbiorem zdefiniowanych komponentów wizualnych do tworzenia aplikacji Windows w językach Delphi i C++.
Bibliotekę VCL opracowano jako bibliotekę klas wizualnych. Jej klasy wywodzą się z obiektu TComponent (który z kolei jest potomkiem obiektu głównego TObject) w liniowej hierarchii obiektów. Dlatego typowy komponent skryptu, taki jak obiekt TButton, dziedziczy właściwości, metody i zdarzenia po swoich obiektach nadrzędnych. W tym przypadku hierarchia klas wygląda następująco: TObject → TPersistent → TComponent → TControl → TWinControl → TButtonControl → TButton.
Należy pamiętać, że komponenty wywodzące się z obiektu TControl są zazwyczaj komponentami wizualnymi (kontrolkami), a typowe komponenty wywodzące się z TWinControl to przeważnie nakładki na interfejs API systemu Windows.
► Omówienie architektury i komponentów VCL można znaleźć w dokumentacji Embarcadero RAD Studio VCL.
Podczas tworzenia formularza w edytorze skryptów Altium Designer komponenty są dostępne w panelu Tool Palette. Z formularzami skryptów powiązany jest plik *.DFM, który zawiera szczegóły konfiguracji formularza, położenie jego komponentów i inne atrybuty — plik ten znajduje się w folderze projektu skryptu. Altium Designer umożliwia korzystanie z komponentów w języku DelphiScript lub VBScript podczas projektowania formularzy skryptów.

Panel Tool Palette zawiera podzielone na kategorie kontrolki wizualne, które można przeciągać na formularz skryptu.
Panel Tool Palette zawiera podzielone na kategorie zestawy komponentów, które można umieszczać na formularzu skryptu. Dostępne komponenty są zebrane w rozwijanych sekcjach panelu Tool Palette, w kategoriach Standard, Additional, Win32, System, Dialogs, Altium Standard i Instrument Controls.
Komponenty (nazywane też „kontrolkami”) dostępne w palecie są komponentami wizualnymi, gdy zostaną użyte na formularzu skryptu. Oznacza to, że użytkownik może zobaczyć kontrolkę, a także potencjalnie wchodzić z nią w interakcję podczas wykonywania skryptu. Wszystkie kontrolki mają właściwości, metody i zdarzenia opisujące aspekty ich wyglądu i zachowania, na przykład właściwość określającą położenie kontrolki, metody służące do jej rysowania lub przesuwania oraz zdarzenia reagujące na działania użytkownika.
Właściwości i zdarzenia aktualnie wybranego komponentu formularza, w tym samego formularza, są dostępne w panelu Object Inspector. Metody to procedury i funkcje obsługiwane przez dany komponent.
Omówienie formularzy skryptów
Formularze skryptów
Formularz skryptu jest podstawowym interfejsem użytkownika w skryptach, choć istnieją również inne rodzaje formularzy, takie jak okna dialogowe, okna dodatkowe itd. Aby utworzyć nowy formularz skryptu, przy otwartym projekcie w Altium Designer wybierz File » New » Script » Script Form lub kliknij prawym przyciskiem myszy nazwę projektu skryptu i wybierz Add New to Project » Script Form. Jeśli język VBScript jest włączony, polecenie jest dostępne zarówno dla VBScript, jak i DelphiScript.
Nowy formularz skryptu pojawia się z domyślną nazwą Form1, którą można zmienić za pomocą właściwości Name (w sekcji Misc) w panelu Object Inspector. Nazwy formularzy skryptów powinny być unikatowe w obrębie projektu.
Podczas projektowania formularza skryptu otwórz panel Object Inspector za pomocą przycisku Script na dolnym pasku stanu.
Pusty formularz jest zasadniczo oknem wizualnym, do którego można dodawać kontrolki. Okno dialogowe i panel to różne typy formularzy. Domyślnie formularz udostępnia standardowe funkcje okna, takie jak:
- Kontrolki
- Przyciski minimalizacji i maksymalizacji
- Pasek tytułu
- Zmiana rozmiaru przez przeciąganie obramowania
Te funkcje, podobnie jak wszystkie inne dostępne właściwości formularza, można zmieniać na etapie projektowania za pomocą panelu Object Inspector. Ponieważ formularz skryptu jest komponentem VCL, ma następujące trzy elementy:
-
Properties – Cechy obiektu wpływające na jego widoczne zachowanie lub działanie. Na przykład właściwość
Visibleokreśla, czy obiekt jest widoczny na formularzu skryptu. - Events – Działania lub wystąpienia wykrywane przez skrypt. Skrypt musi zawierać kod dla każdej procedury obsługi zdarzenia, przeznaczonej do przechwytywania określonego zdarzenia, takiego jak kliknięcie myszą.
- Methods – Procedury skryptu powiązane z obiektami (w tym przypadku obiektami komponentów), które definiują ich zachowanie.
► Podstawowy przewodnik po tworzeniu skryptów opartych na formularzach można znaleźć w sekcji Pisanie skryptów.
Właściwości, metody i zdarzenia formularza
Kontrolki panelu Tool Palette są oparte na bibliotece Visual Component Library (VCL) firmy Embarcadero. Pełne informacje o metodach, właściwościach i zdarzeniach komponentu formularza (TForm) można znaleźć w dokumentacji VCL firmy Embarcadero.
► Zobacz dokumentację TForm firmy Embarcadero
Właściwości TForm
Dostępne właściwości obiektu komponentu TForm, czyli bazowego formularza skryptu, można wyświetlić na następujące sposoby:
- Za pomocą panelu Object Inspector — w widoku formularza w edytorze (przy wybranej karcie Form ) kliknij w obszarze samego formularza i wybierz kartę Object Inspector's Properties .
Należy pamiętać, że w panelu pojawią się wyłącznie obiekty komponentów wizualnych. Obiekty niewizualne, które pełnią funkcję kontrolek działających w tle, nie są wyświetlane na formularzu.
- Korzystając z funkcji uzupełniania kodu — w widoku kodu w edytorze (przy wybranej karcie Code ) kontekstowe okno uzupełniania kodu wyświetla wszystkie opcje kodu dla danej nazwy obiektu.
W przypadku obiektu formularza wpisz TForm. (zwróć uwagę na kropkę), aby wywołać to okno. Zawęź wyszukiwanie, wpisując kilka pierwszych liter żądanej właściwości — pamiętaj, że wyświetlane są zarówno właściwości, jak i metody.
- W dokumentacji firmy Embarcadero na stronie poświęconej właściwościom TForm.
Metody TForm
Dostępne metody obiektu komponentu TForm można wyświetlić na następujące sposoby:
- Korzystając z funkcji uzupełniania kodu — w widoku kodu w edytorze wpisz nazwę komponentu, a po niej kropkę. Otworzy się okno uzupełniania kodu, wyświetlające metody (i właściwości) dla danej nazwy obiektu. Pamiętaj, że okno uzupełniania kodu można wywołać ręcznie za pomocą skrótu klawiaturowego Crtl+Space.
- W dokumentacji firmy Embarcadero na stronie poświęconej metodom TForm. Należy pamiętać, że wyświetlane są tam wszystkie odziedziczone metody, ale tę opcję można wyłączyć.
Zdarzenia TForm
Dostępne zdarzenia obiektu komponentu TForm można wyświetlić na następujące sposoby:
- W panelu Object Inspector — w widoku formularza w edytorze kliknij w obszarze samego formularza i wybierz kartę Events w panelu Object Inspector.
- W dokumentacji firmy Embarcadero na stronie poświęconej zdarzeniom TForm.
Właściwości, zdarzenia i metody komponentów
Kontrolki panelu Tool Palette są oparte na bibliotece Embarcadero Visual Component Library (VCL). Szczegółowe informacje o metodach, właściwościach i zdarzeniach większości komponentów można znaleźć w kategoriach komponentów w dokumentacji Embarcadero VCL. Niektóre typy komponentów w Tool Palette, w szczególności kontrolki instrumentów Altium, są dostępne wyłącznie w Altium Designer i nie zostały uwzględnione w dokumentacji referencyjnej Embarcadero.
► Zobacz Indeks kategorii komponentów Embarcadero VCL
Właściwości komponentów
Aby wyświetlić listę właściwości komponentu:
-
Wybierz komponent na formularzu i aktywuj kartę Properties w panelu Object Inspector — jak pokazano powyżej dla obiektu komponentu
TForm. -
Wybierz odnośnik Properties (u góry) na odpowiedniej stronie dokumentacji komponentu w dokumentacji referencyjnej Embarcadero. Na przykład w przypadku kontrolki
TButtonwybierz kategorię Komponent standardowy, stronę TButton, a następnie widok Właściwości.
Zdarzenia komponentów
Aby wyświetlić listę zdarzeń, na które komponent może reagować:
-
Wybierz komponent na formularzu i aktywuj kartę Events w panelu Object Inspector — jak pokazano powyżej dla obiektu komponentu
TForm. - Wybierz odpowiednią stronę dokumentacji komponentu, a następnie znajdujący się na niej odnośnik Events w dokumentacji referencyjnej Embarcadero. Może to służyć jako przewodnik po zdarzeniach dostępnych dla komponentu, jednak lista ta może nie odpowiadać w pełni zdarzeniom dostępnym dla komponentów skryptowych Altium Designer.
Aby utworzyć procedurę obsługi zdarzenia, wybierz na karcie Object Inspector Events zdarzenie, na które komponent ma reagować, i kliknij dwukrotnie w polu wpisu zdarzenia. Procedura obsługi zdarzenia, której nazwa jest tworzona na podstawie nazwy komponentu i zdarzenia, zostanie automatycznie wygenerowana w skrypcie. Jeśli nazwa zdarzenia zostanie zmieniona w panelu Object Inspector, nazwa odpowiadającej mu procedury w kodzie zostanie odpowiednio zmieniona.
Metody komponentów
Informacje o metodach dostępnych dla komponentu Tool Palette można znaleźć w dokumentacji Kategorie komponentów.
Obejmuje ona dokumentację następujących kategorii obiektów kontrolek.
- Standardowe
- Dodatkowe
- Win32
- Systemowe
- Okna dialogowe
- Standardowe Altium
- Kontrolki instrumentów
W większości kategorie te grupują typy wizualnych kontrolek formularzy opartych na standardowych komponentach VCL typu Delphi. Wyjątek stanowią kategorie Standardowe Altium i Kontrolki instrumentów, ponieważ oferują komponenty dostępne wyłącznie w systemie skryptowym Altium Designer.
► Zobacz Tool Palette Kategorie komponentów.
Praca z formularzami i komponentami
Dostosowywanie formularzy skryptowych
-
Aby na przykład formularz pozostawał nad innymi otwartymi panelami, ustaw właściwość
FormStylenafsStayOnTop. -
Aby zdefiniować domyślne zachowanie formularza, ustaw
FormKindna jedną z następujących wartości:fkNone, fkNormal, fkServerPanellubfkModal.-
Jeśli wybrano
fkModal, formularz będzie modalny. Oznacza to, że będzie oczekiwał na działanie użytkownika przed wykonaniem dalszych operacji, takich jak zamknięcie formularza. -
Jeśli wybrano
fkServerPanel, formularz będzie wyświetlany jako panel serwera. -
Jeśli wybrano
fkNormal, formularz będzie działał jak zwykły formularz niemodalny.
-
Jeśli wybrano
-
Aby dodać lub usunąć paski przewijania formularza, zmień wartości właściwości
HorzScrollBariVertScrollBar. -
Aby formularz pełnił funkcję ramki lub okna podrzędnego MDI (Multiple Document Interface — interfejs wielu dokumentów), użyj właściwości
FormStyle. -
Aby zmienić styl obramowania formularza, użyj właściwości
BorderIconsiBorderStyle. (Wyniki są widoczne w czasie wykonywania). -
Aby zmienić ikonę zminimalizowanego formularza, użyj właściwości
Icon. -
Aby określić początkowe położenie formularza w oknie aplikacji, użyj właściwości
Position. -
Aby określić początkowy stan formularza (na przykład zminimalizowany, zmaksymalizowany lub normalny), użyj właściwości
WindowState. -
Aby zdefiniować obszar roboczy formularza w czasie wykonywania, użyj właściwości
ClientHeightiClientWidth. Pamiętaj, żeClientHeightiClientWidthokreślają obszar wewnątrz obramowania formularza, natomiastHeightiWidthokreślają cały obszar formularza. -
Aby określić, która kontrolka będzie początkowo aktywna w formularzu w czasie wykonywania, użyj właściwości
ActiveControli wybierz jeden z dostępnych komponentów. -
Aby przekazywać wszystkie zdarzenia klawiatury do formularza, niezależnie od wybranej kontrolki, użyj właściwości
KeyPreview. -
Aby wskazać konkretne menu, gdy formularz zawiera więcej niż jedno menu, użyj właściwości
Menu.
Odświeżanie formularzy i komponentów
W niektórych przypadkach wygląd formularza skryptowego może przestać odzwierciedlać jego aktualny stan. Na przykład intensywne przetwarzanie w tle wykonywane przez skrypt może spowodować, że kontrolki nie będą aktualizowane ani przerysowywane i będą wyglądać na zawieszone lub wyświetlane nieprawidłowo.
Metoda Update formularza skryptowego umożliwia programowe odświeżanie zawartości graficznej formularza lub określonych kontrolek. W poniższym przykładzie kodu wiersze wywołujące metodę Update są wyróżnione na szaro.
Using the Update method to refresh the Status Bar:
Procedure TConverterForm.loadbuttonClick(Sender: TObject);
Var
I, J : Integer;
Begin
If OpenPictureDialog1.Execute then
Begin
XPProgressBar1.Position := 0;
XStatusBar1.SimpleText := ' Loading...';
XStatusBar1.Update;
// loading a monochrome bitmap only
Image1.Picture.LoadFromFile(OpenPictureDialog1.FileName);
// Check if image is monochrome, otherwise prompt a warning
If Image1.Picture.Bitmap.PixelFormat <> pf1bit Then
Begin
For J := 0 to Image1.Picture.Height – 1 Do
For I := 0 to Image1.Picture.Height – 1 Do
Begin
If Image1.Canvas.Pixels[I,J] <> clWhite Then
Image1.Canvas.Pixels[I,J] := clBlack;
End;
End;
ScalingFactorChange(Nil);
convertbutton.Enabled := True;
LoadButton.Enabled := False;
XStatusBar1.SimpleText := ' Ready...';
XStatusBar1.Update;
End;
End;
Zobacz projekt skryptowy PCB Logo Creator znajdujący się w folderze Scripts\Delphiscript Scripts\PCB\PCB Logo Creator w dostępnym do pobrania zbiorze skryptów.



