Delphi - Üzenet dialóg, formázott szöveggel

Egy formázott szöveg megjelenítését a Dialogs unit, ShowMessageFmt eljárásával tehetjük meg.

ShowMessageFmt

procedure ShowMessageFmt(

const Msg: string;
Params: array of const

);

Megjelenít egy üzenetablakot, amely egy OK gombot tartalmaz. Az ablak fejlécében az alkalmazás exe állományának neve jelenik meg. Az ablak szövegét a C nyelvhez hasonló módon formázhatjuk.

Paraméterek

const Msg: string

A megjelenítendő szöveg, amely tartalmazhatja a formázáshoz szükséges utasítást is.

Params: array of const

A formázó utasításokhoz tartozó értékek. A tömb elemeit a [] karakterek között kell megadnunk, az egyes elemek elválasztásához a „,” karaktert használhatjuk.

A formázásban használható utasítások általános szintaktikája a következő:

"%" [index ":"] ["-"] [width] ["." prec] type

A formázási karakter (utasítás) előtt mindig a % karakter szerepel.
Az index tag, a Params tömb megadott sorszámú elemét jelöli ki.
A – jel a bal oldali elrendezést jelzi.
A width tag szélesség megadását teszi lehetővé.
A prec tag a pontosságot határozza meg.
A type tagban kell megadnunk a formázás típusát kijelölő karaktert.

A formázás típusát kijelölő karakterek.

Parancs	Hatása
d	Decimális szám. Ha az utasítás megadása során használjuk a prec tagot, akkor azon keresztül megadhatjuk, hogy a szövegnek kötelezően hány számjegyet kell tartalmaznia. Ha az kevesebb számjegyből áll, akkor automatikusan kiegészítésre kerül, bal oldali nullákkal.
u	Hatása ugyanaz, mint a d karakteré, de nem használhat előjelet.
e	Tudományos formátumú szám. A számokat "-d.ddd...E+ddd" alakban jeleníti meg. A formázáshoz bármilyen valós számot megadhatunk. A prec tagban itt is azt állíthatjuk be, hogy a megjelenő szám hány darab számjegyből állhat. Ebbe beleszámít a tizedesvessző előtti számjegy is. A prec alapértelmezett értéke 15.
f	Valós szám. A számokat "-ddd.ddd..." alakban jeleníti meg. A prec tag értéke határozza meg, hogy a tizedesvessző után hány karakter szerepeljen. Ez az érték alapértelmezés szerint 2.
g	Általános számformátum. A formázandó szövegnek valós típusú számot kell tartalmaznia, amelyben a tizedesvessző is szerepel. A formázás során a számítógép megpróbálja az adott számot a legmegfelelőbb számformátumhoz igazítani. Automatikusan eltávolításra kerülnek a bal oldali nullák, valamint a tizedes rész is csak akkor kerül megjelenítésre, ha az nem nulla.
n	Szám. Ez a formázási lehetőség az adott számot elválasztott ezres helyiértékekkel jeleníti meg. Az ezres elválasztó karaktert az operációs rendszer beállításai határozzák meg.
m	Pénz. A megadott számot úgy jeleníti meg, mint az n parancs, továbbá a végére elhelyezi az operációs rendszerben beállított pénznemet.
p	Mutató. A megadott érték 8 karakteren megjeleníthető hexadecimális számként kerül megjelenítésre.
s	Sztring. A megjelenítendő szöveg Char, Sztring, vagy PChar típusú lehet. A prec tagban a megjelenítendő sztring maximális karakterszámát állíthatjuk be. Ha az adott szöveg hosszabb ennél, akkor a maradék karakterek levágásra kerülnek.
x	Hexadecimális szám. A megadott szövegnek egy egész számot kell tartalmazni. Ez a szám hexadecimális formában kerül megjelenítésre. A prec tagban állíthatjuk be, hogy a megadott számnak minimum hány számjegyet kell tartalmaznia. Ha ennél az értéknél kevesebbet tartalmaz, akkor a baloldalról nullákkal kerül feltöltésre.

Ha a megadott formázási beállítás paraméterei nem megfelelőek, a Delphi hibaüzenetet ad. Ezen egy try-except blokk segíthet.

A width és a prec tagokban használhatjuk a * karaktert is.