Roman Workshop: QBasic/EasyMenu 1.0

EasyMenu 1.0

OPIS
Program EasyMenu służy do tworzenia menu tekstowego (np. podczas startu systemu operacyjnego).
Po wybraniu danej pozycji z menu może być wykonanych wiele poleceń MS-DOS (np. uruchomienie
programu, polecenia lub pliku wsadowego). Menu jest tworzone na podstawie zawartości pliku
tekstowego, standardowo o nazwie "easymenu.txt". Plik ten powinien znajdować się w tym samym
katalogu, co program EasyMenu. Opis zawartości pliku "easymenu.txt":

[A],[B],[C],[D]
[Ciąg 1],[Ciąg 2],[Ciąg 3]

W pierwszej linii tego pliku są podane 4 ciągi liczbowe, standardowo oddzielone przecinkami:

[A] / [B] - numer kolumny / wiersza na ekranie, w których ma być wyświetlona pierwsza pozycja
menu. Kolejne pozycje menu będą wyświetlane w następnych wierszach ekranu. Numeracja kolumn
i werszy ekranowych, to wartości z przedziałów odpowiednio: 1-80 i 1-25. Ponieważ jednak tworzone
menu jest otoczone ramką, minimalna wartość [A] i [B] wynosi 2.

[C] - maksymalna szerokość menu (wyrażona w znakach). Jeśli nazwa danej pozycji będzie krótsza od
szerokości menu, to zostanie ona uzupełniona spacjami. Natomiast, jeśli będzie dłuższa, to zostanie ona
obcięta do szerokości menu. Minimalna wartość [C] wynosi 1.

[D] - maksymalna wysokość menu (liczba pozycji). Jeśli w pliku "easymenu.txt" znajduje się mniej
pozycji niż wynosi wysokość menu, to w menu są wyświetlane puste wiersze, których nie da się wybrać.
Natomiast, jeśli tych pozycji jest więcej, to nie są one wyświetlane w menu. Minimalna wartość [D]
wynosi 1 (dopuszczalne jest również 0).

Kolejne linie tego pliku odpowiadają pozycjom, które będą znajdować się w menu.
Każda taka linia składa się z 3 ciągów, standardowo oddzielonych przecinkami:

[Ciąg 1] - nazwa pozycji menu. Jeśli nie zostanie podana (sam przecinek), to w menu
będą wyświetlone tylko spacje (zależnie od wartości parametru [C]).

[Ciąg 2] - polecenia MS-DOS, które mają zostać wykonane po wybraniu pozycji. Może to być tylko
jedno polecenie (np. nazwa programu do uruchomienia) lub wiele poleceń, które standardowo należy
oddzielić znakiem tyldy "~". Trzeba przy tym pamiętać, że podając nazwy bez rozszerzenia (np. prog),
w pierwszej kolejności są uruchamiane rozkazy z rozszerzeniem ".com", następnie programy
wykonywalne ".exe", a na końcu pliki wsadowe ".bat". Ponadto wszystkie nie całkowite ścieżki dostępu,
należy podawać w odniesieniu do katalogu, w którym znajduje się program EasyMenu.
Nie podanie tego ciągu spowoduje, że po wybraniu pozycji zostanie uruchomiony nowy interpreter
poleceń MS-DOS (COMMAND.COM). Aby go wyłączyć i powrócić do menu, należy wpisać polecenie
EXIT. Maksymalna długość tego ciągu (nie licząc spacji z lewej strony, które są ignorowane)
standardowo wynosi 150 znaków i jest określana przez wartość zmiennej "F" w kodzie źródłowym
programu EasyMenu.

[Ciąg 3] - opis pozycji menu, który zostanie wyświetlony po jej zaznaczeniu. Opis jest wyświetlany
począwszy od pierwszej kolumny, w wierszu tuż pod dolną ramką menu. W opisie można umieścić znak
oddzielenia (standardowo tylda "~"), który spowoduje wyświetlenie reszty opisu w drugiej linii.
Dopuszczalne jest nie podawanie opisu (sam przecinek). Maksymalna długość tego ciągu wynosi
160 znaków (2 linie po 80 znaków).

W ten sposób za pomocą programu EasyMenu można wyświetlić menu, składające się z tylu pozycji,
ile zmieści się na ekranie. Poniżej znajduje się przykładowa zawartość pliku "easymenu.txt"
i wygląd wygenerowanego na jego podstawie menu:

