BorderStyle
Osztály: TCustomGrid
property BorderStyle: TBorderStyle;
A keret stílusa. Az alábbi értékek egyike lehet:
- bsNone: nincs keret;
- bsSingle: süllyesztett 3D-s keret.
Col
Osztály: TCustomGrid
property Col: Longint;
Az aktív cella oszlopának sorszáma. Az első oszlop sorszáma 0.
ColCount
Osztály: TCustomGrid
property ColCount: Longint;
Az oszlopok száma.
ColWidths
Osztály: TCustomGrid
property ColWidths[Index: Longint]: Integer;
Egy tömb property, amelyen keresztül lekérdezhető, illetve beállítható az oszlopok szélessége. Az Index az oszlop sorszáma. Csak futási időben lehetséges a beállítása.
DefaultColWidth
Osztály: TCustomGrid
property DefaultColWidth: Integer;
Az alapértelmezett oszlopszélesség. Szerkesztési időben minden oszlop szélessége az ebben a property-ben megadott érték.
DefaultDrawing
Osztály: TCustomGrid
property DefaultDrawing: Boolean;
Ha a property értéke igaz, akkor a cellák megrajzolása megtörténik, ellenkező esetben a teljes megjelenítésről nekünk kell gondoskodni az OnDrawCell eseményben.
DefaultRowHeight
Osztály: TCustomGrid
property DefaultRowHeight: Integer;
Az alapértelmezett sor magasság. Szerkesztési időben minden sor ilyen magas, ennek megváltoztatására csak futási időben van lehetőség (lásd RowHeights property).
Megjegyzés
EditorMode
Osztály: TCustomGrid
property EditorMode: Boolean;
Ha a property értéke igaz, akkor a cellaszerkesztő aktív. A cellaszerkesztő akkor lehet aktív, ha az Options property-ben a goEditing érték be van állítva. Futási időben a felhasználó az F2, vagy Enter billentyűkkel aktivizálhatja.
FixedColor
Osztály: TCustomGrid
property FixedColor: TColor;
A fixed (rögzített) oszlopok és sorok celláinak színe. A rögzített oszlopok és sorok cellái nem szerkeszthetők, és nem jelölhetők ki.
FixedCols
Osztály: TCustomGrid
property FixedCols: Integer;
A rögzített oszlopok száma. Ha az értéke 0, akkor nincs rögzített oszlop.
FixedRows
Osztály: TCustomGrid
property FixedRows: Integer;
A rögzített sorok száma.
GridHeight
Osztály: TCustomGrid
property GridHeight: Integer;
A property megadja a rács magasságát pixelben. Ez nem egyezik meg a komponens magasságával, annál lehet kisebb és nagyobb is.
GridLineWidth
Osztály: TCustomGrid
property GridLineWidth: Integer;
A rácsvonalak vastagsága pixelben.
GridWidth
Osztály: TCustomGrid
property GridWidth: Integer;
A rács szélessége pixelben. Ez nem egyezik meg a komponens szélességével, annál lehet kisebb és nagyobb is.
HitTest
Osztály: TCustomGrid
property HitTest: TPoint;
A property-ből kiolvasható az egérkurzor pozíciója. A pozíciót egy TPoint struktúrában kapjuk meg, melynek X és Y mezője tartalmazza a koordinátákat.
InplaceEditor
Osztály: TCustomGrid
property InplaceEditor: TInplaceEdit;
A táblázat beépített szerkesztőjének objektumát adja vissza. Ez TInplaceEdit típusú, amely osztály a TCustomMaskEdit osztályból származik.
LeftCol
Osztály: TCustomGrid
property LeftCol: Longint;
Az első látható oszlop sorszáma.
Options
Osztály: TCustomGrid
property Options: TGridOptions;
Ebben a property-ben a táblázat tulajdonságait adhatjuk meg. Az alábbi értékeket állíthatjuk be:
- goFixedVertLine: rögzített celláknál a függőleges rácsvonalak megjelenítése;
- goFixedHorzLine: rögzített celláknál a vízszintes rácsvonalak megjelenítése;
- goVertLine: függőleges rácsvonalak megjelenítése;
- goHorzLine: vízszintes rácsvonalak megjelenítése;
- goRangeSelect: ha ez az érték meg van adva, akkor a felhasználó egyszerre több cellát is kijelölhet. Ha a goEditing érték is meg van adva, akkor ez a beállítás figyelmen kívül marad;
- goDrawFocusSelected: az aktív cellát ki is jelöli;
- goRowSizing: engedélyezi a sorok átméretezését;
- goColSizing: engedélyezi az oszlopok átméretezését;
- goRowMoving: engedélyezi a sorok mozgatását;
- goColMoving: engedélyezi az oszlopok mozgatását;
- goEditing: ha ez az érték meg van adva, akkor a cellák szerkeszthetők;
- goTabs: ha meg van adva, akkor a cellák között a Tab és Shift+Tab gombokkal is lehet mozogni;
- goRowSelect: ha meg van adva, akkor mindig egy egész sor lesz kijelölve, és a goAlwaysShowEditor érték figyelmen kívül marad.
- goAlwaysShowEditor: a cellaszerkesztő mindig aktív;
- goThumbTracking: ha meg van adva, akkor a görgetés közben is folyamatosan frissül a táblázat képe. Ellenkező esetben ez csak akkor következik be, amikor a felhasználó befejezte a görgetést.
Row
Osztály: TCustomGrid
property Row: Longint;
A kijelölt cella sorának sorszáma.
RowCount
Osztály: TCustomGrid
property RowCount: Longint;
A táblázat sorainak száma.
RowHeights
Osztály: TCustomGrid
property RowHeights[Index: Longint]: Integer;
Tömb property, amelynek elemei a sorok magasságait tartalmazzák. Az Index a sor sorszáma.
ScrollBars
Osztály: TCustomGrid
property ScrollBars: TScrollStyle;
A görgetősávok beállítására szolgáló property, melynek értékei az alábbiak lehetnek:
- ssNone: nincs görgetősáv;
- ssHorizontal: csak a vízszintes görgetősáv jelenik meg;
- ssVertical: csak a függőleges görgetősáv jelenik meg;
- ssBoth: mindkét görgetősáv megjelenik.
Selection
Osztály: TCustomGrid
property Selection: TGridRect;
Megadja a kijelölt cellákat. A property TGridRect típusú, amely két TGridCoord típusú mezőt tartalmaz. A TGridCoord típusú struktúrának egy X és egy Y mezője van, amelyekben az oszlop és a sor sorszáma található.
TabStops
Osztály: TCustomGrid
property TabStops[Index: Longint]: Boolean;
Egy tömb property, melyben minden oszlophoz egy logikai property tartozik. A logikai property értéke meghatározza, hogy a felhasználó a Tab billentyűvel rápozícionálhat-e az adott oszlopban (Index) lévő cellára.
TopRow
Osztály: TCustomGrid
property TopRow: Longint;
Az első látható sor sorszáma.
VisibleColCount
Osztály: TCustomGrid
property VisibleColCount: Integer;
A látható oszlopok száma.
AdjustSize
Osztály: TCustomGrid
procedure AdjustSize(Index, Amount: Longint; Rows: Boolean);
Több sor vagy oszlop beillesztését vagy törlését tudjuk ezzel az eljárással egy lépésben elvégezni.
Paraméterek
Index: Longint;
Az oszlop vagy a sor sorszáma, amelytől a törlés történik.
Amount: Longint;
A beszúrandó vagy törlendő oszlopok vagy sorok száma. Ha a paraméter értéke nagyobb, mint 0, akkor beszúrás, ha kisebb, akkor törlés történik.
Rows: Boolean
Ha a paraméter értéke igaz, akkor sorok, ellenkező esetben oszlopok beszúrása, vagy törlése történik.
BeginColumnDrag
Osztály: TCustomGrid
function BeginColumnDrag(
var Origin: Integer;
Destination: Integer;
const MousePt: TPoint
): Boolean;
Az eljárás automatikusan meghívódik, amikor a felhasználó valamelyik oszlopot elkezdi mozgatni. A TCustomGrid osztályból származtatott komponenseknél használható fel.
Paraméterek
Origin: Integer
A mozgatandó oszlop sorszáma, vagyis az, amelyre a felhasználó kattintott.
Destination: Integer
Annak az oszlopnak a sorszáma, amelynek helyére az Origin paraméterben megadott oszlopot mozgatni kell. Ez a TCustomGrid osztályban megegyezik az Origin paraméter értékével, de a származtatott osztályokban megadhatunk egy alapértelmezett pozíciót.
const MousePt: TPoint
Az egér koordinátáit tartalmazó paraméter (a kattintás pillanatában).
BeginRowDrag
Osztály: TCustomGrid
function BeginRowDrag(
var Origin,
Destination: Integer;
const MousePt: TPoint
): Boolean;
Egy sor mozgatásának kezdetekor fut le ez az eljárás.
Paraméterek
var Origin
A mozgatandó sor sorszáma.
Destination: Integer
A cél pozíció, amely a TCustomGrid osztályban megegyezik az Origin értékével, de a származtatott osztályokban megadhatunk egy alapértelmezett pozíciót is.
const MousePt: TPoint
Ez egér koordinátáit tartalmazó paraméter (a kattintás pillanatában).
BoxRect
Osztály: TCustomGrid
function BoxRect(
ALeft,
ATop,
ARight,
ABottom: Longint
): TRect;
A függvénnyel lekérdezhető a megadott cella tartomány képernyő koordinátája.
Paraméterek
ALeft
A bal szélső oszlop sorszáma.
ATop
A felső sor sorszáma.
ARight
A jobb szélső oszlop sorszáma.
ABottom: Longint
Az alsó sor sorszáma.
Visszatérési érték
Egy TRect típusú struktúrában megkapjuk a koordinátákat.
CalcDrawInfo
Osztály: TCustomGrid
procedure CalcDrawInfo(
var DrawInfo: TGridDrawInfo
);
A rács megrajzolásához szükséges információkat kérdezhetjük le ezzel az eljárással egy TGridDrawInfo struktúrában. Ez a struktúra két TGridAxisDrawInfo struktúrát tartalmaz, egyet a vízszintes (Horz) és egyet a függőleges tengelyhez.
Paraméterek
DrawInfo: TGridDrawInfo
Ebben a struktúrában kapjuk meg az adatokat.
CalcFixedInfo
Osztály: TCustomGrid
procedure CalcFixedInfo(
var DrawInfo: TGridDrawInfo
);
A rögzített cellák pozícióját kérdezhetjük le az eljárással egy TGridDrawInfo struktúrába.
Paraméterek
var DrawInfo: TGridDrawInfo
Ebbe a struktúrába kérdezzük le az adatokat.
CalcSizingState
Osztály: TCustomGrid
procedure CalcSizingState(
X,
Y: Integer;
var State: TGridState;
var Index: Longint;
var SizingPos,
SizingOfs: Integer;
var FixedInfo: TGridDrawInfo
);
Az eljárás segítségével lekérdezhetjük, hogy az egérkurzort meg kell-e változtatni (átméretezésnél és oszlop elmozgatásnál).
Paraméterek
X: Integer
Az egér X koordinátája.
Y: Integer
Az egér Y koordinátája.
var State: TGridState
A rács állapotát adja meg. Értékei a következők lehetnek:
- gsNormal: normál állapot, nincs változtatás;
- gsSelecting: a felhasználó kijelöl egy cellát vagy sort;
- gsRowSizing: sor átméretezése;
- gsColSizing: oszlop átméretezése;
- gsRowMoving: sor elmozgatása;
- gsColMoving: oszlop elmozgatása.
CanEditAcceptKey
Osztály: TCustomGrid
function CanEditAcceptKey(
Key: Char
): Boolean;
A függvény segítségével megadhatjuk, hogy a paraméterként megadott karakter megadható-e az adott cellában.
Paraméterek
Key: Char
A karakter kódja.
Visszatérési érték
A függvény visszatérési értéke igaz, ha a karakter megadható, és hamis, ha nem.
CanEditModify
Osztály: TCustomGrid
function CanEditModify: Boolean;
Megadja, hogy az aktuális cella szerkeszthető-e.
Visszatérési érték
A függvény visszatérési értéke igaz, ha a cella szerkeszthető, és hamis, ha nem.
CanEditShow
Osztály: TCustomGrid
function CanEditShow: Boolean;
A függvény megadja, hogy a beépített szerkesztőt létre lehet-e hozni, a cella szerkeszthető-e.
Visszatérési érték
A visszatérési érték igaz, ha a szerkesztő létrehozható, és hamis, ha nem.
CanGridAcceptKey
Osztály: TCustomGrid
function CanGridAcceptKey(
Key: Word;
Shift: TShiftState
): Boolean;
A függvény megadja, hogy a paraméterként átadott billentyű kombinációra a komponens reagál-e, vagy más szóval a billentyűkombinációnak van-e speciális funkciója. A TCustomGrid osztály leszármazottjaiban használhatjuk fel.
Paraméterek
Key: Word
A billentyű kódja.
Shift: TShiftState
Az emelőbillentyűk állapota. Értékei az alábbiak lehetnek:
- ssShift: a Shift billentyű le van nyomva;
- ssAlt: az Alt billentyű le van nyomva;
- ssCtrl: a Ctrl billentyű le van nyomva;
- ssLeft: a bal egérgomb le van nyomva;
- ssRight: a jobb egérgomb le van nyomva;
- ssMiddle: mindkét egérgomb le van nyomva;
- ssDouble: az egérrel dupla kattintás történt.
Visszatérési érték
A TCustomGrid osztályban a visszatérési értéke mindig igaz.
CellRect
Osztály: TCustomGrid
function CellRect(
ACol,
ARow: Longint
): TRect;
A cella koordinátáit kérdezhetjük le ezzel a függvénnyel.
Paraméterek
ACol
Az oszlop sorszáma.
ARow: Longint
A sor sorszáma.
Visszatérési érték
Egy TRect típusú struktúra, amiben a cella koordinátáit kapjuk meg.
ChangeGridOrientation
Osztály: TCustomGrid
procedure ChangeGridOrientation(
RightToLeftOrientation: Boolean
);
A rács elrendezését változtathatjuk meg ezzel az eljárással.
Paraméterek
RightToLeftOrientation: Boolean
Ha a paraméter értéke igaz, akkor az elrendezés jobbról-balra történik, ellenkező esetben pedig balról-jobbra (ez az alapértelmezett).
CheckColumnDrag
Osztály: TCustomGrid
function CheckColumnDrag(
var Origin,
Destination: Integer;
const MousePt: TPoint
): Boolean;
A függvény visszatérési értéke megmondja, hogy az éppen mozgatott oszlop az aktuális pozícióba helyezhető-e.
Paraméterek
var Origin: : Integer;
Az oszlop eredeti sorszáma.
Destination: Integer;
Az aktuális (mozgatás közbeni) pozíció.
const MousePt: TPoint
Az egér koordinátái.
Visszatérési érték
A függvény visszatérési értéke igaz, ha az oszlop az adott pozícióba helyezhető, és hamis, ha nem.
CheckRowDrag
Osztály: TCustomGrid
function CheckRowDrag(
var Origin,
Destination: Integer;
const MousePt: TPoint
): Boolean;
A függvény megadja, hogy a mozgatott sor az adott pozícióba helyezhető-e, vagy sem.
Paraméterek
var Origin
A sor eredeti pozíciója.
Destination: Integer
Az aktuális pozíció.
const MousePt: TPoint
Az egér koordinátáit tartalmazó TPoint típusú struktúra.
Visszatérési érték
A függvény visszatérési értéke igaz, ha a sor az adott pozícióba helyezhető, és hamis, ha nem.
ColumnMoved
Osztály: TCustomGrid
procedure ColumnMoved(
FromIndex,
ToIndex: Longint
);
Az eljárás akkor fut le, amikor az oszlop áthelyezése befejeződött.
Paraméterek
FromIndex
Ebben a paraméterben megkapjuk, hogy melyik pozícióból lett az oszlop elmozgatva.
ToIndex: Longint
Az oszlop új pozíciójának száma.
ColWidthsChanged
Osztály: TCustomGrid
procedure ColWidthsChanged;
Az oszlopok szélességének megváltoztatása után fut le ez az eljárás.
CreateEditor
Osztály: TCustomGrid
function CreateEditor: TInplaceEdit;
Ez a függvény hozza létre a belső szerkesztő objektumát. A TCustomGrid osztályból származtatott osztályokban felülírhatjuk ezt a függvényt, és saját szerkesztőt hozhatunk létre a TInplaceEdit osztályból származtatva.
Visszatérési érték
A szerkesztő objektuma.
DefineProperties
Osztály: TCustomGrid
procedure DefineProperties(
Filer: TFiler
);
Az eljárás elmenti a ColWidths és ColHeights property-kben tárolt értékeket, kivéve, ha azok a DefColWidth illetve DefRowHeight értékeket tartalmazzák.
DeleteColumn
Osztály: TCustomGrid
procedure DeleteColumn(
ACol: Longint
);
Egy oszlopot törölhetünk ezzel az eljárással.
Paraméterek
ACol: Longint
Az oszlop sorszáma.
DeleteRow
Osztály: TCustomGrid
procedure DeleteRow(
ARow: Longint
)
Egy sort törölhetünk ezzel az eljárással.
Paraméterek
ARow: Longint
A sor sorszáma.
DoExit
Osztály: TCustomGrid
procedure DoExit;
Ez az eljárás az ős osztályokban generál egy OnExit eseményt. A TCustomGrid osztályban is megmarad ez a funkciója, de közben elrejti a belső szerkesztőt is, kivéve, ha a goAlwaysShowEditor érték meg van adva az Options property-ben.
DrawCell
Osztály: TCustomGrid
procedure DrawCell(
ACol,
ARow: Longint;
ARect: TRect;
AState: TGridDrawState
);
Ez egy absztrakt metódus, amely a származtatott osztályokban megrajzolja a paraméterként megadott cellát.
Paraméterek
ACol: Longint
A cella oszlopának sorszáma.
ARow: Longint
A cella sorának sorszáma.
ARect: TRect
A cella koordinátái tartalmazó TRect struktúra.
AState: TGridDrawState
A cella állapotát tartalmazó paraméter, melynek értékei az alábbiak lehetnek:
- gdSelected: a cella ki van jelölve;
- gdFocused: a cella az aktív cella;
- gdFixed: a cella egy rögzített oszlopban vagy sorban van.
EndColumnDrag
Osztály: TCustomGrid
function EndColumnDrag(
var Origin,
Destination: Integer;
const MousePt: TPoint
): Boolean;
A függvény befejezi az oszlop áthelyezést. A TCustomgrid osztályból származtatott osztályoknál használhatjuk fel az oszlop áthelyezés művelet szabályozására.
Paraméterek
var Origin
Az oszlop eredeti pozíciója.
Destination: Integer
Az oszlop új pozíciója.
const MousePt: TPoint
Az egér koordinátái.
Visszatérési érték
A függvény visszatérési értéke mindig igaz.
EndRowDrag
Osztály: TCustomGrid
function EndRowDrag(
var Origin,
Destination: Integer;
const MousePt: TPoint
): Boolean;
Befejezi a sor áthelyezést.
Paraméterek
var Origin
A sor eredeti pozíciója.
Destination: Integer
A sor új pozíciója.
const MousePt: TPoint
Az egér koordinátái.
Visszatérési érték
A visszatérési érték mindig igaz.
FocusCell
Osztály: TCustomGrid
procedure FocusCell(
ACol,
ARow: Longint;
MoveAnchor: Boolean
);
Az eljárás akkor kerül meghívásra, amikor az aktív cella kiválasztásra kerül.
Paraméterek
ACol: Longint
A cella oszlopának sorszáma.
ARow: Longint
A cella sorának sorszáma.
MoveAnchor: Boolean
Ha engedélyezve van a több cella együttes kijelölése (az Options property-ben a goRangeSelect be van állítva), akkor ez a paraméter megmondja, hogy a cella az új kijelölés kezdő cellája, vagy a kijelölés eddig a celláig tart.
GetEditLimit
Osztály: TCustomGrid
function GetEditLimit: Integer;
A belső szerkesztő hívja meg ezt a függvényt, melynek segítségével megadhatjuk a maximálisan megadható karakterek számát.
Visszatérési érték
Az adott cellában megadható érték maximális hossza karakterekben.
GetEditMask
Osztály: TCustomGrid
function GetEditMask(
ACol,
ARow: Longint
): String;
A függvény megadja az adott cellában alkalmazott adatbeviteli maszkot.
Paraméterek
ACol: Longint
Az oszlop sorszáma.
ARow: Longint
A sor sorszáma.
Visszatérési érték
A visszatérési érték az adatbeviteli maszk. A maszkot ugyanúgy kell megadni, mint a MaskEdit komponensnél.
GetEditStyle
Osztály: TCustomGrid
function GetEditStyle(
ACol,
ARow: Longint
): TEditStyle;
Megadja, hogy az adott cellában milyen adatbeviteli módot kell használni.
Paraméterek
ACol: Longint
Az oszlop sorszáma.
ARow: Longint
A sor sorszáma.
Visszatérési érték
A visszatérési értéke az alábbiak egyike lehet:
esSimple: egyszerű adatbevitel. A TCustomGrid osztályban a függvény visszatérési értéke mindig ez lesz.
esEllipsis: gomb;
esPickList: legördülő lista.
GetEditText
Osztály: TCustomGrid
function GetEditText(
ACol,
ARow: Longint
): String;
Ez a függvény adja meg a belső szerkesztő számára, hogy milyen szöveget kell szerkeszteni.
Paraméterek
ACol: Longint
Az oszlop sorszáma.
ARow: Longint
A sor sorszáma.
Visszatérési érték
A cella tartalma, melyet szerkeszteni kell.
GetGridHeight
Osztály: TCustomGrid
function GetGridHeight: Integer;
Ez a függvény szolgáltatja a GridHeight property értékét.
Visszatérési érték
A rács magassága pixelben.
GetGridWidth
Osztály: TCustomGrid
function GetGridWidth: Integer;
Ez a függvény adja meg a GridHeight property értékét.
Visszatérési érték
A rács szélessége pixelben.
HideEdit;
Osztály: TCustomGrid
procedure HideEdit;
Elrejti a belső szerkesztőt.