home *** CD-ROM | disk | FTP | other *** search
/ Chip 2002 March / Chip_2002-03_cd1.bin / zkuste / delphi / kolekce / d123456 / SIMONS.ZIP / Doc / SRChkBox.txt < prev    next >
Encoding:
Text File  |  2001-12-16  |  5.0 KB  |  142 lines

  1. TSRCheckBox und TEnhancedCheckBox (C)opyright 2001 Version 1.20
  2.  
  3.   Autor : Simon Reinhardt
  4.   eMail : reinhardt@picsoft.de
  5.   Internet : http://www.picsoft.de
  6.  
  7.   Die Komponente TSRCheckBox ist eine Checkbox-Komponente mit Autosize-,
  8.   Transparent- und WordWrap-Eigenschaften. Au▀erdem wird kein OnClick-Ereignis
  9.   abgefeuert, wenn die Checked-Eigenschaft per Programmcode geΣndert wird.
  10.   Die Komponente ist abgeleteitet von TGraphicControl.
  11.  
  12.   Die Komponente TEnhancedCheckBox entspricht der Komponente TSRCheckBox,
  13.   ist aber von TCustomControl abgeleitet und kann deshalb auch den Eingabefokus
  14.   bekommen. Dafⁿr entfΣllt die "Transparent"-Eigenschaft.
  15.  
  16.   Die Komponenten sind Public Domain, das Urheberrecht liegt aber beim Autor. 
  17.  
  18.  
  19. Dateiumfang:
  20. ------------
  21.  
  22. SRChkBox.txt     - Diese Datei
  23. SRChkBox.pas    - Quelltext der Komponente
  24. SRChkBox.d16    - Resourcendatei der 16-Bit-Komponente fⁿr Delphi 1
  25. SRChkBox.d32    - Resourcendatei der 32-Bit-Komponente fⁿr Delphi ab Version 2
  26. SRDefine.inc    - Include-Datei
  27.  
  28.  
  29. Installation:
  30. -------------
  31.  
  32. In Delphi 1:
  33. ------------
  34. 1. Alle Dateien in das Delphi-Komponenten-Verzeichnis entpacken.
  35. 2. Menⁿ Optionen: Komponente installieren
  36. 3. SchaltflΣche Hinzufⁿgen / Durchsuchen
  37. 4. Datei SRChkBox.pas im Delphi-Komponenten-Verzeichnis suchen und mit
  38.    OK bestΣtigen.
  39. 5. Die Komponenten erscheinen in der Komponenten-Gruppe "Simon"
  40.  
  41. In Delphi 2:
  42. ------------
  43. 1. Alle Dateien in das Delphi-Komponenten-Verzeichnis entpacken.
  44. 2. Menⁿ Komponente:  installieren
  45. 3. SchaltflΣche Hinzufⁿgen / Durchsuchen
  46. 4. Datei SRChkBox.pas im Delphi-Komponenten-Verzeichnis suchen und mit
  47.    OK bestΣtigen.
  48. 5. Die Komponenten erscheinen in der Komponenten-Gruppe "Simon"
  49.  
  50. Ab Delphi 3:
  51. ------------
  52. 1. Alle Dateien in das Delphi-Komponenten-Verzeichnis entpacken.
  53. 2. Menⁿ Komponente:  Komponente installieren
  54. 3. SchaltflΣche Durchsuchen (hinter dem Eingabefeld fⁿr den Unit-Namen)
  55. 4. Datei SRChkBox.pas im Delphi-Komponenten-Verzeichnis suchen und mit
  56.    OK bestΣtigen.
  57. 5. Die Rⁿckfrage nach dem Neukompilieren des Packages bestΣtigen.
  58. 6. Die Komponenten erscheinen in der Komponenten-Gruppe "Simon"
  59.    (Evtl. mu▀ eine bereits installierte, Σltere Version der Komponenten
  60.     zuvor entfernt werden)
  61.  
  62.  
  63. Funktion:
  64. ---------
  65.  
  66. Die Komponenten funktionieren Σhnlich wie die Delphi-Komponente TCheckBox. 
  67. ZusΣtzlich gibt es eine "Autosize"-Eigenschaft, die dafⁿr sorgt, da▀ die
  68. Gr÷▀e der Komponente an den Text in der Eigenschaft "Caption" angepasst
  69. wird (wie bei TLabel). Der Text kann dank der "WordWrap"-Eigenschaft auch
  70. mehrzeilig sein. Auch die Eigenschaft "Transparent" von TSRCheckBox hat 
  71. den gleichen Effekt wie bei TLabel.
  72.  
  73. A) neue Eigenschaften:
  74. ----------------------
  75.  
  76. Alignment: TLeftRight;
  77.   Aurichtung des Textes und der Checkbox:
  78.     - taLeftJustify: Die Checkbox wird links neben dem Text angezeigt.
  79.     - taRightJustify: Die Checkbox wird rechts neben dem Text angezeigt.
  80.  
  81. AllowGrayed: boolean;
  82.   Nur wenn AllowGrayed=true, kann die Eiegnschaft "State" der CheckBox den Wert
  83.   cbGrayed annehmen.
  84.  
  85. AutoSize: boolean;
  86.   wie bei TLabel: Die Gr÷▀e des Controls wir dan den Text in der Eigenschaft
  87.   "Caption" angepasst.
  88.  
  89. CheckSize: integer;
  90.   Die Gr÷▀e (H÷he und Breite) der CheckBox in Pixeln
  91.  
  92. Grouped: boolean;
  93.   Wenn Grouped=true, verhΣlt sich die CheckBox wie TRadioButton, sonst wie 
  94.   TCheckBox.
  95.  
  96. Layout: TCheckboxLayout;
  97.   Die relative Position der Checkbox zum Text (oben/mitte/unten).
  98.  
  99. Spacing: integer;
  100.   Der Abstand des Textes zur Checkbox in Pixeln. "-1": automatisch anpassen.
  101.  
  102. State: TCheckBoxState;
  103.   Der Zustand der CheckBox (cbUnChecked, cbChecked, cbGrayed)
  104.   Der Wert cbGrayed wird nur angenommen, wenn AllowGrayed=true.
  105.  
  106. Style: TCheckStyle;
  107.   Das Aussehen der Checkbox:
  108.     - csCheckBox: wie TCheckBox
  109.     - csDiamond: Die Checkbox hat die Form einer Raute
  110.     - csPushButton: Die Checkbox sieht aus wie ein TSpeedButton
  111.     - csRadioButton: wie TRadioButton
  112.     - csTrafficLight: Fⁿr die verscheidenen ZustΣnde werden 
  113.                   Grⁿne, Rote oder Gelbe Kreise gezeichnet
  114.  
  115. Transparent: boolean;
  116.   wie bei TLabel
  117.  
  118. WordWrap: boolean;
  119.   wie bei TLabel: der Text wird automatisch umgebrochen, wenn er die Breite
  120.   des Controls ⁿbersteigt.
  121.  
  122.  
  123.  
  124. B) neue Ereignisse:
  125. -------------------
  126.  
  127. 1. "OnChange"    - dieses Ereignis wird bei jeder ─nderung des Wertes der 
  128.           "State"-Eigenschaft ausgel÷st, auch wenn der Wert dieser 
  129.           Eigenschaft per Programmcode geΣndert wird.
  130. 2. "OnClick"    - dieses Ereignis wird (nur dann) ausgel÷st, wenn die Komponente
  131.           angeklickt wird und sich dadurch der Wert der "State"-Eigenschaft 
  132.           Σndert. Es wird kein OnClick-Ereignis abgefeuert, wenn die 
  133.           Checked-Eigenschaft per Programmcode geΣndert wird.
  134.  
  135.  
  136. Die anderen Ereignisse entsprechen denen von TCheckBox. Da die TSRCheckBox-Komponente 
  137. von TGraphicControl abgeleitet ist, kann sie keinen Eingabefokus erhalten und hat deswegen 
  138. auch keine OnKey*-Ereignisse.
  139.  
  140. Die Funktion der Komponente lΣ▀t sich au▀erdem im beigefⁿgten Demo-Programm im Ordner 
  141. "Demo" sehen.
  142.