Deutsch
Stammtisch & Café

Eine API-Library in deutsch - tolle Sache!!!

 

Stephan
Sonneborn
Hallo Andreas,

ich finde, das ist eine super Sache, die Du da ins Leben gerufen hast! Man sucht sich immer einen Wolf, um die notwendigen Parameter einer API zu finden und einigermaßen erklärt zu bekommen! (Wenn man dann endlich die richtige API gefunden hat...)

Ein paar Anregungen habe ich auch:
Die Einträge unter einer jeweiligen Katregorie sollten alphabetisch geordnet sein und eine zweite Spalte mit einer kurzen Beschreibung haben. Dann finndet man noch schneller die richtige API.

Auf die Kategorieseite sollte noch ein Hinweis auf die API-Hilfe von Gerhard Putschalka zu finden sein. Damit kann man sich dann die Werte der leider gebräuchlichen Klartext-Parameter anzeigen lassen.
 
Schöne Grüße aus Wittgenstein
von Stephan

Programmierumgebung:| XProfan X4 | WIN10 | AMD FX6100 3,3 GHz
03.04.2005  
 



Hallo Stephan...

Ob die Library überhaupt alphabetisch zu ordnen ist, kann ich leider nicht genau sagen. Damit man sich besser zurecht findet wird IF aber, so denke ich, noch einiges in Zukunft unternehmen (wir stehen ja erst am Anfang).

Den Hinweis auf der Kathegorieseite (auch auf Uwes Hilfedateien) wird es geben, der ist schon länger geplant. Eventuell richte ich auch einen extra Linkbereich ein.
 
03.04.2005  
 




efisch
>> Eine API-Library in deutsch - tolle Sache!!!

Da muss ich doch unbedingt zustimmen.

Und vorschlagen, darüber nachzudenken, ob man die Library nicht auch in irgendeiner Form zum Download anbieten sollte.
Nicht jeder hat eine Flatrate oder einen schnellen Internetzugang. Offline sucht und schmökert es sich doch wesentlich angenehmer als mit einer tickenden Verbindungszeituhr im Hinterkopf.

Gruß
ebi
 
03.04.2005  
 



Hallo efisch...

Sehr gute Idee!
@IF - gibt es schon eine Möglichkeit komplette Forenbereiche herunterzuladen?

Du wirst aber trotzdem nicht darum herumkommen, dir unsere Seite öfters anzusehen. Im Durchschnitt kommt hier täglich eine API dazu - ich habe schon mal in einer Nacht 15 neue hochgeladen...
 
03.04.2005  
 




Frank
Abbing
Hallo,

auch von mir ein dickes Lob für deine unermüdliche Arbeit!

> Auf die Kategorieseite sollte noch ein Hinweis auf die API-Hilfe von Gerhard Putschalka zu finden sein. Damit kann man sich
> dann die Werte der leider gebräuchlichen Klartext-Parameter anzeigen lassen.

