Contrôle CommonDialog pour les utilisateurs de Visual Basic 6.0
Mise à jour : novembre 2007
Le contrôle CommonDialog de Visual Basic 6.0 est remplacé par plusieurs composants spécialisés dans Visual Basic 2008.
Différences conceptuelles
Dans Visual Basic 6.0, le contrôle ActiveX CommonDialog est utilisé pour afficher plusieurs boîtes de dialogue courantes (Ouvrir, Enregistrer, Couleur, Police, Imprimer et Aide) dans votre application.
Dans Visual Basic 2008, le contrôle CommonDialog est remplacé par des composants pour afficher des boîtes de dialogue. Il s'agit des composants OpenFileDialog, SaveFileDialog, ColorDialog, FontDialog et PrintDialog.
.gif "Remarque") Remarque : |
|---|
Il n'existe pas d'équivalent direct permettant d'afficher une boîte de dialogue de l'aide dans Visual Basic 2008. Le contrôle CommonDialog prenait uniquement en charge l'aide de Windows ; Visual Basic 2008 prend uniquement en charge l'aide HTML. Visual Basic 2008 utilise le composant HelpProvider pour afficher l'aide de votre application. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0. |
Modifications du code pour le contrôle CommonDialog
Les exemples de code ci-dessous illustrent les différences entre les techniques de codage dans Visual Basic 6.0 et dans Visual Basic 2008 pour certaines utilisations courantes du contrôle CommonDialog.
Modifications du code pour afficher une boîte de dialogue Ouvrir
Le code suivant illustre l'affichage d'une boîte de dialogue Ouvrir, initialisée dans le répertoire Program Files.
' Visual Basic 6.0
' Uses a CommonDialog control.
CommonDialog1.InitDir = "C:\Program Files"
CommonDialog1.ShowOpen
' Visual Basic
' Uses a OpenFileDialog component.
OpenFileDialog1.InitialDirectory = "C:\Program Files"
OpenFileDialog1.ShowDialog()
Modifications du code pour afficher une boîte de dialogue Enregistrer
Le code suivant illustre l'affichage d'une boîte de dialogue Enregistrer en enregistrant le fichier dans le dossier de l'application.
' Visual Basic 6.0
' Uses a CommonDialog control.
CommonDialog1.InitDir = App.Path
CommonDialog1.ShowSave
' Visual Basic
' Uses a SaveFileDialog component.
SaveFileDialog1.InitialDirectory = My.Application.Info.DirectoryPath
SaveFileDialog1.ShowDialog()
Modifications du code pour afficher une boîte de dialogue Imprimer
Le code suivant illustre l'affichage d'une boîte de dialogue Imprimer, en imprimant un fichier localisé dans le dossier de l'application.
' Visual Basic 6.0
' Uses a CommonDialog control.
CommonDialog1.FileName = App.Path & "MyFile.txt"
CommonDialog1.ShowPrinter
' Visual Basic
' Uses PrintDocument and PrintDialog components.
PrintDocument1.DocumentName = My.Application.Info.DirectoryPath _
& "MyFile.txt"
PrintDialog1.Document = PrintDocument1
PrintDialog1.ShowDialog()
Modifications du code pour afficher l'aide
Le code suivant illustre l'affichage d'un fichier d'aide de votre application, en l'ouvrant dans la table des matières.
' Visual Basic 6.0
' Uses a CommonDialog control.
CommonDialog1.HelpFile = "C:\Windows\Help\calc.hlp"
CommonDialog1.HelpCommand = cdlHelpContents
CommonDialog1.ShowHelp
' Visual Basic
' Uses the Help.ShowHelp method.
Help.ShowHelp(Me, "file://C:\Windows\Help\calc.chm", _
HelpNavigator.TableOfContents)
Équivalences des méthodes et des propriétés du contrôle CommonDialog
Les tableaux suivants répertorient les propriétés et méthodes de Visual Basic 6.0, ainsi que leurs équivalents dans Visual Basic 2008. Les propriétés et méthodes qui ont les mêmes noms et comportements ne sont pas répertoriées. Lorsque des constantes s'appliquent, elles sont présentées en retrait sous le nom de la propriété ou de la méthode. Sauf indication contraire, toutes les énumérations Visual Basic 2008 sont mappées à l'espace de noms System.Windows.Forms.
Le cas échéant, des liens vous renvoient vers des rubriques expliquant les différences de comportement. Lorsqu'il n'existe pas d'équivalent direct dans Visual Basic 2008, des liens vous renvoient vers des rubriques proposant des alternatives.
Propriétés
Visual Basic 6.0 |
Visual Basic 2008Équivalent |
||
|---|---|---|---|
Action |
Nouvelle implémentation. La propriété Action de Visual Basic 6.0 détermine la boîte de dialogue à afficher ; Visual Basic 2008 utilise un composant distinct pour chaque boîte de dialogue. |
||
CancelError |
|||
Copies |
|||
DialogTitle |
Title (composants OpenFileDialog et SaveFileDialog uniquement) Nouvelle implémentation pour les autres composants. Les titres des fenêtres standard (Color, Font et Print) sont affichés et ne peuvent pas être substitués. |
||
FileName |
|||
FileTitle |
Nouvelle implémentation. La propriété FileTitle de Visual Basic 6.0 retourne le FileName sans le chemin d'accès ; vous pouvez analyser la propriété FileNames pour obtenir le nom sans le chemin d'accès. |
||
Flags |
La propriété Flags de Visual Basic 6.0 fournit des constantes pour la définition de plusieurs attributs de différentes boîtes de dialogue courantes. Plutôt que d'utiliser des constantes, les composants de dialogue fournissent des propriétés pour définir les attributs. |
||
Font FontBold FontItalic FontName FontSize FontStrikethrough FontUnderline |
|
||
FromPage |
|||
hDC |
Nouvelle implémentation. Pour plus d'informations, consultez Éléments graphiques pour les utilisateurs de Visual Basic 6.0. |
||
HelpCommand |
|||
HelpFile |
|||
HelpKey |
Paramètres parameter de la méthode ShowHelp. |
||
Index |
Nouvelle implémentation. Pour plus d'informations, consultez Tableaux de contrôles pour les utilisateurs de Visual Basic 6.0. |
||
InitDir |
|||
Left |
|
||
Max |
MaxSize (composant FontDialog) MaximumPage (composant PrintDialog) |
||
Min |
MinSize (composant FontDialog) MinimumPage (composant PrintDialog) |
||
MaxFileSize |
Nouvelle implémentation. Cette propriété Visual Basic 6.0 alloue la mémoire pour les noms de fichiers extrêmement longs ; elle n'est donc plus nécessaire dans le code managé. |
||
Orientation |
|||
Parent |
Méthode FindForm |
||
PrinterDefault |
Nouvelle implémentation. Cette propriété Visual Basic 6.0 est utilisée conjointement avec la propriété hDC pour imprimer à l'aide de méthodes d'interface de périphérique graphique ; cette propriété n'est plus prise en charge. |
||
Top |
P:System.Windows.Forms.Control.Top
|
||
ToPage |
Méthodes
Visual Basic 6.0 |
Équivalent Visual Basic 2005 |
|---|---|
AboutBox |
Nouvelle implémentation. La propriété AboutBox affichait une boîte À propos de pour le contrôle CommonDialog qui était créé pour Microsoft par un tiers. |
ShowColor |
ShowDialog (composant ColorDialog) |
ShowFont |
ShowDialog (composant FontDialog) |
ShowHelp |
|
ShowOpen |
ShowDialog (composant OpenFileDialog) |
ShowPrinter |
ShowDialog (composant PrintDialog) |
ShowSave |
ShowDialog (composant SaveFileDialog) |
Mettre à niveau des remarques
Lors de la mise à niveau d'une application de Visual Basic 6.0 vers Visual Basic 2008, tous les contrôles CommonDialog sont mis à niveau vers leur composant de dialogue équivalent (OpenFileDialog, SaveFileDialog, ColorDialog, FontDialog ou PrintDialog).
Il n'existe pas d'équivalent direct permettant d'afficher une boîte de dialogue Help dans Visual Basic 2008. Si un contrôle CommonDialog est utilisé comme boîte de dialogue Help, un avertissement est émis et il n'est pas mis à niveau. Pour plus d'informations, consultez Prise en charge de l'aide pour les utilisateurs de Visual Basic 6.0.
Un seul contrôle CommonDialog pouvait être utilisé pour afficher différents types de boîtes de dialogue. Dans ce cas, il est mis à niveau vers un composant OpenFileDialog ; un avertissement est émis et vous devez ajouter les autres composants de dialogue manuellement.
De plus, lorsqu'un contrôle CommonDialog était utilisé comme variable, il se peut que vous deviez le modifier pour faire référence à un composant de dialogue spécifique après la mise à niveau.
Voir aussi
Référence
Vue d'ensemble du composant FontDialog (Windows Forms)
Vue d'ensemble du composant HelpProvider (Windows Forms)
Autres ressources
ColorDialog, composant (Windows Forms)
OpenFileDialog, composant (Windows Forms)
SaveFileDialog, composant (Windows Forms)