THintList

Ta stran je trenutno še v izdelavi.

Razred THintList se uporablja za spreminjanje informacij o plasteh pod miško. Spreminja se osnovne lastnosti liste, samo listo informacij, posamezno informacijo pa se ureja preko razreda THintItem.

Spreminja se lahko:

• trenutno listo informacij v aplikaciji preko spremenljivke HintList,
• vse tematike shranjene v sistemu,

Urejanje liste informacij

Count

Lastnost Count vrne število informacij v listi.

RO Property THintList.Count As Long
Result	Long	Število informacij.

Message ("Lastnosti informacij", "V listi je " + IntToStr (HintList.Count) + " informacij.")

Items

Lastnost Items vrne določeno informacijo.

RO Property THintList.Items (Index As Long) As THintItem
Index	Long	Zaporedna številka informacije. Prva informacija ima številko 0.
Result	THintItem	Referenca na informacijo.

Dim I As Long
For I = 0 To HintList.Count - 1
  HintList.Items (I).Closest = true // nastavi vse informacija na prikaz samo najbližjega zapisa
Next

Add

Metoda Add doda novo informacijo na konec liste.

Method THintList.Add As THintItem
Result	Optional THintItem	Vrne referenco na novo informacijo.

Dim HI As THintItem
HI = HintList.Add        // Doda novo informacijo na konec liste
HI.Layer = [Neka plast]  // Določi plast informacije
HI.Field = HI.Layer.DataSets(0).Fields(0) // Določi polje izpisa

Insert

Metoda Insert vrine novo informacijo na določeno mesto v listi.

Method THintList.Insert (Index As Long) As THintItem
Index	Long	Zaporedna številka informacije, pred katero bo nova informacija vrinjena. Prva informacija ima številko 0.
Result	Optional THintItem	Vrne referenco na novo informacijo.

Dim HI As THintItem
HI = HintList.Insert (2) // Doda novo informacijo na tretje mesto v listi
HI.Layer = [Neka plast]  // Določi plast teme
HI.Field = HI.Layer.DataSets(0).Fields(0) // Določi polje izpisa

Remove

Metoda Remove izbriše določeno informacijo iz liste.

Method THintList.Remove (Index As Long)
Index	Long	Zaporedna številka informacije, ki jo želimo odstraniti. Prva informacija ima številko 0.

HintList.Remove (2)                // Izbriše tretjo informacijo iz liste
HintList.Remove (HintList.Count-1) // Izbriše zadnjo informacijo iz liste

Skupno za objekte

Lastnosti liste se običajno nastavljajo v Urejevalnik liste informacij, možen pa je tudi dostop do vseh podatkov preko basica. Pri spreminjanju katerikolih podatkov objekta, morate za dokončno spremembo izvesti še Store ukaz.

Dim Hl as THintList
Hl = [Neka lista informacij]
Message ("Lastnosti lista informacij", 
  "Ime: " + Hl.Name + Line +
  "Dodatna imena: " + Hl.Alias + Line +
  "Komentar: " + Hl.Comment + Line +
  "ID: $" + IntToHex (Hl.ID) + Line +
  "Mapa: " + Hl.Parent.Name + Line +
  "Naredil: " + Hl.Creator.Name + " Ob: " + DateTimeToStr (Hl.Created) + Line +
  "Popravil: " + Hl.Modifier.Name + " Ob: " + DateTimeToStr (Hl.Modified) + Line +
  "Pravica vpogleda: " + Hl.ViewAccess.Name + Line +
  "Pravica urejanja: " + Hl.EditAccess.Name + Line +
  "Cela pot: " + Hl.FullName
)

Name

Lastnost Name določa osnovno ime objekta (opisno ime). Ker se ime lahko občasno spreminja, se sklicevanje na objekt z uporabo imena odsvetuje. Uporabljate rajši dodatno ime ali ID objekta.

Property THintList.Name As String
Result	String	Ime objekta.

Alias

Lastnost Alias določa dodatno ime objekta ali celo več dodatnih imen. Ta lastnost se načeloma uporablja za sklice na objekt namesto osnovnega imena objekta.

Property THintList.Alias As String
Result	String	Dodatna imena. Če jih je več, morajo biti ločena s podpičjem.

Comment

Lastnost Comment določa komentar k objektu.

Property THintList.Comment As String
Result	String	Poljuben komentar.

ID

Lastnost ID določa unikatni identifikator objekta, ki se samodejno kreira pri kreiranju objekta in se nikdar ne spremeni.

RO Property THintList.ID As Long
Result	Long	Identifikator objekta.

Parent

Lastnost Parent določa ime mape, v kateri se imenovani objekt nahaja.

Property THintList.Parent As TFolder
Result	TFolder	Mapa objekta.

FullName

Lastnost FullName vrne polno ime objekta, ki je sestavljeno iz imen vseh map nad objektom in imena objekta.

RO Property THintList.FullName As String
Result	String	Vse mape in ime objekta.

Creator

Lastnost Creator določa uporabnika, ki je objekt ustvaril.

RO Property THintList.Creator As TUser
Result	TUser	Uporabnik.

Created

Lastnost Created določa datum in čas nastanka objekta.

