Vrátí hodnotu typu String, která poskytuje informace o proměnné (Proměnná: Pojmenované umístění pro ukládání, které může obsahovat data, jež lze během doby spuštění programu změnit. Každá proměnná má název, jež ji v dané úrovni oboru jednoznačně identifikuje. Typ dat může, ale nemusí být zadán.).
Syntaxe
TypeName(název_proměnné)
Povinný argument (Argument: Hodnota, která poskytuje informace určité akci, události, metodě, vlastnosti, funkci nebo proceduře.) název_proměnné je hodnota typu Variant (Typ dat Variant: Výchozí typ dat pro proměnné, které neobsahují znaky deklarace typu, není-li aktivní příkaz Deftyp. V proměnné typu Variant mohou být uložena čísla, řetězce, datum a čas nebo hodnoty Null či Empty.), která obsahuje název libovolné proměnné s výjimkou proměnné uživatelem definovaného typu (Uživatelský typ: Libovolný datový typ v jazyce VBA definovaný pomocí příkazu Type. Uživatelské typy mohou obsahovat jeden nebo více prvků libovolných datových typů. K vytváření polí uživatelských i jiných datových typů slouží příkaz Dim.).
Poznámky
Funkce TypeName vrátí jeden z následujících řetězců:
| Vrácený řetězec |
Proměnná |
| Typ objektu (Typ objektu: Typ objektu, který dává aplikace k dispozici prostřednictvím rozhraní automatizace, například Application, File, Range a Sheet. Úplný seznam dostupných objektů naleznete v prohlížeči objektů nebo v dokumentaci k aplikaci.) |
Objekt typu objecttype |
| Byte (Typ dat Byte: Typ dat databáze aplikace Access používaný k ukládání malých kladných celých čísel v rozsahu od 0 do 255.) |
Hodnota typu Byte |
| Celé číslo (Typ dat Integer: Základní typ dat zahrnující celá čísla. Proměnná Integer je uložena jako 16bitové (2bajtové) číslo s hodnotou v rozsahu od -32,768 do 32,767.). |
Celé číslo |
| Long (Typ dat Long: Základní typ dat pro ukládání velkých celých čísel. Proměnná typu Long je uložena jako 32bitové číslo v rozmezí od -2 147 483 648 do 2 147 483 647.). |
Dlouhé celé číslo |
| Jednoduchá přesnost (Typ dat Single: Typ dat ukládající proměnné s plovoucí desetinnou čárkou a jednoduchou přesností jako 32bitová (4bajtová) čísla s plovoucí desetinnou čárkou v rozmezí hodnot od -3,402823E38 do -1,401298E-45 pro záporné hodnoty a od 1,401298E-45 do 3,402823E38 pro kladné hodnoty.)
|
Číslo s jednoduchou přesností a plovoucí desetinnou čárkou |
| Double (Typ dat Double: Základní typ dat pro ukládání čísel s plovoucí desetinnou čárkou a dvojitou přesností. Je ukládán jako 64bitové číslo a může nabývat hodnot v rozmezí přibližně -1,797E308 až -4,940E-324 (záporné) a 4,94E-324 až 1,797E308 (kladné) nebo hodnoty 0.) |
Číslo s dvojitou přesností a plovoucí desetinnou čárkou |
| Měna (Typ dat Currency: Typ dat v databázi aplikace Microsoft Access, který je vhodný pro výpočty s měnovými jednotkami nebo pro výpočty s pevnou desetinnou čárkou, u kterých je mimořádně důležitá přesnost.), |
Hodnota měny |
| Desetinné číslo (Typ dat decimal (databáze aplikace Access): Přesný číselný typ dat, který může obsahovat hodnoty v rozsahu od -10^28 - 1 do 10^28 - 1. Můžete zadat měřítko (maximální celkový počet číslic) a přesnost (maximální počet číslic vpravo od desetinné čárky).) |
Desítkově vyjádřená hodnota |
| Datum (Typ dat Date/Time: Typ dat databáze aplikace Access používaný k ukládání informací o datu a času.) |
Hodnota data |
| Řetězec (Typ dat String: Základní typ dat pro ukládání znaků, přičemž pro každý znak jsou vyhrazeny 2 bajty. Řetězec s pevnou délkou může obsahovat 1 až 64 000 znaků, řetězce s proměnlivou délkou 1 až 2 miliardy znaků.) |
Řetězec |
|
Logická hodnota (Logická hodnota: Výraz, který lze vyhodnotit jako pravda (není nula) nebo nepravda (0). Pomocí klíčových slov True a False můžete zadat hodnoty -1 a 0. Typ dat pole Ano/Ne je typu Logická hodnota a obsahuje hodnotu -1 pro hodnotu Ano.) |
Logická hodnota |
| Error |
Chybová hodnota |
| Prázdná (Stav Empty: Stav neinicializované proměnné Variant (jako hodnotu atributu VarType vrací nulu). Nelze jej zaměňovat se stavem Null (stav proměnné označující neplatná data), s proměnnými obsahujícími řetězce s nulovou délkou ("") ani s číselnými proměnnými s hodnotou nula.) |
Neinicializovaná proměnná |
| NULL (Hodnota Null: Hodnota, kterou můžete zadat do pole nebo ji použit ve výrazech a dotazech a označit tak chybějící nebo neznámá data. V jazyce Visual Basic označuje klíčové slovo Null hodnotu Null. Některá pole, například pole primárního klíče, nemohou obsahovat hodnoty Null.)
|
Neplatná data |
| Objekt (Objekt: Tabulka, graf, grafika, rovnice nebo jiná forma informací. Objekty vytvořené v jedné aplikaci, např. tabulky, a propojené s jinou aplikací nebo vložené do jiné aplikace se nazývají objekty OLE.) |
Objekt |
| Unknown |
Objekt neznámého typu |
| Nothing |
Objektová proměnná, která neodkazuje na objekt |
Je-li argumentem název_proměnné pole (Pole: Proměnná obsahující konečný počet prvků, které mají společný název a typ dat. Každý prvek v poli je označen jedinečným indexem. Změny provedené u jednoho prvku v poli nemají na ostatní prvky žádný vliv.), může být vrácen jakýkoli přípustný řetězec (neboli hodnota typu Variant) s přidanými prázdnými závorkami. Pokud je například argumentem název_proměnné pole celých čísel, bude funkcí TypeName vrácen řetězec Integer().
Příklad
Poznámka: Následující příklady uvádějí použití této funkce v modulu jazyka Visual Basic for Applications (VBA). Další informace o práci s jazykem VBA získáte tak, že klepnete na položku Referenční informace pro vývojáře v rozevíracím seznamu vedle pole Hledat a do pole pro hledání zadáte jeden nebo více pojmů.
V tomto příkladu pomocí funkce TypeName získáte informace o proměnné.
Dim NullVar, MyType, StrVar As String
Dim IntVar As Integer, CurVar As Currency
Dim ArrayVar (1 To 5) As Integer
NullVar = Null ' Assign Null value.
MyType = TypeName(StrVar) ' Returns "String".
MyType = TypeName(IntVar) ' Returns "Integer".
MyType = TypeName(CurVar) ' Returns "Currency".
MyType = TypeName(NullVar) ' Returns "Null".
MyType = TypeName(ArrayVar) ' Returns "Integer()".