APIs - Versionsgeschichte

Pwania am 28. Januar 2023 um 00:29 Uhr

2023-01-28T00:29:37Z

← Nächstältere Version		Version vom 28. Januar 2023, 00:29 Uhr
Zeile 1:		Zeile 1:
			[[Category:vba-wiki]]

	== APIs?!? ==		== APIs?!? ==

Pwania: /* Erste Tests */

2018-11-17T07:34:44Z

Erste Tests

← Nächstältere Version		Version vom 17. November 2018, 07:34 Uhr
Zeile 262:		Zeile 262:
	Diese sollte auf eine Datei geändert werden, die tatsächlich existiert. Suchen Sie sich dazu eine beliebige Datei und geben Sie sie komplett mit Pfad an:		Diese sollte auf eine Datei geändert werden, die tatsächlich existiert. Suchen Sie sich dazu eine beliebige Datei und geben Sie sie komplett mit Pfad an:

	sFilename <span style="Color:gray">=</span> <span style="Color:gray">"c:\temp\test.txt"</span> ' Geben Sie hier eine Datei an, die Sie tatsächlich auf Ihrem Rechner finden		sFilename <span style="Color:gray">=</span> <span style="Color:gray">"c:\temp\test.txt"</span> <span style="Color:green">' Geben Sie hier eine Datei an, die Sie tatsächlich auf Ihrem Rechner finden</span>

	[[Datei:API_Test_02.png]]		[[Datei:API_Test_02.png]]

Pwania: /* Erste Tests */

2018-11-16T14:46:20Z

Erste Tests

← Nächstältere Version		Version vom 16. November 2018, 14:46 Uhr
Zeile 264:		Zeile 264:
	sFilename <span style="Color:gray">=</span> <span style="Color:gray">"c:\temp\test.txt"</span> ' Geben Sie hier eine Datei an, die Sie tatsächlich auf Ihrem Rechner finden		sFilename <span style="Color:gray">=</span> <span style="Color:gray">"c:\temp\test.txt"</span> ' Geben Sie hier eine Datei an, die Sie tatsächlich auf Ihrem Rechner finden

	[[Datei:API_Test_02.png]]		[[Datei:API_Test_02.png]]

			Nun entsprechen die Angaben tatsächlich den Angaben im Eigenschaften-Dialog:

	[[Datei:API_Test_03.png]]		[[Datei:API_Test_03.png]]

Pwania: /* Erste Tests */

2018-11-16T14:45:01Z

Erste Tests

← Nächstältere Version		Version vom 16. November 2018, 14:45 Uhr
Zeile 265:		Zeile 265:

	[[Datei:API_Test_02.png]]		[[Datei:API_Test_02.png]]

			[[Datei:API_Test_03.png]]

	=== Sinnvolle Anpassungen ===		=== Sinnvolle Anpassungen ===

Pwania: /* Erste Tests */

2018-11-16T14:42:36Z

Erste Tests

← Nächstältere Version		Version vom 16. November 2018, 14:42 Uhr
Zeile 254:		Zeile 254:
	[[Datei:API_Test_01.png]]		[[Datei:API_Test_01.png]]

	Der ~~Dialog~~ scheint zu funktionieren, allerdings ist das Ergebnis (alle drei Zeitangaben enthalten den Tag Null, also den 30. Dezember 1899) nicht befriedigend.		Der Beispielcode scheint zu funktionieren, allerdings ist das Ergebnis (alle drei Zeitangaben enthalten den Tag Null, also den 30. Dezember 1899) nicht befriedigend.

	Der Autor hatte im Beispiel folgende Dateivorgabe gemacht:		Der Autor hatte im Beispiel folgende Dateivorgabe gemacht:

Pwania: /* Erste Tests */

2018-11-16T14:41:54Z

Erste Tests

← Nächstältere Version		Version vom 16. November 2018, 14:41 Uhr
Zeile 249:		Zeile 249:

	=== Erste Tests ===		=== Erste Tests ===

			Nun können Sie die Prozedur 'Test' bzw. die Prozedur, in welche Sie den Beispielcode kopiert haben, mit 'F5' ausführen.

			[[Datei:API_Test_01.png]]

			Der Dialog scheint zu funktionieren, allerdings ist das Ergebnis (alle drei Zeitangaben enthalten den Tag Null, also den 30. Dezember 1899) nicht befriedigend.

			Der Autor hatte im Beispiel folgende Dateivorgabe gemacht:

			sFilename <span style="Color:gray">=</span> <span style="Color:gray">"c:\eigene dateien\MeineDatei.txt"</span>

			Diese sollte auf eine Datei geändert werden, die tatsächlich existiert. Suchen Sie sich dazu eine beliebige Datei und geben Sie sie komplett mit Pfad an:

			sFilename <span style="Color:gray">=</span> <span style="Color:gray">"c:\temp\test.txt"</span> ' Geben Sie hier eine Datei an, die Sie tatsächlich auf Ihrem Rechner finden

			[[Datei:API_Test_02.png]]

	=== Sinnvolle Anpassungen ===		=== Sinnvolle Anpassungen ===

