Przegląd i konfiguracja systemu skryptów

W skrócie

Poznaj narzędzia i ustawienia dostępne do tworzenia skryptów w Altium Designer — od edytora i debugera po moduły skryptów, formularze i przykładowe projekty. Ten artykuł przedstawia środowisko skryptowe, wyjaśnia, jak uruchomić prosty przykład, oraz omawia preferencje umożliwiające konfigurację przestrzeni projektowej. Czytaj dalej, aby postawić pierwsze kroki w automatyzacji zadań w Altium Designer.

- Poznaj role modułów skryptów, formularzy skryptowych i paneli używanych do pisania oraz debugowania skryptów.
- Dowiedz się, jak otworzyć i uruchomić przykładowy skrypt, w tym projekt „Hello World”.
- Poznaj ustawienia dotyczące zachowania edytora, kolorów składni, opcji wyświetlania, globalnych projektów skryptowych i projektowania formularzy.
Zagłęb się w temat dzięki AI:
 

System skryptowy Altium Designer zapewnia wszystkie narzędzia i funkcje potrzebne do tworzenia skryptów automatyzujących zadania w oprogramowaniu.

Edytor skryptów, debugger i panele skryptowe współpracują ze sobą, ułatwiając pisanie i debugowanie skryptów. Skrypt można uruchomić bezpośrednio z edytora skryptów lub przypisać do menu, paska narzędzi albo skrótu klawiaturowego, aby w dowolnym momencie zastosować go do bieżącego dokumentu — na przykład projektu płytki PCB.

Altium Designer z oknami kodu i formularza skryptu oraz panelami Object Inspector, Code Explorer i Tool Palette .
Altium Designer z oknami kodu i formularza skryptu oraz panelami Object Inspector, Code Explorer i Tool Palette .

Funkcje systemu skryptowego

System skryptowy składa się z dwóch głównych części — edytora i debuggera. Jego najważniejsze funkcje to:

  • Project access – Skrypty można zapisywać w projekcie skryptowym lub projektowym. Procedury i funkcje z dowolnego skryptu w projekcie są dostępne dla innych skryptów w tym samym projekcie.

  • Scripting Editor – Edytor skryptów jest wyposażony w dedykowany edytor tekstu z szeregiem opcji konfiguracji środowiska edycji i kolorowania składni.

  • Scripting Panels – System skryptowy udostępnia szereg paneli, które pomagają szybko pisać i debugować skrypty.

  • Scripting Debugger – Jeśli podczas wykonywania skryptu wystąpi błąd, pojawi się okno dialogowe ze zwięzłym komunikatem o błędzie. Debugger skryptów umożliwia podgląd zmiennych w oknie Watches, śledzenie kodu i sterowanie wykonywaniem skryptu.

  • Scripting Languages – Skrypty można tworzyć w języku DelphiScript oraz w języku VBScript, jeśli zostanie on włączony jako język starszego typu.

  • Domyślnym językiem skryptowym jest DelphiScript. Można otwierać i uruchamiać istniejące skrypty napisane w językach VBScript i JavaScript (Jscript). Aby móc tworzyć nowe skrypty w języku VBScript, należy włączyć opcję Legacy.Scripts.SupportOldLanguages w oknie dialogowym ustawień zaawansowanych.

  • Dokumentację interfejsu API skryptów można znaleźć tutaj: Obiekty interfejsu API skryptów. Należy pamiętać, że ta dokumentacja była ostatnio aktualizowana dla starszej wersji Altium Designer. Chociaż wiele zasad i metod postępowania pozostaje bez zmian, interfejsy, obiekty, metody, właściwości i podobne elementy uległy od tego czasu zmianom, a dokumentacja nie obejmuje wszystkich elementów dostępnych w nowszych wersjach oprogramowania.

Moduły i formularze skryptów

Projekty skryptowe obsługują dwa typy dokumentów skryptowych — moduły skryptów i formularze skryptów. Moduły skryptów umożliwiają pisanie samodzielnych procedur i funkcji. Formularze skryptów pozwalają tworzyć okna dialogowe z kontrolkami i procedurami obsługi zdarzeń, a także procedurami i funkcjami.

  • Moduł skryptu może korzystać z interfejsu programowania aplikacji (API) X2 do modyfikowania obiektów projektowych w dokumencie projektu lub wykonywania na nich operacji. Formularz skryptu zawiera kontrolki tworzące interfejs użytkownika i wykorzystuje interfejs API X2 do udostępniania okien dialogowych skryptu, które działają na aktywnych dokumentach projektu.
  • Formularz skryptu jest wizualnym modułem formularza obsługiwanym przez skrypt. Gdy formularz jest aktywny, stanowi okno dialogowe.
  • Formularz skryptu ma dwa widoki — widok kodu skryptu i widok formularza skryptu. Widok kodu skryptu zawiera procedury obsługi zdarzeń oraz procedury i funkcje. Widok formularza skryptu przedstawia formularz okna dialogowego (różnych typów) i zawiera kontrolki wraz z powiązanymi z nimi procedurami obsługi zdarzeń.
  • Z formularzem skryptu są powiązane dwa pliki: plik *.pas, który zawiera procedury obsługi zdarzeń oraz procedury i funkcje, a także plik *.dfm, który zawiera szczegóły samego formularza skryptu wraz z jego komponentami i ich położeniem.
  • Komponent to wizualny lub niewizualny obiekt kontrolki (umieszczany z panelu Tool Palette), który przyjmuje dane wejściowe od użytkownika, takie jak kliknięcie myszą lub ciąg wprowadzonych znaków. Podczas projektowania do modyfikowania komponentów w formularzu skryptu można używać panelu Object Inspector. Komponentów można używać w dowolnym formularzu skryptu, w dowolnym języku obsługiwanym przez system skryptowy.
  • Komponent (obiekt kontrolki) ma metody, właściwości i zdarzenia, z których może korzystać formularz skryptu.
    • Metody to działania, które obiekt może wykonywać.
    • Właściwości reprezentują dane zawarte w obiekcie, które można odczytywać lub modyfikować.
    • Zdarzenia to sytuacje, na które może reagować komponent w formularzu skryptu.
  • Formularz skryptu zawiera procedury obsługi zdarzeń, które przetwarzają wykryte zdarzenia, takie jak kliknięcie przycisku formularza.

