Graphics Reference
In-Depth Information
-
Wenn ein Ereignis ein Konzept von „davor“ oder „danach“ aufweist, verwen-
den Sie ein Präfix im Präsens oder in der Vergangenheit, wie in
ControlAdd
oder
ControlAdded
.
Verschiedenes
-
Verwenden Sie möglichst wenige Abkürzungen, und verwenden Sie die er-
stellten Abkürzungen konsistent. Eine Abkürzung darf nur eine Bedeutung
haben, und für jedes abgekürzte Wort darf nur eine Abkürzung vorhanden
sein. Wenn Sie z. B.
Minimum
mit
min
abkürzen, müssen Sie durchgängig
so vorgehen und dürfen nicht auch
Minute
mit
min
abkürzen.
-
Schließen Sie beim Benennen von Funktionen eine Beschreibung des zurück-
gegebenen Wertes ein, z. B.
GetCurrentWindowName()
.
-
Namen von Ordnern und Dateien, z. B. Prozedurnamen, sollten genau ihren
Zweck wiedergeben.
-
Vermeiden Sie, den gleichen Namen für verschiedene Elemente zu verwen-
den, z. B. eine Routine mit dem Namen
ProcessStatus()
und eine Va-
riable mit dem Namen
iProcessStatus
.
Codeformat
Die Formatierung verdeutlicht die logische Gliederung des Codes. Wenn Sie
den Quellcode auf einheitliche und logische Weise formatieren, erleichtert dies
Ihnen und anderen Entwicklern die Arbeit beim Aufschlüsseln des Quellcodes.
Im Folgenden werden empfohlene Formatierungsmethoden aufgeführt.
-
Verwenden Sie eine Schriftart mit fester Breite, wenn Sie ausgedruckte Ver-
sionen des Quellcodes veröffentlichen.
-
Legen Sie eine Standardgröße für einen Einzug fest, z. B. 2, höchstens 3 Leer-
zeichen, und verwenden Sie diese durchgängig. Richten Sie Codeabschnitte
mithilfe des vorgeschriebenen Einzugs aus. Wenn Sie mehr Zeichen einzie-
hen, läuft der Code bei stark strukturierten Programmen schnell aus dem
rechten Bildfenster und auch die gedruckte Dokumentation hat Platzproble-
me. Wenn Sie sich für ein Format entschieden haben, verwenden Sie dieses
in allen Modulen. Ohne Einzüge wird Code schwer verständlich, z. B.:
If ... Then
IF ... Then
...
Else
...
End If
Else
...
End If
Wenn Sie Code mit Einzügen versehen, ist er leichter lesbar, z. B.:
If ... Then
If ... Then
...
Else
...
