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.Represents a common dialog box that displays available colors along with controls that enable the user to define custom colors.

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 d’un nouvel ColorDialog.The following example illustrates the creation of new ColorDialog. Cet exemple requiert que la méthode soit appelée à partir d’un formulaire existant qui a un TextBox et que Button y est placé.This example requires that the method is called from within an existing form that has a TextBox and Button placed on it.

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 hérité ShowDialog doit être appelé pour créer cette boîte de dialogue commune spécifique.The inherited member ShowDialog must be invoked to create this specific common dialog box. HookProc peut être substitué pour implémenter des fonctionnalités de raccordement de boîte de dialogue spécifiques.HookProc can be overridden to implement specific dialog box hook functionality. Utilisez Color pour récupérer la couleur sélectionnée par l’utilisateur.Use Color to retrieve the color selected by the user.

Lorsque vous créez une instance de ColorDialog, certaines des propriétés en lecture/écriture sont définies sur des valeurs initiales.When you create an instance of ColorDialog, some of the read/write properties are set to initial values. Pour obtenir la liste de ces valeurs, consultez le constructeur ColorDialog.For a list of these values, see the ColorDialog constructor.

Constructeurs

ColorDialog()

Initialise une nouvelle instance de la classe ColorDialog.Initializes a new instance of the ColorDialog class.

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.Gets or sets a value indicating whether the user can use the dialog box to define custom colors.

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.Gets or sets a value indicating whether the dialog box displays all available colors in the set of basic colors.

CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Hérité de Component)
Color

Obtient ou définit la couleur sélectionnée par l'utilisateur.Gets or sets the color selected by the user.

Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Hérité de Component)
CustomColors

Obtient ou définit le jeu de couleurs personnalisées affiché dans la boîte de dialogue.Gets or sets the set of custom colors shown in the dialog box.

DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Hérité de Component)
Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.Gets the list of event handlers that are attached to this 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.Gets or sets a value indicating whether the controls used to create custom colors are visible when the dialog box is opened.

Instance

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

Options

Obtient des valeurs pour initialiser ColorDialog.Gets values to initialize the ColorDialog.

ShowHelp

Obtient ou définit une valeur indiquant si un bouton Aide figure dans la boîte de dialogue des couleurs.Gets or sets a value indicating whether a Help button appears in the color dialog box.

Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the 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.Gets or sets a value indicating whether the dialog box will restrict users to selecting solid colors only.

Tag

Obtient ou définit un objet qui contient des données relatives au contrôle.Gets or sets an object that contains data about the control.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par Component.Releases all resources used by the 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.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

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

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Hérité de Component)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(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.Defines the common dialog box hook procedure that is overridden to add specific functionality to a common dialog box.

(Hérité de CommonDialog)
InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

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

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

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

Déclenche l'événement HelpRequest.Raises the HelpRequest event.

(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.Defines the owner window procedure that is overridden to add specific functionality to a common dialog box.

(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.Resets all options to their default values, the last selected color to black, and the custom colors to their default values.

RunDialog(IntPtr)

En cas de substitution dans une classe dérivée, spécifie une boîte de dialogue commune.When overridden in a derived class, specifies a common dialog box.

ShowDialog()

Exécute une boîte de dialogue commune avec un propriétaire par défaut.Runs a common dialog box with a default owner.

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

Exécute une boîte de dialogue commune avec le propriétaire spécifié.Runs a common dialog box with the specified owner.

(Hérité de CommonDialog)
ToString()

Retourne une chaîne qui représente ColorDialog.Returns a string that represents the ColorDialog.

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Hérité de Component)
HelpRequest

Se produit lorsque l'utilisateur clique sur le bouton Aide dans une boîte de dialogue commune.Occurs when the user clicks the Help button on a common dialog box.

(Hérité de CommonDialog)

S’applique à

Voir aussi