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