Control.Font-Eigenschaft

Artikel
08/20/2007

Ruft die Schriftart für die Anzeige von Text im Steuerelement ab oder legt diese fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Overridable Property Font As Font
'Usage
Dim instance As Control
Dim value As Font

value = instance.Font

instance.Font = value

[LocalizableAttribute(true)] 
public virtual Font Font { get; set; }

[LocalizableAttribute(true)] 
public:
virtual property Font^ Font {
    Font^ get ();
    void set (Font^ value);
}

/** @property */
public Font get_Font ()

/** @property */
public void set_Font (Font value)

public function get Font () : Font

public function set Font (value : Font)

Eigenschaftenwert

Der Font, der auf den Text angewendet werden soll, der im Steuerelement angezeigt wird. Der Standardwert ist der Wert der DefaultFont-Eigenschaft.

Hinweise

Die Font-Eigenschaft ist eine Ambient-Eigenschaft. Eine Ambient-Eigenschaft ist eine Steuerelementeigenschaft, die vom übergeordneten Steuerelement abgerufen wird, sofern sie nicht festgelegt ist. Ein Button hat z. B. standardmäßig die gleiche BackColor wie das übergeordnete Form. Weitere Informationen zu Ambient-Eigenschaften finden Sie unter der AmbientProperties-Klasse oder in der Übersicht über die Control-Klasse.

Da der Font unveränderlich ist, d. h. die Eigenschaften nicht angepasst werden können, können Sie der Font-Eigenschaft nur einen neuen Font zuweisen. Sie können die vorhandene Schriftart jedoch als Grundlage für die neue Schriftart verwenden.

Im folgenden Beispiel wird die vorhandene Schriftart fett formatiert:

myControl.Font = new Font(myControl.Font, 
    myControl.Font.Style | FontStyle.Bold);

MyControl.Font = New Font(MyControl.Font, _ 
    MyControl.Font.Style Or FontStyle.Bold)

Hinweise für Erben Verwenden Sie beim Überschreiben der Font-Eigenschaft in einer abgeleiteten Klasse die Font-Eigenschaft der Basisklasse, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Sie müssen nicht sowohl den get-Accessor als auch den set-Accessor der Font-Eigenschaft überschreiben. Sie können ggf. auch nur einen Accessor überschreiben.

Beispiel

Im folgenden Codebeispiel wird dem Benutzer ein FontDialog angezeigt und der Font eines DateTimePicker-Steuerelements geändert. Bei diesem Beispiel muss in einem Form ein Button und ein DateTimePicker vorhanden sein.

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

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:
   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().Equals(get_DialogResult().OK)) {
        // Set the control's font.
        myDateTimePicker.set_Font(myFontDialog.get_Font());
    }
} //myButton_Click

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
FontChanged
OnFontChanged
Font

Freigeben über