Méthode IProgressDialog ::StartProgressDialog (shlobj_core.h)

Article
03/04/2024

Démarre la boîte de dialogue progression.

Syntaxe

HRESULT StartProgressDialog(
  [in] HWND     hwndParent,
       IUnknown *punkEnableModless,
       DWORD    dwFlags,
       LPCVOID  pvResevered
);

Paramètres

[in] hwndParent

Type : HWND

Handle de la fenêtre parente de la boîte de dialogue.

punkEnableModless

Type : IUnknown*

Réservé. Défini sur NULL.

dwFlags

Type : DWORD

Indicateurs qui contrôlent l’opération de la boîte de dialogue progression. Combinaison des valeurs suivantes :

PROGDLG_NORMAL

Comportement de la boîte de dialogue de progression normale.

PROGDLG_MODAL

La boîte de dialogue de progression sera modale pour la fenêtre spécifiée par hwndParent. Par défaut, une boîte de dialogue de progression est sans mode.

PROGDLG_AUTOTIME

Estimez automatiquement le temps restant et affichez l’estimation à la ligne 3. Si cet indicateur est défini, IProgressDialog ::SetLine ne peut être utilisé que pour afficher du texte aux lignes 1 et 2.

PROGDLG_NOTIME

N’affichez pas le texte « temps restant ».

PROGDLG_NOMINIMIZE

N’affichez pas de bouton réduire dans la barre de légende de la boîte de dialogue.

PROGDLG_NOPROGRESSBAR

N’affichez pas de barre de progression. En règle générale, une application peut déterminer quantitativement la quantité restante de l’opération et passer régulièrement cette valeur à IProgressDialog ::SetProgress. La boîte de dialogue progression utilise ces informations pour mettre à jour sa barre de progression. Cet indicateur est généralement défini lorsque l’application appelante doit attendre la fin d’une opération, mais ne dispose pas d’informations quantitatives qu’elle peut utiliser pour mettre à jour la boîte de dialogue.

PROGDLG_MARQUEEPROGRESS

Windows Vista et versions ultérieures. Définit la barre de progression sur le mode de sélection. Cela entraîne un défilement horizontal de la barre de progression, semblable à un affichage sous chapiteau. Utilisez cette option lorsque vous souhaitez indiquer que la progression est en cours, mais que le temps nécessaire à l’opération est inconnu.

PROGDLG_NOCANCEL

Windows Vista et versions ultérieures. N’affichez pas de bouton Annuler. L’opération ne peut pas être annulée. Utilisez-le uniquement lorsque cela est absolument nécessaire.

pvResevered

Type : LPCVOID

Réservé. Défini sur NULL.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h
DLL	Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

IProgressDialog

Partager via