CommonDialog Classe

Definição

Especifica a classe base usada para exibir caixas de diálogo na tela.Specifies the base class used for displaying dialog boxes on the screen.

public ref class CommonDialog abstract : System::ComponentModel::Component
public abstract class CommonDialog : System.ComponentModel.Component
type CommonDialog = class
    inherit Component
Public MustInherit Class CommonDialog
Inherits Component
Herança
Derivado

Exemplos

O exemplo de código a seguir usa a ColorDialog implementação de CommonDialog e ilustra a criação e a exibição de uma caixa de diálogo.The following code example uses the ColorDialog implementation of CommonDialog and illustrates creating and showing a dialog box. Este exemplo requer que o método seja chamado de dentro de um formulário existente, que tem um TextBox e Button colocado nele.This example requires that the method is called from within an existing form, which 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

Comentários

Classes herdadas são necessárias para implementar RunDialog invocando ShowDialog para criar uma caixa de diálogo comum específica.Inherited classes are required to implement RunDialog by invoking ShowDialog to create a specific common dialog box. As classes herdadas podem opcionalmente ser substituídas HookProc para implementar a funcionalidade de gancho de caixa de diálogo específica.Inherited classes can optionally override HookProc to implement specific dialog box hook functionality.

Construtores

CommonDialog()

Inicializa uma nova instância da classe CommonDialog.Initializes a new instance of the CommonDialog class.

Propriedades

CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Herdado de Component)
Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Herdado de Component)
DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Herdado de Component)
Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Herdado de Component)
Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Herdado de Component)
Tag

Obtém ou define um objeto que contém dados sobre o controle.Gets or sets an object that contains data about the control.

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

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Herdado de Component)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Herdado de Component)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

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

(Herdado de MarshalByRefObject)
GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Herdado de Component)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

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

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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
OnHelpRequest(EventArgs)

Aciona o evento HelpRequest.Raises the HelpRequest event.

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

Reset()

Quando substituído em uma classe derivada, redefine as propriedades de uma caixa de diálogo comum para seus valores padrão.When overridden in a derived class, resets the properties of a common dialog box to their default values.

RunDialog(IntPtr)

Quando substituído em uma classe derivada, especifica uma caixa de diálogo comum.When overridden in a derived class, specifies a common dialog box.

ShowDialog()

Executa uma caixa de diálogo comum com um proprietário padrão.Runs a common dialog box with a default owner.

ShowDialog(IWin32Window)

Executa uma caixa de diálogo comum com o proprietário especificado.Runs a common dialog box with the specified owner.

ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Herdado de Component)

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Herdado de Component)
HelpRequest

Ocorre quando o usuário clica no botão Ajuda em uma caixa de diálogo comum.Occurs when the user clicks the Help button on a common dialog box.

Aplica-se a