Komponenta DataEdit


Přehled vlastností, metod a událostí objektu:
--------------------------------------------------------------
AutoSelect (RW)      AutoSize (RW)        BorderStyle (RW)
CharCase (RW)        Color (RW)           Ctl3D (RW)
Cursor (RW)          DataField (RW)       DataSource (RW)
Enabled (RW)         Font (RW)            Height (RW)
HelpContext (RW)     Hint (RW)            Left (RW)
MaxLength (RW)       Modified (*RW)       Name (R)
ParentColor (RW)     ParentCtl3D (RW)     ParentFont (RW)
ParentShowHint (RW)  PasswordChar (RW)    PopupMenu (RW)
ReadOnly (RW)        SelLength (*RW)      SelStart (*RW)
SelText (*RW)        ShowHint (RW)        TabOrder (RW)
TabStop (RW)         Tag (RW)             Text (*RW)
Top (RW)             Visible (RW)         Width (RW)
--------------------------------------------------------------
Clear                ClearSelection       CopyToClipboard
CutToClipboard       PasteFromClipboard   SetFocus
--------------------------------------------------------------
OnChange             OnClick              OnDblClick
OnEnter              OnExit               OnKeyDown
OnKeyPress           OnKeyUp              OnMouseDown
OnMouseMove          OnMouseUp            
--------------------------------------------------------------
Legenda: * -> pouze z programu, R -> lze číst, W -> lze zadat

Komponenta DataEdit se používá pro zápis jednořádkového textu umístěného v databázi. Při nastavení vlastnosti ReadOnly ji lze také použít pro zobrazení textu bez možnosti editace. Pro zobrazení textu položky databáze bez možnosti editace lze použít také komponentu DataText.

Nejdůležitější vlastností je DataSource, ve které se udává zdroj připojených dat. Položku databáze zadáváte ve vlastnosti DataField.

Editovaný text je uložen ve vlastnosti Text. Délka editovaného textu se zadává ve vlastnosti MaxLength. Pokud uvedete větší hodnotu, než je délka editované položky v databázi, bude do databáze uložen pouze text o délce odpovídající definici struktury databáze.

Pokud bude text editován uživatelsky z klávesnice, je změna zaznamenána automaticky do databáze při změně pozice v databázi nebo na příkaz uživatele kliknutím na příslušné tlačítko objektu DataNavigator. Při změně textu z programu musíte použít nejprve metodu Edit pro přepnutí do editačního módu, následně změnit text a nakonec uložit provedené změny metodou Post:


Jazyk KLONDAIK: DataTable.Edit; DataEdit.Text := 'abcd'; DataTable.Post;


Jazyk BONANZA: DataTable.Edit DataEdit.Text = "abcd" DataTable.Post

Druh orámování textu zadává vlastnost BorderStyle, barvu podkladu zadáte ve vlastnosti Color. Můžete také změnit Font. Pokud požadujete možnost přístupu k editovanému textu na formuláři pomocí rychlé Alt klávesy, umístěte nad editovaný text komponentu Label s nastavením vlastnosti FocusControl, ve které zadáte objekt s editovaným textem.

Pro automatický převod na velká nebo malá písmena je možné použít vlastnost CharCase. Pokud má sloužit editovaný text jako heslo, lze změnou vlastnosti PasswordChar zadat znak, který se zobrazuje v editovaném textu místo zadávaných znaků.

Editovaný text lze přenášet přes schránku Windows do jiného textu. Buď uživatelsky z klávesnice, nebo z programu. Vybraný text lze označit pomocí vlastností SelStart, SelLength a SelText. Celý text lze označit metodou SelectAll, pro výmaz označené části textu se použije ClearSelection. Přenos textu mezi schránkou a objektem zajišťují metody CopyToClipboard, CutToClipboard, PasteFromClipboard.

Komponenta obsahuje mimo běžných událostí i událost OnChange, která nastane v okamžiku změny textu. Ta může nastat ve dvou případech. Buď je uživatelem změněn text z klávesnice, avšak také v případě změny textu při přechodu na nový záznam databáze. Pokud proto potřebuje ošetřit uživatelskou změnu z klávesnice, použijte událost OnKeyPress.


OZOGAN, 1 Máje 97, 460 01 Liberec
tel.,fax: (048) 52 28 338, e-mail: info@ozogan.cz