Prefiksy

Prefiksy wyszukiwania służą do dodawania dodatkowych elementów do listy komponentu pulpitu szukaj. W tym celu należy napisać odpowiedni program i dodać go do słownika programów .net w systemie Prestiż, a następnie dodać wpis do słownika "Pulpity - Prefiksy wyszukiwania".

Spis

 I. Okno edycyjne prefiksów wyszukiwania
 II. Schemat tworzenia programu .NET
     II.1. Opis funkcji Load
     II.2. Opis funkcji Main

I. Okno edycyjne prefiksów wyszukiwania

Okno składa się z pól:

  Prefiks

Prefiks, który użytkownik będzie zmuszony wpisać aby program się uruchomił. W przypadku pustego program będzie uruchamiał się za każdym razem.

  Opis

Krótki opis tego co robi dany prefiks (jakie elementy może dodać).

  Program

Napisany wcześniej program w systemie Prestiż .NET.

II. Schemat tworzenia programu .NET

Program powinien zawierać statyczne i publiczne metody:

  Main

Zwraca wartość typu string, przyjmuje tablicę wartości typu string.

  Load

Nie zwraca wartości, przyjmuje tablicę wartości typu string.

Przykłady plików .net, które spełniają schemat: DashPref_Calc, DashPref_ExchangeRate, DashPref_Google, DashPref_Help, DashPref_Search.

II.1. Opis funkcji Load

Funkcja zostanie uruchomiona w chwili, gdy użytkownik wpisze zgadzający się z nią prefiks w pole wyszukiwania. W parametrach wejściowych na zerowej pozycji znajduje się wpisane przez użytkownika wyrażenie z wyciętym prefiksem (np. gdy użytkownik wpisze fa 3/15/2018, a prefiksem jest "fa", to w pierwszym elemencie tablicy będzie wartości "3/15/2018").

Tylko w tej funkcji można dodać elementy do listy pola szukaj. Aby to zrobić należy stworzyć obiekt typu "DashSearchItem" znajdujący się w przestrzeni nazw "Streamsoft.DashboardPrefixes".Klasa posiada pola:

  Title

Tytuł wyświetlany na liście (domyślnie puste, gdy nie wypełnimy, to pole się nie doda).

  Desc

Opis wyświetlany na liście pod tytułem (domyślnie puste).

  Bold

Czy pole ma być napisane pogrubioną czcionką (domyślnie false).

  Value

Wartość, która zostanie przekazana do metody "Main" (domyślnie puste).

  RepoName

Nazwa ikony wyświetlanej na liście (domyślnie puste i wtedy zostanie wyświetlona ikona lupy).

  HexColor

Kolor wyświetlanej ikony w formacie HTML (np. "#FF0000").

Po wypełnieniu w.w. pól można dodać nowo utworzony element listy poprzez użycie metody "AddDashSearchItem()" na tym obiekcie.

II.2. Opis funkcji Main

Funkcja zostanie wywołana w przypadku, gdy użytkownik wybierze element listy (zeche go uruchomić).W parametrach wejściowych na zerowej pozycji znajduje się wpisane przez użytkownika wyrażenie z wyciętym prefiksem, a na pierszej pozycji (drugi element tablicy) znajduje się wartość wpisana w pole "Value", które zostało wprowadzone w metodzie "Load".

W metodzie można wykonać obsługę uruchomienia naszego elementu listy.

Wartość zwrócona przez tę metodę zostanie wyświetlona na ekranie pod listą najpopularniejszych. Jeżeli nie chcemy nic wyświetlać, to możemy w wyniku metody zwrócić pusty string lub wartość "null".