File: ideoptionsintf.xml

package info (click to toggle)
lazarus 2.0.0%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 214,460 kB
  • sloc: pascal: 1,862,622; xml: 265,709; cpp: 56,595; sh: 3,008; java: 609; makefile: 535; perl: 297; sql: 222; ansic: 137
file content (74 lines) | stat: -rw-r--r-- 4,430 bytes parent folder | download | duplicates (11)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<?xml version="1.0"?>
<fpdoc-descriptions>
  <package name="IDEIntf">
    <module name="IDEOptionsIntf">
      <element name="TAbstractIDEOptions">
        <short>
          <var>TAbstractIDEOptions</var> - abstract ancestor for any options class which IDE should know about</short>
        <descr>To create own options classes inherit them from the TAbstractIDEOptions class. This is so for TEnvironmentOptions, TEditorOptions, THelpOptions which IDE registers itself.</descr>
      </element>
      <element name="TAbstractIDEOptionsEditor">
        <short>
          <var>TAbstractIDEOptionsEditor</var> - abstract ancestor for any options frame class which IDE should  know about</short>
        <descr>If there is a need to register an own options frame in IDE options dialog inherit it from the TAbstractIDEOptionEditor which is Frame with predefined methods which must be implemented in the descendant.</descr>
      </element>
      <element name="TAbstractIDEOptions.GetGroupCaption">
        <short>
          <var>GetGroupCaption</var> - class function which returns a caption of the option group in the IDE options dialog</short>
      </element>
      <element name="TAbstractIDEOptions.GetInstance">
        <short>
          <var>GetInstance</var> - class function which must return an instance of the paticular options class</short>
      </element>
      <element name="TAbstractIDEOptionsEditor.Check">
        <short>
          <var>Check</var> - function which must return True if options are correct and dialog can be closed and False in other case</short>
      </element>
      <element name="TAbstractIDEOptionsEditor.GetTitle">
        <short>
          <var>GetTitle</var> - function which must return a string Title for the options frame</short>
      </element>
      <element name="TAbstractIDEOptionsEditor.Setup">
        <short>
          <var>Setup</var> - method which executes on options page showing</short>
        <descr>Setup controls captions or create dynamic controls or perform another initialization actions when Setup is called.</descr>
      </element>
      <element name="TAbstractIDEOptionsEditor.ReadSettings">
        <short>
          <var>ReadSettings</var> - method which is called when options frame should load options</short>
        <descr>Load component values from options in this method.</descr>
      </element>
      <element name="TAbstractIDEOptionsEditor.WriteSettings">
        <short>
          <var>WriteSettings</var> - method which is called when options frame should save options</short>
        <descr>Save component values to options in this method.</descr>
      </element>
      <element name="TAbstractIDEOptionsEditor.SupportedOptionsClass">
        <short>
          <var>SupportedOptionsClass</var> - class function which must return an options class which this frame supports</short>
      </element>
      <element name="RegisterIDEOptionsGroup">
        <short>
          <var>RegisterIDEOptionsGroup</var> - function which registers options class for showing in IDE options dialog</short>
        <descr>
          <var>AGroupIndex: Integer</var> - group index defines the position of the options group among other
<var>AGroupClass: TAbstractIDEOptionsClass</var> - options class
<var>FindFreeIndex: boolean = true</var> - defines whether to search for the free group index starting from the passed value or to use paticular passed value

Function returns a pointer to the record which IDE stores in the internal list of options classes.</descr>
      </element>
      <element name="RegisterIDEOptionsEditor">
        <short>
          <var>RegisterIDEOptionsEditor</var> - function which registers options frame for showing in the IDE options dialog</short>
        <descr>
          <var>AGroupIndex: Integer;</var> - index of a group where the options frame will be shown
<var>AEditorClass: TAbstractIDEOptionsEditorClass;</var> - options frame to register
<var>AIndex: Integer;</var> - index of the frame defines a position of the frame among other
<var>AParent: Integer = NoParent;</var> - index of the parent options frame if needed
<var>AutoCreateGroup: boolean = false;</var> - create group if not exists (can be used if registration order is not reliable)

Function returns a pointer to the record which IDE stores in the internal list of options frame classes.</descr>
      </element>
    </module>
  </package>
</fpdoc-descriptions>