Control.Font Свойство

Определение

Возвращает или задает шрифт текста, отображаемого элементом управления.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

Значение свойства

Шрифт Font, применяемый к тексту, отображаемому элементом управления.The Font to apply to the text displayed by the control. Значением по умолчанию является значение свойства DefaultFont.The default is the value of the DefaultFont property.

Примеры

В следующем примере кода отображается FontDialog для пользователя и изменяется Font элемента управления DateTimePicker.The following code example displays a FontDialog to the user and changes the Font of a DateTimePicker control. В этом примере требуется наличие Form с Button и DateTimePicker.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

Комментарии

Свойство Font является внешним свойством.The Font property is an ambient property. Внешнее свойство — это свойство элемента управления, которое, если оно не задано, извлекается из родительского элемента управления.An ambient property is a control property that, if not set, is retrieved from the parent control. Например, Button будет иметь то же BackColor, что и родительский Form по умолчанию.For example, a Button will have the same BackColor as its parent Form by default. Дополнительные сведения о внешних свойствах см. в описании класса AmbientProperties или в обзоре класса Control.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Поскольку Font является неизменяемым (то есть вы не можете изменить его свойства), можно назначить свойству Font новое 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. Однако можно создать новый шрифт на основе существующего шрифта.However, you can base the new font on the existing font.

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

Ниже приведен пример того, как изменить существующий шрифт, сделав его полужирным: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)  

Примечания для тех, кто наследует этот метод

При переопределении свойства Font в производном классе используйте свойство базового класса Font для расширения базовой реализации.When overriding the Font property in a derived class, use the base class's Font property to extend the base implementation. В противном случае необходимо предоставить всю реализацию.Otherwise, you must provide all the implementation. Не требуется переопределять методы доступа get и set свойства Font; При необходимости можно переопределить только один из них.You are not required to override both the get and set accessors of the Font property; you can override only one if needed.

Применяется к

Дополнительно