Deklaration TaskDialog

Deklaration der Funktion TaskDialog

 

Damit die Funktion TaskDialog verwendet werden kann muss sie deklariert werden. Die Deklaration sieht wie folgt aus:

Public Declare Function TaskDialog Lib "comctl32.dll" 
  (ByVal hwndParent As Long, _ 
   ByVal hInstance As Long, _ 
   ByVal pszWindowTitle As Long, _ 
   ByVal pszMainInstruction As Long, _ 
   ByVal pszContent As Long, _ 
   ByVal dwCommonButtons As Long, _ 
   ByVal pszIcon As Long, _ 
   ByRef pnButton As Long) As Long

 

Die einzelnen Parameter haben folgende Bedeutung:

hwndParent Zeiger auf das übergeordnete Fenster.
hInstance Zeiger auf Modul mit Icons (siehe unten).
Wenn der Wert "0" übergeben wird können nur die vom Betriebssystem definierten Icons verwendet werden.
pszWindowTitle Fenstertitel
pszMainInstruction Text für Hauptinformation.
pszContent Text für ergänzende Erläuterungen.
dwCommonButtons Anzuzeigende Buttons.
pszIcon Anzuzeigendes Icon.
pnButton Rückgabewert: Gib an, welchen Button der User gedrückt hat.

 

Die Funktion liefert folgende Rückgabewerte:

S_OK
(&H0 bzw. 0)
Aktion erfolgreich.
E_OUTOFMEMORY
(&H8007000E bzw. -2147024882)
Nicht genügend Arbeitsspeicher.
E_INVALIDARG
(&H80070057 bzw. -2147024809)
Ein oder mehrere übergebene Argumente sind ungültig.
E_FAIL
(&H80004005 bzw. -2147467259)
Die Operation ist gescheitert.

 

Weitere Informationen:

MSDN Dokumentation "Task Dialog Function"
http://msdn.microsoft.com/en-us/library/bb760540(VS.85).aspx