Skryptowanie komponentów graficznych

W skrócie

Poznaj komponenty graficzne dostępne podczas tworzenia skryptów w Altium Designer — od kontrolek opartych na VCL po komponenty specyficzne dla Altium. Ten materiał referencyjny wyjaśnia, jak tworzyć formularze skryptowe, znajdować właściwości, metody i zdarzenia komponentów oraz dostosowywać wygląd i zachowanie formularzy za pomocą paneli Tool Palette i Object Inspector. Czytaj dalej, aby nabrać pewności w pracy z formularzami skryptowymi i ich kontrolkami.

- 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.
Zagłęb się w temat dzięki AI:
 

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.

Język VBScript jest uznawany za przestarzały i domyślnie nie jest dostępny, ale można go włączyć za pomocą ustawienia Legacy.Scripts.SupportOldLanguages w preferencjach zaawansowanych.

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

Wygląd i zachowanie panelu można zmienić za pomocą jego menu kontekstowego, dostępnego po kliknięciu prawym przyciskiem myszy.

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

Należy pamiętać, że powyższy link prowadzi do dokumentacji Embarcadero RAD Studio XE6 biblioteki VCL. Dostępna jest również dokumentacja wcześniejszych wydań (aż do wersji 2010).

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.

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

Powyższy odnośnik prowadzi do dokumentacji referencyjnej biblioteki VCL dla Embarcadero RAD Studio XE6. Dostępna jest również dokumentacja wcześniejszych wydań (aż do wersji 2010).

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 TButton wybierz 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ść FormStyle na fsStayOnTop.
  • Aby zdefiniować domyślne zachowanie formularza, ustaw FormKind na jedną z następujących wartości: fkNone, fkNormal, fkServerPanel lub fkModal.
    • 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.
  • Aby dodać lub usunąć paski przewijania formularza, zmień wartości właściwości HorzScrollBar i VertScrollBar.
  • 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 BorderIcons i BorderStyle. (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 ClientHeight i ClientWidth. Pamiętaj, że ClientHeight i ClientWidth określają obszar wewnątrz obramowania formularza, natomiast Height i Width okreś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 ActiveControl i 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.

AI-LocalizedTłumaczenie SI
Jeśli znajdziesz błąd, zaznacz tekst/obraz i naciśnij Ctrl + Enter aby wysłać nam wiadomość.
Nav
Contents
Dostępność funkcji

Dostępne funkcje zależą od tego, z którego rozwiązania Altium korzystasz – Altium Develop, Altium Agile Teams, Altium Agile Enterprise lub Altium Designer (w ramach aktywnej subskrypcji terminowej).

Jeśli opisana funkcja nie jest widoczna w Twoim oprogramowaniu, skontaktuj się z działem sprzedaży Altium, aby dowiedzieć się więcej.

Starsza dokumentacja

Dokumentacja Altium Designer nie jest już wersjonowana. Jeśli potrzebujesz dostępu do dokumentacji dla starszych wersji Altium Designer, odwiedź sekcję Starsza dokumentacja na stronie Inne instalatory.

Contents