home *** CD-ROM | disk | FTP | other *** search
- TSRCheckBox und TEnhancedCheckBox (C)opyright 2001 Version 1.20
-
- Autor : Simon Reinhardt
- eMail : reinhardt@picsoft.de
- Internet : http://www.picsoft.de
-
- Die Komponente TSRCheckBox ist eine Checkbox-Komponente mit Autosize-,
- Transparent- und WordWrap-Eigenschaften. Au▀erdem wird kein OnClick-Ereignis
- abgefeuert, wenn die Checked-Eigenschaft per Programmcode geΣndert wird.
- Die Komponente ist abgeleteitet von TGraphicControl.
-
- Die Komponente TEnhancedCheckBox entspricht der Komponente TSRCheckBox,
- ist aber von TCustomControl abgeleitet und kann deshalb auch den Eingabefokus
- bekommen. Dafⁿr entfΣllt die "Transparent"-Eigenschaft.
-
- Die Komponenten sind Public Domain, das Urheberrecht liegt aber beim Autor.
-
-
- Dateiumfang:
- ------------
-
- SRChkBox.txt - Diese Datei
- SRChkBox.pas - Quelltext der Komponente
- SRChkBox.d16 - Resourcendatei der 16-Bit-Komponente fⁿr Delphi 1
- SRChkBox.d32 - Resourcendatei der 32-Bit-Komponente fⁿr Delphi ab Version 2
- SRDefine.inc - Include-Datei
-
-
- Installation:
- -------------
-
- In Delphi 1:
- ------------
- 1. Alle Dateien in das Delphi-Komponenten-Verzeichnis entpacken.
- 2. Menⁿ Optionen: Komponente installieren
- 3. SchaltflΣche Hinzufⁿgen / Durchsuchen
- 4. Datei SRChkBox.pas im Delphi-Komponenten-Verzeichnis suchen und mit
- OK bestΣtigen.
- 5. Die Komponenten erscheinen in der Komponenten-Gruppe "Simon"
-
- In Delphi 2:
- ------------
- 1. Alle Dateien in das Delphi-Komponenten-Verzeichnis entpacken.
- 2. Menⁿ Komponente: installieren
- 3. SchaltflΣche Hinzufⁿgen / Durchsuchen
- 4. Datei SRChkBox.pas im Delphi-Komponenten-Verzeichnis suchen und mit
- OK bestΣtigen.
- 5. Die Komponenten erscheinen in der Komponenten-Gruppe "Simon"
-
- Ab Delphi 3:
- ------------
- 1. Alle Dateien in das Delphi-Komponenten-Verzeichnis entpacken.
- 2. Menⁿ Komponente: Komponente installieren
- 3. SchaltflΣche Durchsuchen (hinter dem Eingabefeld fⁿr den Unit-Namen)
- 4. Datei SRChkBox.pas im Delphi-Komponenten-Verzeichnis suchen und mit
- OK bestΣtigen.
- 5. Die Rⁿckfrage nach dem Neukompilieren des Packages bestΣtigen.
- 6. Die Komponenten erscheinen in der Komponenten-Gruppe "Simon"
- (Evtl. mu▀ eine bereits installierte, Σltere Version der Komponenten
- zuvor entfernt werden)
-
-
- Funktion:
- ---------
-
- Die Komponenten funktionieren Σhnlich wie die Delphi-Komponente TCheckBox.
- ZusΣtzlich gibt es eine "Autosize"-Eigenschaft, die dafⁿr sorgt, da▀ die
- Gr÷▀e der Komponente an den Text in der Eigenschaft "Caption" angepasst
- wird (wie bei TLabel). Der Text kann dank der "WordWrap"-Eigenschaft auch
- mehrzeilig sein. Auch die Eigenschaft "Transparent" von TSRCheckBox hat
- den gleichen Effekt wie bei TLabel.
-
- A) neue Eigenschaften:
- ----------------------
-
- Alignment: TLeftRight;
- Aurichtung des Textes und der Checkbox:
- - taLeftJustify: Die Checkbox wird links neben dem Text angezeigt.
- - taRightJustify: Die Checkbox wird rechts neben dem Text angezeigt.
-
- AllowGrayed: boolean;
- Nur wenn AllowGrayed=true, kann die Eiegnschaft "State" der CheckBox den Wert
- cbGrayed annehmen.
-
- AutoSize: boolean;
- wie bei TLabel: Die Gr÷▀e des Controls wir dan den Text in der Eigenschaft
- "Caption" angepasst.
-
- CheckSize: integer;
- Die Gr÷▀e (H÷he und Breite) der CheckBox in Pixeln
-
- Grouped: boolean;
- Wenn Grouped=true, verhΣlt sich die CheckBox wie TRadioButton, sonst wie
- TCheckBox.
-
- Layout: TCheckboxLayout;
- Die relative Position der Checkbox zum Text (oben/mitte/unten).
-
- Spacing: integer;
- Der Abstand des Textes zur Checkbox in Pixeln. "-1": automatisch anpassen.
-
- State: TCheckBoxState;
- Der Zustand der CheckBox (cbUnChecked, cbChecked, cbGrayed)
- Der Wert cbGrayed wird nur angenommen, wenn AllowGrayed=true.
-
- Style: TCheckStyle;
- Das Aussehen der Checkbox:
- - csCheckBox: wie TCheckBox
- - csDiamond: Die Checkbox hat die Form einer Raute
- - csPushButton: Die Checkbox sieht aus wie ein TSpeedButton
- - csRadioButton: wie TRadioButton
- - csTrafficLight: Fⁿr die verscheidenen ZustΣnde werden
- Grⁿne, Rote oder Gelbe Kreise gezeichnet
-
- Transparent: boolean;
- wie bei TLabel
-
- WordWrap: boolean;
- wie bei TLabel: der Text wird automatisch umgebrochen, wenn er die Breite
- des Controls ⁿbersteigt.
-
-
-
- B) neue Ereignisse:
- -------------------
-
- 1. "OnChange" - dieses Ereignis wird bei jeder ─nderung des Wertes der
- "State"-Eigenschaft ausgel÷st, auch wenn der Wert dieser
- Eigenschaft per Programmcode geΣndert wird.
- 2. "OnClick" - dieses Ereignis wird (nur dann) ausgel÷st, wenn die Komponente
- angeklickt wird und sich dadurch der Wert der "State"-Eigenschaft
- Σndert. Es wird kein OnClick-Ereignis abgefeuert, wenn die
- Checked-Eigenschaft per Programmcode geΣndert wird.
-
-
- Die anderen Ereignisse entsprechen denen von TCheckBox. Da die TSRCheckBox-Komponente
- von TGraphicControl abgeleitet ist, kann sie keinen Eingabefokus erhalten und hat deswegen
- auch keine OnKey*-Ereignisse.
-
- Die Funktion der Komponente lΣ▀t sich au▀erdem im beigefⁿgten Demo-Programm im Ordner
- "Demo" sehen.
-