Dokumentacja skryptów koncentruje się głównie na języku DelphiScript. Język DelphiScript jest oparty na technologii Embarcadero DelphiScript. Informacje o różnicach między DelphiScript a Object Pascal (używanym w Delphi) można znaleźć w dokumentacji referencyjnej DelphiScript.

Przykładowe skrypty Altium Designer

Skrypty przykładowe i referencyjne są pomocnym źródłem wiedzy o tym, jak w skryptach wykorzystuje się interfejsy obiektów, metody, procesy, właściwości i komponenty. Mogą również stanowić podstawę własnych projektów skryptowych.

Starsze projekty referencyjne, opracowane przy okazji premiery Altium Designer 10, można pobrać tutaj. Zawierają one szereg przykładów symulacji i skryptów. Należy pamiętać, że są to materiały archiwalne i nie są aktualizowane.
Informacje o innych przykładowych skryptach można znaleźć w dokumentacji referencyjnej przykładów skryptów. Praktyczne omówienie działających przykładów skryptów w Altium Designer znajduje się w artykułach Pisanie skryptów i Analiza przykładowego skryptu.

Uruchamianie przykładu

Aby szybko uruchomić przykładowy skrypt w Altium Designer, najpierw otwórz przykładowy projekt lub pojedynczy plik skryptu z jednego z folderów z przykładowymi skryptami — na przykład prosty projekt „Hello World” (HelloWorld.PRJSCR) z folderu Scripts\Delphiscript Scripts\General.

Przykładowe skrypty będą dostępne w folderze, do którego rozpakowano pobrane archiwum ZIP.

Projekt Hello World w języku DelphiScript otwarty w panelu Projects .
Projekt Hello World w języku DelphiScript otwarty w panelu Projects .

Projekt zawiera dwie wersje skryptu „Hello World”, z których druga (HelloWorlDialog.pas) demonstruje podstawowe zastosowanie modułu formularza. Kliknij dwukrotnie nazwę skryptu, aby otworzyć go w edytorze i przejrzeć jego zawartość — pamiętaj, że skrypt można uruchomić bez otwierania go w edytorze.

Aby uruchomić jeden ze skryptów, wybierz File » Run Script z menu głównego, a następnie wybierz dostępną procedurę skryptu w oknie dialogowym Select Item To Run. Po uruchomieniu wybranej wersji otworzy się okno dialogowe z komunikatem.

Szybki i prosty sposób uruchamiania przykładowego skryptu.Szybki i prosty sposób uruchamiania przykładowego skryptu.

Konfiguracja systemu skryptowego

Preferencje

Domyślne ustawienia preferencji systemu skryptowego można skonfigurować w oknie dialogowym Preferencje, dostępnym po kliknięciu przycisku w prawym górnym rogu obszaru projektowania.

Preferencje ogólne

Strona Edytory tekstu – Ogólne w oknie dialogowym Preferences umożliwia dostosowanie ustawień edycji skryptów, takich jak sposób wyszukiwania ciągów znaków, stosowanie tabulatorów i wcięć w wierszach, przypisania klawiszy oraz szereg innych opcji zaawansowanych.


Strona Text Editors – General w oknie dialogowym Preferences

Preferencje kolorów

Strona Edytory tekstu – Kolory w oknie dialogowym Preferences umożliwia skonfigurowanie kolorowania składni w edytorze skryptów dla wybranego języka skryptowego oraz ustawienie kolorów elementów edytora. Na przykład można ustawić czarne tło, biały kolor słów kluczowych komentarzy itd.

Strona Text Editors – Colors w oknie dialogowym Preferences
Strona Text Editors – Colors w oknie dialogowym Preferences

Preferencje wyświetlania

Strona Edytory tekstu – Wyświetlanie w oknie dialogowym Preferences umożliwia skonfigurowanie wyglądu skryptów, w tym wyświetlania prawych marginesów i numerów wierszy, podświetlania składni oraz zwijania bloków kodu.

Strona Text Editors – Display w oknie dialogowym Preferences
Strona Text Editors – Display w oknie dialogowym Preferences

Preferencje projektów globalnych

Strona System skryptowy – Projekty globalne w oknie dialogowym Preferences zawiera listę dostępnych (zainstalowanych) projektów skryptowych. Projekty skryptowe można instalować, usuwać lub zmieniać ich kolejność.

Strona Scripting System – Global Projects w oknie dialogowym Preferences
Strona Scripting System – Global Projects w oknie dialogowym Preferences

Preferencje projektanta formularzy

Strona System skryptowy – Projektant formularzy w oknie dialogowym Preferences udostępnia opcje siatki i oznaczeń komponentów dla dokumentu formularza skryptowego.

Strona Scripting System – Form Designer w oknie dialogowym Preferences
Strona Scripting System – Form Designer w oknie dialogowym Preferences

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