home *** CD-ROM | disk | FTP | other *** search
/ Chip 2002 March / Chip_2002-03_cd1.bin / zkuste / delphi / kolekce / d123456 / SIMONS.ZIP / Doc / SRValEdt.txt < prev    next >
Encoding:
Text File  |  2001-12-16  |  6.8 KB  |  199 lines
  1. TSRValueEdit (C)opyright 2001 Version 1.00
  2.  
  3.   Autor : Simon Reinhardt
  4.   eMail : reinhardt@picsoft.de
  5.   Internet : http://www.picsoft.de
  6.  
  7.   Die Komponente TSRValueEdit ist eine Kombination aus
  8.   einem Drehknopf fⁿr die optische Anzeige des eingestellten
  9.   Wertes und zwei weiteren Komponenten zur Einstellung des Wertes:
  10.  
  11.   - Einer TNumericEdit-Komponente fⁿr die alphanumerische
  12.     Eingabe eines Zahlenwerts. Zahlenwerte k÷nnen direkt eingetippt
  13.     werden oder man kann ⁿber SpinButtons einzelne Stellen Σndern.
  14.  
  15.   - Einer TSliderEdit-Komponente fⁿr die Einstellung eines
  16.     Zahlenwerts mit der Maus. Dazu wird einfach ein Schiebesteller
  17.     an die gewⁿnschte Position gezogen. 
  18.  
  19.   ZusΣtzlich werden die letzten vier eingestellten Werte gespeichert 
  20.   und k÷nnen ⁿber ein Popup-Menⁿ wieder abgerufen werden. Auf diese 
  21.   Weise stellt sie den optimalen Kompromiss zwischen minimalem 
  22.   Platzbedarf und optimaler Bedienbarkeit mit Maus und Tastatur zur 
  23.   Auswahl eines Zahlenwertes dar. 
  24.  
  25.   Die Komponente ist Public Domain, das Urheberrecht liegt aber 
  26.   beim Autor.
  27.  
  28.  
  29.  
  30. Dateiumfang:
  31. ------------
  32.  
  33. Readme.txt     - Diese Datei
  34.  
  35. SRValEdt.pas    - Quelltext der Komponente
  36. SRValEdt.d16    - Resourcendatei der 16-Bit-Komponente fⁿr Delphi 1
  37. SRValEdt.d32    - Resourcendatei der 32-Bit-Komponente fⁿr Delphi 2 bis 5
  38. SRDefine.inc
  39. rr.inc        - Inculdedateien fⁿr die Komponente
  40. rrColors.pas    - Funktionen zur RGB-HSL-Umrechnung
  41. SRUtils.pas    - verschiedende Prozeduren und Funktionen fⁿr die Komponente
  42.                   (Eine Beschreibung findet man im Interface der Unit)  
  43.     
  44. Ordner    Demo        - TSRValueEdit-Demo-Projekt fⁿr 32-Bit-Delphi
  45.     ValMain.dfm    - Formulardatei der MainForm
  46.     ValMain.pas    - Quelltext der MainForm-Unit
  47.     VEDemo.dof    - Compileroptionen des Demo-Projekts
  48.     VEDemo.dpr    - Quelltext des Demo-Projekts
  49.     VEDemo.res    - Resourcendatei des Demo-Projekts
  50.  
  51.  
  52. Installation:
  53. -------------
  54.  
  55. In Delphi 1:
  56. ------------
  57. 1. Alle Dateien in das Delphi-Komponenten-Verzeichnis entpacken.
  58. 2. Menⁿ Optionen: Komponente installieren
  59. 3. SchaltflΣche Hinzufⁿgen / Durchsuchen
  60. 4. Datei SRValEdt.pas im Delphi-Komponenten-Verzeichnis suchen und mit
  61.    OK bestΣtigen.
  62. 5. Die Komponenten erscheinen in der Komponenten-Gruppe "Simon"
  63.  
  64. In Delphi 2:
  65. ------------
  66. 1. Alle Dateien in das Delphi-Komponenten-Verzeichnis entpacken.
  67. 2. Menⁿ Komponente:  installieren
  68. 3. SchaltflΣche Hinzufⁿgen / Durchsuchen
  69. 4. Datei SRValEdt.pas im Delphi-Komponenten-Verzeichnis suchen und mit
  70.    OK bestΣtigen.
  71. 5. Die Komponenten erscheinen in der Komponenten-Gruppe "Simon"
  72.  
  73. Ab Delphi 3:
  74. ------------
  75. 1. Alle Dateien in das Delphi-Komponenten-Verzeichnis entpacken.
  76. 2. Menⁿ Komponente:  Komponente installieren
  77. 3. SchaltflΣche Durchsuchen (hinter dem Eingabefeld fⁿr den Unit-Namen)
  78. 4. Datei SRValEdt.pas im Delphi-Komponenten-Verzeichnis suchen und mit
  79.    OK bestΣtigen.
  80. 5. Die Rⁿckfrage nach dem Neukompilieren des Packages bestΣtigen.
  81. 6. Die Komponenten erscheinen in der Komponenten-Gruppe "Simon"
  82.    (Evtl. mu▀ eine bereits installierte, Σltere Version der Komponente
  83.     zuvor entfernt werden)
  84.  
  85.  
  86.  
  87. Funktion:
  88. ---------
  89.  
  90. Wenn man mit der linken Maustaste auf den Drehknopf klickt, erscheint das
  91. TSliderEdit-Control. Es verschwindet automatisch wieder, solbald man die 
  92. Maustaste wieder loslΣsst. HΣlt man beim Mausklick die Umschalttaste gedrⁿckt, 
  93. wird das TSliderEdit-Control mit [Enter], [Esc] oder mit einem Klick auf den Close-
  94. Button des SliderEdits wieder ausgeblendet, oder wenn es den Eingabefokus verliert.
  95.  
  96. Es folgt eine kurze Aufstellung aller von TPanel abweichenden Eigenschaften 
  97. und Ereignisse:
  98.  
  99. A) Eigenschaften:
  100. -----------------
  101.  
  102. CaptureMouse: boolean;
  103.   Bestimmt, ob der Mauszeiger den Bereich der TSliderEdit-Kpomponente verlassen kann.
  104.  
  105. Colors: TColors;
  106.   Background        - Hintergrundfarbe
  107.   NumBackground        - Hintergrundfarbe der TNumericEdit-Komponente
  108.   NumFrame        - Rahmenfarbe der TNumericEdit-Komponente
  109.   SpinBorder        - Randfarbe des SpinControls (Drehknopfes)
  110.   SpinTop        - OberflΣchenfarbe des SpinControls (Drehknopfes) und
  111.               des TSliderEdit-Rulers
  112.   SpinMark        - Farbe der Markierung des SpinControls (Drehknopfes)
  113.               und der TSliderEdit-Markierung.
  114.   SliderBackground    - Hintergrundfarbe der TSliderEdit-Komponente
  115.   Ticks               - Farbe der Positionsmarkierungen
  116.  
  117. DecSeparator: char;
  118.   Das Dezimaltrennzeichen, wenn DescSeparatorPos>0
  119.  
  120. DecSeparatorPos: byte;
  121.   Die Position des Dezimal-Trennzeichens (von rechts)
  122.  
  123. FocusRect: boolean;
  124.   Bestimmt, ob ein Fokusrahmen auf dem Control gezeichnet werden soll.
  125.  
  126. MaxValue: extended;
  127.   H÷chster einzustellender Wert
  128.  
  129. MinValue: extended;
  130.   Niedrigster einzustellender Wert
  131.  
  132. NumDigits: TNumDigits;
  133.   Anzahl der Dezimalstellen der TNumericEdit-Komponente
  134.  
  135. RulerDirection: TRulerDirection;
  136.   rdHorizontal - die TSliderEdit-Komponente wird horizontal angezeigt.
  137.   rdVertical   - die TSliderEdit-Komponente wird vertikal angezeigt.
  138.  
  139. ScrewSize: TScrewSize;
  140.   Durchmesser der Schrauben
  141.  
  142. ShowScrews: boolean;
  143.   Bestimmt, ob in den Ecken des Controls angedeutete Schrauben gezeichnet werden.
  144.  
  145. SliderEditLength: integer;
  146.   LΣnge der TSliderEdit-Komponente
  147.  
  148. SliderEditWidth: integer;
  149.   Breite der TSliderEdit-Komponente
  150.  
  151. SliderWidth: integer;
  152.   Breite des TSliderEdit-Sliders
  153.  
  154. SpinBtnHeight: integer;
  155.   H÷he der Spinbuttons der TNumericEdit-Komponente
  156.  
  157. SpinControlWidth: integer;
  158.   Durchmesser des SpinControls (Drehknopfes)
  159.  
  160. TickStyle : TTickStyle;
  161.   tsAll        - Es werden zehn Positionsmarkierungen gezeichnet
  162.   tsHalf    - Es werden nur drei Positionsmarkierungen gezeichnet
  163.   tsNone    - Es werden keine Positionsmarkierungen gezeichnet.
  164.  
  165. Value: extended;
  166.   Der eingestellte Wert
  167.  
  168. ValueHistory: boolean;
  169.   Wenn diese Eigenschaft den Wert "true" hat und der Eigenschaft "PopupMenu"
  170.   kein Popop-Menⁿ zugewiesen ist, werden die letzten vier eingestellten Werte
  171.   der "Value"-Eigenschaft gespeichert und k÷nnen aus einem Popup-Menⁿ abgerufen
  172.   werden, wenn mit der rechten Maustaste auf die Komponente geklickt wurde.
  173.  
  174.  
  175. B) Ereignisse:
  176. --------------
  177.  
  178. OnChange: TNotifyEvent;
  179.   wird bei jeder ─nderung der Value-Eigenschaft ausgel÷st.
  180.  
  181. OnHideSlider: TNotifyEvent;
  182.   wird bei ausgel÷st, wenn die TSliderEdit-Komponente ausgeblendet wird.
  183.  
  184. OnHistoryClick: TNotifyEvent;
  185.   wird bei ausgel÷st, wenn aus dem History-PopupMenⁿ ein gespeicherter Wert 
  186.   abgerufen wird.
  187.  
  188. OnShowSlider: TNotifyEvent;
  189.   wird bei ausgel÷st, wenn die TSliderEdit-Komponente angezeigt wird.
  190.  
  191. OnSpinBtnClick: TNESpinBtnClick;
  192.   wird ausgel÷st wenn einer der SpinButtons der TNumericEdit-Komponente
  193.   angeklickt wurde.
  194.  
  195.  
  196. Eine Beschreibung der Komponente TNumericEdit findet man in der Datei "NumEdit.txt", 
  197. ein Beschreibung der Komponente TSliderEdit findet man in der Datei "SlidEdit.txt".
  198. Die Funktion der Komponenten lΣ▀t sich au▀erdem im beigefⁿgten Demo-Programm im 
  199. Ordner "Demo" sehen.