Przegląd i konfiguracja systemu skryptów
W skrócie
- 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.
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 .
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.
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.
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.
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.

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