Control.Font Propriedade

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.

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

Partilhar via