Control.Font Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Origem:: Control.cs

Origem:: Control.cs

Origem:: Control.cs

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.

Obtém ou define a fonte do texto exibido pelo controle.

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

Font

O Font a ser aplicado ao texto exibido pelo controle. O padrão é o valor da propriedade DefaultFont.

Exemplos

O exemplo de código a seguir exibe um FontDialog para o usuário e altera o Font de um DateTimePicker controle. Este exemplo exige que você tenha um Form com Button e um DateTimePicker nele.

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 Font propriedade é uma propriedade de ambiente. Uma propriedade de ambiente é uma propriedade de controle que, se não estiver definida, é recuperada do controle pai. Por exemplo, um Button terá o mesmo BackColor que seu pai Form por padrão. Para obter mais informações sobre propriedades de ambiente, consulte a AmbientProperties classe ou a visão geral da Control classe.

Como o Font é imutável (o que significa que você não pode ajustar nenhuma de suas propriedades), você só pode atribuir à Font propriedade um novo Font. No entanto, você pode basear a nova fonte na fonte existente.

Veja a seguir um exemplo de como ajustar a fonte existente para torná-la em negrito:

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 Font propriedade em uma classe derivada, use a propriedade da Font classe base para estender a implementação base. Caso contrário, você deve fornecer toda a implementação. Você não precisa substituir os get acessadores e set da Font propriedade; você pode substituir apenas um, se necessário.

Aplica-se a

Produto	Versões
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Compartilhar via