24,4,31,17
Diagnostic 4.45,cd diag~diag~cd..,Program diagnostyczny.
EasyRecovery 6.10,cd er~xbios /p- /z /i /m /v=2~loadaspi~rdrint13 /v=0~drmouse~erdos /ve:32~cd..,Odzysk danych.
Ranish Partition Manager 2.40,cd rpm~240~cd..,Program do zarzĄdzania twardym dyskiem.
Ranish Partition Manager 2.43,cd rpm~243~cd..,Program do zarzĄdzania twardym dyskiem.
Ranish Partition Manager 2.44,cd rpm~244~cd..,Program do zarzĄdzania twardym dyskiem.
QBasic 1.1,cd qb11~qbasic~cd..,—rodowisko programistyczne j©zyka QuickBasic.
QBasic 4.50,cd qb45~qb~cd..,—rodowisko programistyczne j©zyka QuickBasic.
ShowFA 1.3,showfa,Program do wywietlania zawartoci plik˘w w postaci znak˘w ASCII.
ShowFHA 1.3,showfha,Program do wywietlania zawartoci plik˘w w postaci~wartoci szesnastkowych i znak˘w ASCII.
Mem,mem~wait,Informacje o pami©ci RAM.
FDisk,fdisk,Program do partycjonowania twardego dysku.
ScanDisk,scandisk,Program do sprawdzania poprawnoci dysk˘w.
Edit 2.0.026,edit,Edytor tekstowy MS-DOS.
Diagnostics 2.14,msd,Program diagnostyczny MS-DOS.
MS-DOS Help 1.1,cd qb11~help~cd..,Dokumentacja systemu MS-DOS 6.22.
3F25dB 1.0,3f25db,Program do obliczania 3-stopniowego filtru cz©stotliwociowego.
Blast 1.0,blast,Prosta gra logiczna.

W powyższym pliku tekstowym znajdują się polskie znaki zapisane w standardzie MS-DOS, ponieważ
EasyMenu jest programem działającym w tym systemie. Dlatego znaki te nie są prawidłowo wyświetlane
w systemie Windows. Patrz: Zapis polskich znaków.

KLAWISZOLOGIA
Klawisze używane do obsługi menu:

KLAWIATURA	KEY PAD	FUNKCJE
		poruszanie się po menu w górę/dół.
		wybranie zaznaczonej pozycji w menu.
	-	wyjście z menu.

Klawisze bloku numerycznego (Num Pad) na keypadzie działają tylko wtedy,
gdy jest wyłączona ich blokada (dioda Num Lock na klawiaturze, nie świeci się).

ARGUMENTY
Za nazwą programu EasyMenu można podać jeden z dwóch argumentów:

/? - powoduje wyświetlenie informacji o programie.

[filepath] - ścieżka do pliku tekstowego z definicją menu (zamiast standardowego "easymenu.txt"),
na podstawie którego program EasyMenu wygeneruje menu.

Brak argumentu spowoduje próbę otwarcia standardowego pliku "easymenu.txt" z definicją menu,
który powinien znajdować się w tym samym katalogu, co program EasyMenu.

Podanie więcej niż jednego argumentu spowoduje wyświetlenie komunikatu "Too many arguments."

BŁĘDY
W razie wystąpienia różnych nieprzewidzianych sytuacji
może pojawić się komunikat o błędzie, np. "Runtime error: 53".

Patrz: Błędy Runtime języka QBasic.

INNE
W kodzie źródłowym programu EasyMenu, znajdują się następujące zmienne tekstowe:
B$ - zawiera znak (standardowo przecinek ","), którym
muszą być oddzielone ciągi w pliku z definicją menu.
C$ - zawiera znak (standardowo tylda "~"), którym muszą być oddzielone argumenty ciągów w pliku
z definicją menu. Argumentami [Ciągu 2] są polecenia MS-DOS do wykonania i może być ich wiele.
Argumentami [Ciągu 3] są dwie części opisu pozycji menu. Część znajdująca się po lewej stronie od
znaku oddzielenia zostanie wyświetlona w pierwszej, a część po prawej stronie - w drugiej linii tuż
pod dolną ramką menu.

Po uruchomieniu z poziomu EasyMenu programu/polecenia/pliku wsadowego, który po wykonaniu
od razu kończy swoje działanie, na ekranie nie będą widoczne żadne wyświetlone przez niego
informacje. Dzieje się tak dlatego, że EasyMenu natychmiast po jego zakończeniu czyści ekran
i generuje własne menu. Tak więc, zanim zdążymy odczytać wyświetlone informacje, zostaną one
niezauważalnie usunięte z ekranu. Aby temu zapobiec, należy po nazwie takiego programu/polecenia
/pliku wsadowego w [Ciągu 2], wpisać znak oddzielenia (standardowo tylda "~"), a następnie nazwę
(ewentualnie ze ścieżką dostępu) polecenia "WAIT.COM" (znajduje się w archiwum). Jest to bardzo
mały program (11 bajtów), który po uruchomieniu czeka na naciśnięcie dowolnego klawisza.
Jego zawartość wygląda następująco (wartości szesnastkowe):
31 C0 CD 16 B4 4C CD 21 20 0D 0A.