RO Property THintList.Created As DateTime
Result	DateTime	Čas nastanka objekta.

Modifier

Lastnost Modifier določa uporabnika, ki je objekt nazadnje spremenil.

RO Property THintList.Modifier As TUser
Result	TUser	Uporabnik.

Modified

Lastnost Modified določa datum in čas, ko je bil objekt nazadnje spremenjen.

RO Property THintList.Modified As DateTime
Result	DateTime	Čas zadnje spremembe objekta.

ViewAccess

Lastnost ViewAccess določa, katera skupina uporabnikov ima pravico uporabe objekta.

Property THintList.ViewAccess As TUserGroup
Result	TUserGroup	Skupina uporabnikov.

EditAccess

Lastnost EditAccess določa, katera skupina uporabnikov ima pravico spreminjanja objekta.

Property THintList.EditAccess As TUserGroup
Result	TUserGroup	Skupina uporabnikov.

UsedIn

Lastnost UsedIn določa, v katerih aplikacijah je določen objekt uporabljan. Če nastavimo vrednost UsedIn na "*", potem je objekt dosegljiv v vseh aplikacijah. Ta podatek se uporablja izključno za izvoz aplikacije v SIF.

Property THintList.UsedIn As String
Result	String	Aplikacije, ki uporabljajo ta objekt. Če je navedenih več aplikacij, se le-te ločijo s podpičjem.

IsFolder

Lastnost IsFolder določa, ali je dani objekt mapa ali kak drug objekt.

RO Property THintList.IsFolder As Boolean
Result	Boolean	V danem primeru je vrednost vedno False.

IsObject

Lastnost IsObject določa, ali je dani objekt mapa ali kak drug objekt.

RO Property THintList.IsObject As Boolean
Result	Boolean	V danem primeru je vrednost vedno True.

ObjectType

Lastnost ObjectType določa vrsto objekta. Vrsto določajo Konstante.Object_Types_Constants

RO Property THintList.ObjectType As Long
Result	Long	V danem primeru je vrednost otHintList.

Edit

Metoda Edit odpre urejevalnik objekta.

Method THintList.Edit

[Neka lista informacij].Edit

Store

Metoda Store dejansko shrani spremembe objekta (izvedene z SDMS Basic ukazi).

Method THintList.Store

[Neka lista informacij].Store

Duplicate

Metoda Duplicate podvoji objekt. Ime podvojenega objekta je sestavljeno iz "Kopija " in imena originala, dodatno ime (Alias) pa je zbrisano. Objekt se kreira v isti mapi, kot je original.

Method THintList.Duplicate (DuplicateData As Boolean) As THintList
DuplicateData	Boolean	Pri listi informacij se ignorira.
Result	Optional THintList	Referenca na kreiran objekt.

Dim HL As THintList
HL = [Neka lista informacij].Duplicate(False)
HL.Name = 'Novo ime'
HL.Store

SaveToNewObject

Metoda SaveToNewObject prikaže dialog za shranjevanje objekta.

Method THintList.SaveToNewObject (Caption As String, Root As TFolder) As THintList
Caption	String	Napis na dialogu.
Root	TFolder	Izhodišče za izbiro lokacije shranjevanja.
Result	Optional THintList	Referenca na shranjeni objekt.

HintList.SaveToNewObject ('Shranjevanje liste informacij', root)

Clear

Metoda Clear briše vse informacije iz liste.

Method THintList.Clear

HintList.Clear
HintList.AddList ([Neka lista informacij])

Delete

Metoda Delete briše objekt iz sistema.

Method THintList.Delete As Boolean
Result	Optional Boolean	Vrne True, če je bilo brisanje uspešno.

[Neka lista informacij].Delete

SaveToFile

Metoda SaveToFile shrani objekt v binarni obliki v dano datoteko.

Method THintList.SaveToFile (FileName As String)
FileName	String	Polno ime datoteke, v katero naj se objekt shrani.

HintList.SaveToFile ('c:\temp\ListaInformacij.tmp')

LoadFromFile

Metoda LoadFromFile naloži objekt iz datoteke v binarni obliki. Ta datoteka je predhodno nastala z ukazom SaveToFile.

Method THintList.LoadFromFile (FileName As String) As Boolean
FileName	String	Polno ime datoteke, iz katere naj se objekt naloži.
Result	Optional Boolean	Vrne True, če je bil objekt uspešno naložen.

HintList.LoadFromFile ('c:\temp\ListaInformacij.tmp')

SaveToSif

Metoda SaveToSif shrani objekt v SIF obliki v datoteko.

Method THintList.SaveToSif (FileName As String)
FileName	String	Polno ime datoteke, v katero naj se objekt shrani.

SaveToSifAppend

Metoda SaveToSifAppend doda objekt v obstoječo SIF datoteko.

Method THintList.SaveToSifAppend (FileName As String)
FileName	String	Polno ime datoteke, v katero naj se objekt doda.

SaveToXml

Metoda SaveToXml shrani objekt v XML obliki v datoteko.

Method THintList.SaveToXml (FileName As String)
FileName	String	Polno ime datoteke, v katero naj se objekt shrani.