Méthode IProgressDialog ::StartProgressDialog (shlobj_core.h)
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour