ColorDialog Classe

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa uma caixa de diálogo comum que exibe as cores disponíveis, em conjunto com os controles que permitem que o usuário defina cores personalizadas.

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

Herança: Object

MarshalByRefObject

Component

CommonDialog
ColorDialog

Exemplos

O exemplo a seguir ilustra a criação de um novo ColorDialog. Este exemplo requer que o método seja chamado de dentro de um formulário existente que tenha um TextBox e Button colocado nele.

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

Comentários

O membro ShowDialog herdado deve ser invocado para criar essa caixa de diálogo comum específica. HookProc pode ser substituído para implementar a funcionalidade de gancho de caixa de diálogo específica. Use Color para recuperar a cor selecionada pelo usuário.

Quando você cria uma instância do ColorDialog, algumas das propriedades de leitura/gravação são definidas como valores iniciais. Para obter uma lista desses valores, consulte o ColorDialog construtor .

Construtores

ColorDialog()

Inicializa uma nova instância da classe ColorDialog.

Propriedades

AllowFullOpen	Obtém ou define um valor que indica se o usuário pode usar a caixa de diálogo para definir cores personalizadas.
AnyColor	Obtém ou define um valor que indica se a caixa de diálogo exibe todas as cores disponíveis no conjunto de cores básicas.
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
Color	Obtém ou define a cor selecionada pelo usuário.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
CustomColors	Obtém ou define o conjunto personalizado de cores mostrado na caixa de diálogo.
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
FullOpen	Obtém ou define um valor que indica se os controles usados para criar cores personalizadas são visíveis quando a caixa de diálogo é aberta.
Instance	Obtém o identificador de instância de janela subjacente (HINSTANCE).
Options	Obtém os valores para inicializar o ColorDialog.
ShowHelp	Obtém ou define um valor que indica se o botão Ajuda aparece na caixa de diálogo de cores.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
SolidColorOnly	Obtém ou define um valor que indica se a caixa de diálogo restringirá os usuários a selecionar apenas cores sólidas.
Tag	Obtém ou define um objeto que contém dados sobre o controle. (Herdado de CommonDialog)

Métodos

CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Define o procedimento de gancho de caixa de diálogo comum que é substituído para adicionar uma funcionalidade específica a uma caixa de diálogo comum. (Herdado de CommonDialog)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnHelpRequest(EventArgs)	Aciona o evento HelpRequest. (Herdado de CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Define o procedimento da janela de proprietário que é substituído para adicionar a funcionalidade específica a uma caixa de diálogo comum. (Herdado de CommonDialog)
Reset()	Redefine todas as opções para seus valores padrão, a última cor selecionada para preto e as cores personalizadas para seus valores padrão.
RunDialog(IntPtr)	Quando substituído em uma classe derivada, especifica uma caixa de diálogo comum.
ShowDialog()	Executa uma caixa de diálogo comum com um proprietário padrão. (Herdado de CommonDialog)
ShowDialog(IWin32Window)	Executa uma caixa de diálogo comum com o proprietário especificado. (Herdado de CommonDialog)
ToString()	Retorna uma cadeia de caracteres que representa o ColorDialog.

Eventos

Disposed	Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)
HelpRequest	Ocorre quando o usuário clica no botão Ajuda em uma caixa de diálogo comum. (Herdado de CommonDialog)

Aplica-se a

Confira também

CommonDialog

Compartilhar via