Da kann ich nicht zustimmen. Ich würde mir wünschen, dass du keine festen Zahlenwerte in deinen Codes und Beschreibungen verwendest, sondern die von MS festgelegten Namen der Variablen. Noch besser wäre es, wenn du die Variablen und Namen sofort im Code definierst, so lernt der User beim Coden sofort beide Varianten kennen.
Denn bei der später vertieften Lehre der API (du erstellst ja nur Basiscodes und so soll es ja auch sein), erkennt der User sofort die bekannten Variablennamen (die ja vom Namen her meistens Rückschlüsse auf die entsprechende Nutzung erlauben), anstatt mühsam die komplette API doch noch erlernen zu müssen.
Hier mal das Beispiel deiner Erklärung von DrawStatusText(), so wie ich es mir wünschen würde:
KompilierenMarkierenSeparieren
Def &SBT_DEF        $0
Def &SBT_NOBORDERS  $100
Def &SBT_POPOUT     $200
DEF @GetSysColor(1) !"USER32","GetSysColor"
DEF @DrawStatusText(4) !"comctl32.dll","DrawStatusTextA"
DEclare RECT#,TEXT$
SetTrueColor 1
Windowstyle 31
Windowtitle "Statustext"
Window 0,0-640,440
CLS @GetSysColor(15)
DIM RECT#,16
Long RECT#,0=50
Long RECT#,4=50
Long RECT#,8=250
Long RECT#,12=75
Let Text$="Statustext versenkt"
@DrawStatusText(%HDC,RECT#,@ADDR(TEXT$),&SBT_DEF)
@DrawStatusText(%HDC2,RECT#,@ADDR(TEXT$),&SBT_DEF)
Long RECT#,0=50
Long RECT#,4=100
Long RECT#,8=250
Long RECT#,12=125
Let Text$="Statustext hervorgehoben"
@DrawStatusText(%HDC,RECT#,@ADDR(TEXT$),&SBT_POPOUT)
@DrawStatusText(%HDC2,RECT#,@ADDR(TEXT$),&SBT_POPOUT)
Long RECT#,0=50
Long RECT#,4=150
Long RECT#,8=250
Long RECT#,12=175
Let Text$="Statustext flach"
@DrawStatusText(%HDC,RECT#,@ADDR(TEXT$),&SBT_NOBORDERS)
@DrawStatusText(%HDC2,RECT#,@ADDR(TEXT$),&SBT_NOBORDERS) Sonst kein Repaint!
DISPOSE RECT#

While 0=0

    Waitinput

Wend


Oder du verwendest die .ph-Dateien, die ja vordefinierte Variablenwerte benutzen.
 
03.04.2005  
 



Hallo Frank...

Ich habe selbst schon darüber nachgedacht, die definierten Konstantennamen von MIcrosoft zu verwenden. Aus folgenden Gründen habe ich das bislang nicht getan, werde die Konstantennamen demnächst aber wohl als Zusatz bei den Parametern einfügen:

- Älteren Profanversionen fehlen die Übersetzungsdateien (.PH).

- Die Übersetzungsdateien, vor allen Dingen die Windows.PH und die STRUCT.PH, enthalten bis XProfan hin Fehler - im Securitybereich sind mir diese aufgefallen. Stößt man zufälligerweise auf einen solchen Fehler, nutzt einem der Konstantenname gar nichts.

- Längst nicht alle Konstantennamen sind erwähnt, viele Header-Dateien fehlen Profan.

- Für einen Einsteiger in die API (wie ich auch einer bin) sind Konstantennamen extrem verwirrend. Es wird verschleiert, was sich wirklich dahinter verbirgt - nämlich binäre Flags - also Schalter. Jede 1 steht für einen aktivierten Schalter, jede 0 für einen deaktivierten Schalter. Nur so ist auch die Addierung von Flags zu verstehen und warum diese Addierung (den Profan Bug mal außer acht gelassen) mit einem binären Oder erfolgen sollte (damit bei einer Doppeladdierung eines gleichen Flags in einer Flagkombination nicht plötzlich der nächste Schalter umgelegt wird).

- Eine halbwegs verständliche Erklärung ist mir anfangs wichtiger, als das Erwähnen eines Konstantennamens. Im Augenblick denke ich eher, daß man einige Sachen doch auch mal bei Microsoft direkt nachschlagen möchte - bei neueren Erklärungen werde ich die Konstantennamen deshalb bei den Parametern unterbringen. Aus den oben genannten Gründen werden mir die Flags aber weiterhin wichtiger bleiben.
 
03.04.2005  
 



Also wenn ich Parameter Deiner Routinen ändern möchte, schlag ich im MSDN oder PSDK nach, wo nur die Konstanten-Namen aufgeführt sind. Die eigentlichen Werte bringen mich da nicht viel weiter. Also eine Deklaration der Konstanten und Verwendung dieser würde ich schon sehr begrüßen.

Gruß
Thomas
 
03.04.2005  
 




Frank
Abbing
Hi,

Thomas trifft es genau. Wie ich auch schon sagte, helfen Konstanten nicht mehr weiter, sobald deine Codes erweitert werden sollen...
 
03.04.2005  
 



Hallo ihr beiden...

Deklarationen der Konstanten wird es in den Quelltexten aus den oben genannten Gründen nicht geben. Ich bin da bei zu vielen Sachen über Fehler in den Header Dateien gestolpert. Die Konstantennamen werden aber unter den Parametern in der Beschreibung erwähnt werden.

Quelltexte sollte man so oder so nicht einfach so abkopieren - dafür habe ich sie auch nicht hier gepostet. Ich möchte die Leute dazu bringen, sich mit der Beschreibung und dem Quelltext auseinanderzusetzen (beides gehört zusammen) und zu vertstehen, wie das funktioniert. Wer nicht versteht, was er da tut, wird früher oder später auf die Nase fallen...
 
09.04.2005  
 



Warum nutzt Du eigendlich - AH - den neuen Code

nicht?

Gefällt Dir eigendlich meine Lösung mit der API-Library-Box?
Ich meine dort trägt sich automatisch ein - was mit API in der bestimmten Downloadrubrik eingetragen ist.

Salve.

[box:17f93c8551]vielleicht bin ich auch nur senil[/box:17f93c8551]

 
18.04.2005  
 



Keywords? OOPS - vergesssen! Wird nachgeholt!
API- BOX => gut.
Keywords => sehr sinnvoll
alphabetische Sortierung => genial!

Weiter so - ich sehe, hier wird mächtig gearbeitet...
 
18.04.2005  
 



Antworten


Thementitel, max. 100 Zeichen.
 

Systemprofile:

Kein Systemprofil angelegt. [anlegen]

XProfan:

 Beitrag  Schrift  Smilies  ▼ 

Bitte anmelden um einen Beitrag zu verfassen.
 

Themenoptionen

7.948 Betrachtungen

Unbenanntvor 0 min.
Tommy25.03.2023
RudiB.15.04.2022
Peter Max Müller28.10.2017
supernova27.11.2013
Mehr...

Themeninformationen



Admins  |  AGB  |  Anwendungen  |  Autoren  |  Chat  |  Datenschutz  |  Download  |  Eingangshalle  |  Hilfe  |  Händlerportal  |  Impressum  |  Mart  |  Schnittstellen  |  SDK  |  Services  |  Spiele  |  Suche  |  Support

Ein Projekt aller XProfaner, die es gibt!


Mein XProfan
Private Nachrichten
Eigenes Ablageforum
Themen-Merkliste
Eigene Beiträge
Eigene Themen
Zwischenablage
Abmelden
 Deutsch English Français Español Italia
Übersetzungen

Datenschutz


Wir verwenden Cookies nur als Session-Cookies wegen der technischen Notwendigkeit und bei uns gibt es keine Cookies von Drittanbietern.

Wenn du hier auf unsere Webseite klickst oder navigierst, stimmst du unserer Erfassung von Informationen in unseren Cookies auf XProfan.Net zu.

Weitere Informationen zu unseren Cookies und dazu, wie du die Kontrolle darüber behältst, findest du in unserer nachfolgenden Datenschutzerklärung.


einverstandenDatenschutzerklärung
Ich möchte keinen Cookie