ColorDialog Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Rappresenta una finestra di dialogo comune in cui vengono visualizzati i colori disponibili e i controlli che consentono all'utente di definire colori personalizzati.

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

Ereditarietà

Object

MarshalByRefObject

Component

CommonDialog

ColorDialog

Esempio

Nell'esempio seguente viene illustrata la creazione di un nuovo ColorDialogoggetto . In questo esempio è necessario che il metodo venga chiamato dall'interno di un modulo esistente con e TextBoxButton inserito su di esso.

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

Commenti

Il membro ShowDialog ereditato deve essere richiamato per creare questa finestra di dialogo comune specifica. HookProc può essere sottoposto a override per implementare funzionalità hook specifiche della finestra di dialogo. Utilizzare Color per recuperare il colore selezionato dall'utente.

Quando si crea un'istanza di ColorDialog, alcune delle proprietà di lettura/scrittura vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il ColorDialog costruttore.

Costruttori

ColorDialog()

Inizializza una nuova istanza della classe ColorDialog.

Proprietà

AllowFullOpen	Ottiene o imposta un valore che indica se l'utente può usare la finestra di dialogo per definire colori personalizzati.
AnyColor	Ottiene o imposta un valore che indica se nella finestra di dialogo sono visualizzati tutti i colori disponibili nel gruppo di colori di base.
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
Color	Ottiene o imposta il colore selezionato dall'utente.
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
CustomColors	Ottiene o imposta il gruppo di colori personalizzati visualizzato nella finestra di dialogo.
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
FullOpen	Ottiene o imposta un valore che indica se i controlli usati per creare colori personalizzati sono disponibili all'apertura della finestra di dialogo.
Instance	Ottiene il punto di controllo dell'istanza della finestra sottostante (HINSTANCE).
Options	Ottiene i valori per l'inizializzazione dell'oggetto ColorDialog.
ShowHelp	Ottiene o imposta un valore che indica se viene visualizzato il pulsante della Guida nella finestra di dialogo dei colori.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
SolidColorOnly	Ottiene o imposta un valore che indica se nella finestra di dialogo la scelta dell'utente sarà limitata ai soli colori in tinta unita.
Tag	Ottiene o imposta un oggetto che contiene i dati relativi al controllo. (Ereditato da CommonDialog)

Metodi

CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite. (Ereditato da Component)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine di hook della finestra di dialogo comune di cui viene eseguito l'override per aggiungere funzionalità specifiche a una finestra di dialogo comune. (Ereditato da CommonDialog)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnHelpRequest(EventArgs)	Genera l'evento HelpRequest. (Ereditato da CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definisce la routine della finestra proprietaria di cui viene eseguito l'override per aggiungere funzionalità specifiche a una finestra di dialogo comune. (Ereditato da CommonDialog)
Reset()	Reimposta tutte le opzioni sui rispettivi valori predefiniti, l'ultimo colore selezionato sul nero e i colori personalizzati sui rispettivi valori predefiniti.
RunDialog(IntPtr)	Quando ne viene eseguito l'override in una classe derivata, specifica una finestra di dialogo comune.
ShowDialog()	Esegue una finestra di dialogo comune con un proprietario predefinito. (Ereditato da CommonDialog)
ShowDialog(IWin32Window)	Esegue una finestra di dialogo comune con il proprietario specificato. (Ereditato da CommonDialog)
ToString()	Restituisce una stringa che rappresenta l'oggetto ColorDialog.

Eventi

Disposed	Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)
HelpRequest	Si verifica quando l'utente fa clic sul pulsante della Guida in una finestra di dialogo comune. (Ereditato da CommonDialog)

Vedi anche

• CommonDialog