Control.Font Control.Font Control.Font Control.Font Property

Определение

Возвращает или задает шрифт текста, отображаемого элементом управления.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 было и. DateTimePickerThis 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. Например, по умолчанию объект будет иметь BackColor то же значение Form , что и его родительский элемент Button .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.

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

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