FontDialog Classe

Definição

Solicita ao usuário para escolher uma fonte entre as instaladas no computador local.Prompts the user to choose a font from among those installed on the local computer.

public ref class FontDialog : System::Windows::Forms::CommonDialog
public class FontDialog : System.Windows.Forms.CommonDialog
type FontDialog = class
    inherit CommonDialog
Public Class FontDialog
Inherits CommonDialog
Herança

Exemplos

O exemplo de código a ShowDialog seguir usa para FontDialogexibir um.The following code example uses ShowDialog to display a FontDialog. Esse código requer que um Form já tenha sido criado com um TextBox botão e colocado nele.This code requires that a Form has already been created with a TextBox and button placed on it. Ele também requer que o fontDialog1 tenha sido criado.It also requires that the fontDialog1 has been created. O Font contém as informações de tamanho, mas não as informações de cor.The Font contains the size information but not the color information.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      fontDialog1->ShowColor = true;

      fontDialog1->Font = textBox1->Font;
      fontDialog1->Color = textBox1->ForeColor;

      if ( fontDialog1->ShowDialog() != ::DialogResult::Cancel )
      {
         textBox1->Font = fontDialog1->Font;
         textBox1->ForeColor = fontDialog1->Color;
      }
   }
private void button1_Click(object sender, System.EventArgs e)
 {
    fontDialog1.ShowColor = true;

    fontDialog1.Font = textBox1.Font;
    fontDialog1.Color = textBox1.ForeColor;

    if(fontDialog1.ShowDialog() != DialogResult.Cancel )
    {
       textBox1.Font = fontDialog1.Font ;
       textBox1.ForeColor = fontDialog1.Color;
    }
 }
 
Private Sub button1_Click(sender As Object, e As System.EventArgs)
    fontDialog1.ShowColor = True

    fontDialog1.Font = textBox1.Font
    fontDialog1.Color = textBox1.ForeColor

    If fontDialog1.ShowDialog() <> DialogResult.Cancel Then
        textBox1.Font = fontDialog1.Font
        textBox1.ForeColor = fontDialog1.Color
    End If
End Sub

Comentários

O membro ShowDialog herdado deve ser chamado para criar essa caixa de diálogo comum específica.The inherited member ShowDialog must be invoked to create this specific common dialog box. HookProcpode ser substituído para implementar a funcionalidade de gancho de caixa de diálogo específica.HookProc can be overridden to implement specific dialog box hook functionality.

Quando você cria uma instância do FontDialog, algumas das propriedades de leitura/gravação são definidas como valores iniciais.When you create an instance of FontDialog, some of the read/write properties are set to initial values. Para obter uma lista desses valores, consulte o FontDialog Construtor.For a list of these values, see the FontDialog constructor.

Construtores

FontDialog()

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

Campos

EventApply

É proprietário do evento Apply.Owns the Apply event.

Propriedades

AllowScriptChange

Obtém ou define um valor que indica se o usuário pode alterar o conjunto de caracteres especificado na caixa de combinação Script para exibir um conjunto de caracteres diferente daquele exibido atualmente.Gets or sets a value indicating whether the user can change the character set specified in the Script combo box to display a character set other than the one currently displayed.

AllowSimulations

Obtém ou define um valor que indica se a caixa de diálogo permite simulações de fonte de GDI (Graphics Device Interface).Gets or sets a value indicating whether the dialog box allows graphics device interface (GDI) font simulations.

AllowVectorFonts

Obtém ou define um valor que indica se a caixa de diálogo permite seleções de fonte vetorial.Gets or sets a value indicating whether the dialog box allows vector font selections.

AllowVerticalFonts

Obtém ou define um valor que indica se a caixa de diálogo exibe fontes verticais e horizontais ou apenas as horizontais.Gets or sets a value indicating whether the dialog box displays both vertical and horizontal fonts or only horizontal fonts.

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)
Color

Obtém ou define a cor da fonte selecionada.Gets or sets the selected font color.

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)
FixedPitchOnly

Obtém ou define um valor que indica se a caixa de diálogo permite apenas a seleção de fontes de densidade fixa.Gets or sets a value indicating whether the dialog box allows only the selection of fixed-pitch fonts.

Font

Obtém ou define a fonte selecionada.Gets or sets the selected font.

FontMustExist

Obtém ou define um valor que indica se a caixa de diálogo especifica uma condição de erro se o usuário tenta selecionar uma fonte ou um estilo que não existe.Gets or sets a value indicating whether the dialog box specifies an error condition if the user attempts to select a font or style that does not exist.

MaxSize

Obtém ou define o tamanho de ponto máximo que um usuário pode selecionar.Gets or sets the maximum point size a user can select.

MinSize

Obtém ou define o tamanho de ponto mínimo que um usuário pode selecionar.Gets or sets the minimum point size a user can select.

Options

Obtém os valores para inicializar o FontDialog.Gets values to initialize the FontDialog.

ScriptsOnly

Obtém ou define um valor que indica se a caixa de diálogo permite a seleção de fontes para todos os conjuntos de caracteres de símbolo e não OEM, bem como para o conjunto de caracteres ANSI.Gets or sets a value indicating whether the dialog box allows selection of fonts for all non-OEM and Symbol character sets, as well as the ANSI character set.

ShowApply

Obtém ou define um valor que indica se a caixa de diálogo contém um botão Aplicar.Gets or sets a value indicating whether the dialog box contains an Apply button.

ShowColor

Obtém ou define um valor que indica se a caixa de diálogo exibe a opção de cor.Gets or sets a value indicating whether the dialog box displays the color choice.

ShowEffects

Obtém ou define um valor que indica se a caixa de diálogo contém controles que permitem que o usuário especifique opções de cor de texto, sublinhado e tachado.Gets or sets a value indicating whether the dialog box contains controls that allow the user to specify strikethrough, underline, and text color options.

ShowHelp

Obtém ou define um valor que indica se a caixa de diálogo exibe um botão Ajuda.Gets or sets a value indicating whether the dialog box displays a Help button.

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.

(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.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()

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)

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

InitializeLifetimeService()

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)
OnApply(EventArgs)

Aciona o evento Apply.Raises the Apply event.

OnHelpRequest(EventArgs)

Aciona o evento HelpRequest.Raises the HelpRequest event.

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

(Herdado de CommonDialog)
Reset()

Redefine todas as opções de caixa de diálogo para seus valores padrão.Resets all dialog box options to their default values.

RunDialog(IntPtr)

Especifica uma caixa de diálogo de arquivo.Specifies a file 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.

(Herdado de CommonDialog)
ShowDialog(IWin32Window)

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

(Herdado de CommonDialog)
ToString()

Recupera uma cadeia de caracteres que inclui o nome da fonte atual selecionada na caixa de diálogo.Retrieves a string that includes the name of the current font selected in the dialog box.

Eventos

Apply

Ocorre quando o usuário clica no botão Aplicar na caixa de diálogo da fonte.Occurs when the user clicks the Apply button in the font dialog box.

Disposed

Ocorre quando o componente é disposto por uma chamada para o 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.

(Herdado de CommonDialog)

Aplica-se a

Veja também