Typografická pravidla a pravidla vytváření kódu (Visual Basic)

Článek
03/05/2024

Dokumentace jazyka Visual Basic používá následující typografické a kódové konvence.

Typografické konvence

Příklad	Popis
`Sub`, `If`, `ChDir`, `Print`, , `TrueDebug`	Klíčová slova specifická pro jazyk a členy modulu runtime mají počáteční velká písmena a jsou formátovaná, jak je znázorněno v tomto příkladu.
SmallProject, ButtonCollection	Slova a fráze, které jste dostali pokyn k psaní, jsou formátované, jak je znázorněno v tomto příkladu.
Příkaz Module	Odkazy, na které můžete kliknout, se naformátují na jinou stránku nápovědy, jak je znázorněno v tomto příkladu.
object, variableName, `argumentList`	Zástupné symboly pro informace, které zadáte, jsou formátované, jak je znázorněno v tomto příkladu.
[ Stíny ], [ expressionList ]	V syntaxi jsou volitelné položky uzavřeny v hranatých závorkách.
{ `Public` \| \| `FriendPrivate` }	Pokud v syntaxi musíte vybrat mezi dvěma nebo více položkami, jsou položky uzavřeny do složených závorek a odděleny svislými pruhy. Musíte vybrat jednu položku a pouze jednu z položek.
[ ] `Protected` \| `Friend`	Pokud máte možnost výběru mezi dvěma nebo více položkami, jsou položky uzavřeny v hranatých závorkách a odděleny svislými pruhy. Můžete vybrat libovolnou kombinaci položek nebo žádné položky.
[{ `ByVal` \| `ByRef` }]	Pokud v syntaxi nemůžete vybrat více než jednu položku, ale můžete také úplně vynechat položky, jsou položky uzavřeny do hranatých závorek obklopených složenými závorkami a odděleny svislými pruhy.
memberName 1, memberName2, memberName3	Více instancí stejného zástupného symbolu je odlišeno dolními indexy, jak je znázorněno v příkladu.
memberName1 ... memberNameN	V syntaxi se tři tečky (...) používají k označení neurčeného počtu položek druhu bezprostředně před třemi tečkou. V kódu elipsy označují kód vynechaný kvůli přehlednosti.
ESC, ENTER	Názvy kláves a sekvence kláves na klávesnici se zobrazují ve všech velkých písmenech.
ALT+F1	Když se mezi názvy kláves zobrazí znaménka plus (+), musíte při stisknutí klávesy stisknout jednu klávesu. Alt+F1 například znamená, že stisknete klávesu ALT a stisknete klávesu F1.

Konvence kódu

Příklad	Popis
`sampleString = "Hello, world!"`	Ukázky kódu se zobrazují v písmu s pevnou výškou a jsou formátované, jak je znázorněno v tomto příkladu.
Předchozí příkaz nastaví hodnotu `sampleString` "Hello, world!"	Prvky kódu v vysvětlujícím textu se zobrazují v písmu s pevnou výškou, jak je znázorněno v tomto příkladu.
`' This is a comment.` `REM This is also a comment.`	Komentáře ke kódu se zavádějí pomocí apostrofu (') nebo klíčového slova REM.
`sampleVar = "This is an " _` `& "example" _` `& " of how to continue code."`	Mezera následovaná podtržítkem ( _) na konci řádku označuje, že příkaz pokračuje na následujícím řádku.

Viz také