ColorDialog Classe

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
ColorDialog.cs
Source:
ColorDialog.cs
Source:
ColorDialog.cs
Source:
ColorDialog.cs
Source:
ColorDialog.cs

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
Object
MarshalByRefObject
Component
CommonDialog
ColorDialog

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 formulaire 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() = 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 substitué pour implémenter des fonctionnalités de hook 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

Nom Description
ColorDialog()

Initialise une nouvelle instance de la classe ColorDialog.

Propriétés

Nom Description
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 l’ensemble de couleurs de base.
CanRaiseEvents

Obtient une valeur indiquant 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 fichier qui contient le Component.

(Hérité de Component)
CustomColors

Obtient ou définit l’ensemble de couleurs personnalisées affichées dans la boîte de dialogue.
DesignMode

Obtient une valeur qui indique si la Component valeur est actuellement en mode création.

(Hérité de Component)
Events

Obtient la liste des gestionnaires d’événements qui sont 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 lorsque la boîte de dialogue est ouverte.
Instance

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

Obtient des valeurs pour initialiser le ColorDialog.
ShowHelp

Obtient ou définit une valeur indiquant si un bouton d’aide apparaît dans la boîte de dialogue couleur.
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 limite les utilisateurs à la sélection de couleurs unie uniquement.
Tag

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

(Hérité de CommonDialog)

Méthodes

Nom Description
CreateObjRef(Type)

Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
Dispose()

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

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

Libère les ressources non managées utilisées par les Component ressources gérées 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()

Sert 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 actuel 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 le Component ou par son Container.

(Hérité de Component)
GetType()

Obtient la Type de l’instance actuelle.

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

Définit la procédure courante de raccordement de boîte de dialogue qui est substituée pour ajouter des fonctionnalités spécifiques à 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 Objectactuel.

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

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

(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 substituée pour ajouter des fonctionnalités spécifiques à une boîte de dialogue commune.

(Hérité de CommonDialog)
Reset()

Réinitialise toutes les options à leurs valeurs par défaut, la dernière couleur sélectionnée en noir et les couleurs personnalisées à 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 le ColorDialog.

Événements

Nom Description
Disposed

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

(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