Pwania: /* Erste Anpassungen und oberflächliche Analyse */

2018-11-16T14:18:14Z

Erste Anpassungen und oberflächliche Analyse

← Nächstältere Version		Version vom 16. November 2018, 14:18 Uhr
Zeile 222:		Zeile 222:
	=== Erste Anpassungen und oberflächliche Analyse ===		=== Erste Anpassungen und oberflächliche Analyse ===

	* Benutzerdefinierte Datentypen 'Type'		* Benutzerdefinierte Datentypen 'Type' (optional)
	** Für API-Aufrufe werden oftmals benutzerdefinierte Datentypen verwendet, um ganze Informationsblöcke austauschen zu können		** Für API-Aufrufe werden oftmals benutzerdefinierte Datentypen verwendet, um ganze Informationsblöcke austauschen zu können
	** Diese müssen oberhalb der Prozedur, bei der sie verwendet werden, deklariert sein		** Diese müssen oberhalb der Prozedur, bei der sie verwendet werden, deklariert sein
Zeile 235:		Zeile 235:
	<span style="Color:blue">Private Declare PtrSafe Function </span>CreateFile ...		<span style="Color:blue">Private Declare PtrSafe Function </span>CreateFile ...

			* Konstanten (optional)
			** Die im Beispiel verwendeten API-Aufrufe benötigen neben den benutzerdefinierten Datentypen auch mehrere Konstanten
			** Diese müssen lediglich vor der ersten Prozedur deklariert werden, können also auch weiter oben erscheinen
			* Prozeduren (optional)
			** Unserem Beispiel wurde eine Prozedur mitgegeben, welche den Aufruf der verschiedenen API-Prozeduren bündelt und die für das Beispiel geforderte Aufgabe erfüllt.
			** Die Funktion 'ReadFileTime' erwartet die Übergabe eines Dateinamens und drei Datumsangaben für Die Erzeugung, den letzten Zugriff auf und das letzte Speichern der Datei
			** Die drei Datumswerte werden nicht in der Funktion verwendet, sondern 'ByRef' übernommen, das heißt, sie enthalten nach dem Aufruf der Funktion die gewünschten Werte
			** Die Funktion selbst hat den Datentyp 'Boolean', was darauf hindeutet, dass auf diesem Wege mitgeteilt wird, ob die Ermittlung der Daten erfolgreich war
			* Beispielprozedur (optional)
			** Der Autor dieses Beispieles hat uns zusätzlich auch noch den Code einer Steuerprozedur mitgegeben, womit wir seinen Lösungsvorschlag testen können :-)

	~~Steuerprozedur~~		Bevor Sie zum Test übergehen, sollten Sie das Testprojekt, in das Sie die Beispielprogrammierung kopiert haben, kompilieren, um sicher zu gehen, dass keine offensichtlichen Fehler enthalten sind.

	~~Vollständigkeit (Debuggen)~~

	=== Erste Tests ===		=== Erste Tests ===

Pwania: /* Sinnvolle Anpassungen */

2018-11-16T14:02:29Z

Sinnvolle Anpassungen

← Nächstältere Version		Version vom 16. November 2018, 14:02 Uhr
Zeile 243:		Zeile 243:

	=== Sinnvolle Anpassungen ===		=== Sinnvolle Anpassungen ===

			Ptrsafe

	=== Fertige Beispiellösung 'Älteste Datei in Verzeichnis' ===		=== Fertige Beispiellösung 'Älteste Datei in Verzeichnis' ===

	== Struktur eines API-Aufrufes ==		== Struktur eines API-Aufrufes ==

Pwania: /* Erste Anpassungen und oberflächliche Analyse */

2018-11-16T14:02:06Z

Erste Anpassungen und oberflächliche Analyse

@@ Zeile 222: / Zeile 222: @@
 === Erste Anpassungen und oberflächliche Analyse ===
-Ptrsafe
+* Benutzerdefinierte Datentypen 'Type'
 Steuerprozedur

Pwania: /* Erste Anpassungen */

2018-11-16T10:33:23Z

Erste Anpassungen

← Nächstältere Version		Version vom 16. November 2018, 10:33 Uhr
Zeile 220:		Zeile 220:
	'''Anmerkung:''' Das Erstellen einer eigenen Prozedur ist nur dann nötig, wenn der Beispiel-Aufruf wie hier ohne eine Prozedur zur Verfügung gestellt wurde.		'''Anmerkung:''' Das Erstellen einer eigenen Prozedur ist nur dann nötig, wenn der Beispiel-Aufruf wie hier ohne eine Prozedur zur Verfügung gestellt wurde.

	=== Erste Anpassungen ===		=== Erste Anpassungen und oberflächliche Analyse ===

	Ptrsafe		Ptrsafe

			Steuerprozedur

			Vollständigkeit (Debuggen)

	=== Erste Tests ===		=== Erste Tests ===