Control.Font Propriedade

Definição

Obtém ou define a fonte do texto exibido pelo controle.Gets or sets the font of the text displayed by the control.

public:
 virtual property System::Drawing::Font ^ Font { System::Drawing::Font ^ get(); void set(System::Drawing::Font ^ value); };
public virtual System.Drawing.Font Font { get; set; }
member this.Font : System.Drawing.Font with get, set
Public Overridable Property Font As Font

Valor da propriedade

O Font a ser aplicado ao texto exibido pelo controle.The Font to apply to the text displayed by the control. O padrão é o valor da propriedade DefaultFont.The default is the value of the DefaultFont property.

Exemplos

O exemplo de código a seguir exibe um FontDialog para o usuário e altera o Font de um controle DateTimePicker.The following code example displays a FontDialog to the user and changes the Font of a DateTimePicker control. Este exemplo requer que você tenha um Form com Button e um DateTimePicker nele.This example requires that you have a Form with Button and a DateTimePicker on it.

private:
   void myButton_Click( Object^ sender, EventArgs^ e )
   {
      FontDialog^ myFontDialog = gcnew FontDialog;
      if ( myFontDialog->ShowDialog() == ::DialogResult::OK )
      {
         // Set the control's font.
         myDateTimePicker->Font = myFontDialog->Font;
      }
   }
private void myButton_Click(object sender, EventArgs e)
{
   FontDialog myFontDialog = new FontDialog();
   if(myFontDialog.ShowDialog() == DialogResult.OK)
   {
      // Set the control's font.
      myDateTimePicker.Font = myFontDialog.Font;
   }
}
Private Sub myButton_Click(sender As Object, e As EventArgs)
   Dim myFontDialog As FontDialog
   myFontDialog = New FontDialog()
   
   If myFontDialog.ShowDialog() = DialogResult.OK Then
      ' Set the control's font.
      myDateTimePicker.Font = myFontDialog.Font
   End If
End Sub

Comentários

A propriedade Font é uma propriedade de ambiente.The Font property is an ambient property. Uma propriedade de ambiente é uma propriedade de controle que, se não definida, é recuperada do controle pai.An ambient property is a control property that, if not set, is retrieved from the parent control. Por exemplo, um Button terá o mesmo BackColor que seu pai Form, por padrão.For example, a Button will have the same BackColor as its parent Form by default. Para obter mais informações sobre as propriedades de ambiente, consulte a classe AmbientProperties ou a visão geral da classe Control.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Como o Font é imutável (o que significa que não é possível ajustar nenhuma de suas propriedades), você só pode atribuir a propriedade Font uma nova Font.Because the Font is immutable (meaning that you cannot adjust any of its properties), you can only assign the Font property a new Font. No entanto, você pode basear a nova fonte na fonte existente.However, you can base the new font on the existing font.

[Visual Basic, C#][Visual Basic, C#]

Veja a seguir um exemplo de como ajustar a fonte existente para torná-la em negrito:The following is an example of how to adjust the existing font to make it bold:

myControl.Font = new Font(myControl.Font,   
    myControl.Font.Style | FontStyle.Bold);  
MyControl.Font = New Font(MyControl.Font, _   
    MyControl.Font.Style Or FontStyle.Bold)  

Notas aos Herdeiros

Ao substituir a propriedade Font em uma classe derivada, use a propriedade Font da classe base para estender a implementação de base.When overriding the Font property in a derived class, use the base class's Font property to extend the base implementation. Caso contrário, você deve fornecer toda a implementação.Otherwise, you must provide all the implementation. Não é necessário substituir os acessadores get e set da propriedade Font; Você pode substituir apenas um se necessário.You are not required to override both the get and set accessors of the Font property; you can override only one if needed.

Aplica-se a

Veja também