ColorDialog Classe

Définition

Représente une boîte de dialogue commune qui affiche les couleurs disponibles ainsi que les contrôles qui permettent à l'utilisateur de définir des couleurs personnalisées.

public ref class ColorDialog : System::Windows::Forms::CommonDialog
public class ColorDialog : System.Windows.Forms.CommonDialog
type ColorDialog = class
    inherit CommonDialog
Public Class ColorDialog
Inherits CommonDialog
Héritage

Exemples

L’exemple suivant illustre la création de nouveau ColorDialog. Cet exemple nécessite que la méthode soit appelée à partir d’un formulaire existant qui a un TextBox et Button l’a placé sur celui-ci.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      ColorDialog^ MyDialog = gcnew ColorDialog;
      // Keeps the user from selecting a custom color.
      MyDialog->AllowFullOpen = false;
      // Allows the user to get help. (The default is false.)
      MyDialog->ShowHelp = true;
      // Sets the initial color select to the current text color.
      MyDialog->Color = textBox1->ForeColor;
      
      // Update the text box color if the user clicks OK 
      if ( MyDialog->ShowDialog() == ::System::Windows::Forms::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }
private void button1_Click(object sender, System.EventArgs e)
 {
    ColorDialog MyDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = false ;
    // Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = true ;
    // Sets the initial color select to the current text color.
    MyDialog.Color = textBox1.ForeColor ;
    
    // Update the text box color if the user clicks OK 
    if (MyDialog.ShowDialog() == DialogResult.OK)
        textBox1.ForeColor =  MyDialog.Color;
 }
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    Dim MyDialog As New ColorDialog()
    ' Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = False
    ' Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = True
    ' Sets the initial color select to the current text color,
    MyDialog.Color = TextBox1.ForeColor

    ' Update the text box color if the user clicks OK 
    If (MyDialog.ShowDialog() = Windows.Forms.DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Remarques

Le membre ShowDialog hérité doit être appelé pour créer cette boîte de dialogue commune spécifique. HookProc peut être remplacé pour implémenter des fonctionnalités de crochet de boîte de dialogue spécifiques. Permet Color de récupérer la couleur sélectionnée par l’utilisateur.

Lorsque vous créez une instance de ColorDialog, certaines des propriétés en lecture/écriture sont définies sur les valeurs initiales. Pour obtenir la liste de ces valeurs, consultez le ColorDialog constructeur.

Constructeurs

ColorDialog()

Initialise une nouvelle instance de la classe ColorDialog.

Propriétés

AllowFullOpen

Obtient ou définit une valeur indiquant si l'utilisateur peut utiliser la boîte de dialogue pour définir des couleurs personnalisées.

AnyColor

Obtient ou définit une valeur indiquant si la boîte de dialogue affiche toutes les couleurs disponibles dans le jeu de couleurs de base.

CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.

(Hérité de Component)
Color

Obtient ou définit la couleur sélectionnée par l'utilisateur.

Container

Obtient le IContainer qui contient la Component.

(Hérité de Component)
CustomColors

Obtient ou définit le jeu de couleurs personnalisées affiché dans la boîte de dialogue.

DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.

(Hérité de Component)
Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.

(Hérité de Component)
FullOpen

Obtient ou définit une valeur indiquant si les contrôles utilisés pour créer des couleurs personnalisées sont visibles à l’ouverture de la boîte de dialogue.

Instance

Obtient le handle d'instance de fenêtre sous-jacent (HINSTANCE).

Options

Obtient des valeurs pour initialiser ColorDialog.

ShowHelp

Obtient ou définit une valeur indiquant si un bouton Aide figure dans la boîte de dialogue des couleurs.

Site

Obtient ou définit le ISite de Component.

(Hérité de Component)
SolidColorOnly

Obtient ou définit une valeur indiquant si la boîte de dialogue permet aux utilisateurs de sélectionner uniquement des couleurs unies.

Tag

Obtient ou définit un objet qui contient des données relatives au contrôle.

(Hérité de CommonDialog)

Méthodes

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par Component.

(Hérité de Component)
Dispose(Boolean)

Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées.

(Hérité de Component)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.

(Hérité de Component)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Définit la procédure de raccordement d'une boîte de dialogue commune devant être substituée pour qu'une fonctionnalité spécifique soit ajoutée à une boîte de dialogue commune.

(Hérité de CommonDialog)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
OnHelpRequest(EventArgs)

Déclenche l’événement HelpRequest.

(Hérité de CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

Définit la procédure de fenêtre propriétaire devant être substituée pour qu'une fonctionnalité spécifique soit ajoutée à une boîte de dialogue commune.

(Hérité de CommonDialog)
Reset()

Rétablit les valeurs par défaut de toutes les options, la dernière couleur sélectionnée sur la couleur noire et les couleurs personnalisées sur leurs valeurs par défaut.

RunDialog(IntPtr)

En cas de substitution dans une classe dérivée, spécifie une boîte de dialogue commune.

ShowDialog()

Exécute une boîte de dialogue commune avec un propriétaire par défaut.

(Hérité de CommonDialog)
ShowDialog(IWin32Window)

Exécute une boîte de dialogue commune avec le propriétaire spécifié.

(Hérité de CommonDialog)
ToString()

Retourne une chaîne qui représente ColorDialog.

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().

(Hérité de Component)
HelpRequest

Se produit lorsque l'utilisateur clique sur le bouton Aide dans une boîte de dialogue commune.

(Hérité de CommonDialog)

S’applique à

Voir aussi