RemoveFontResourceA-Funktion (wingdi.h)

Die RemoveFontResource-Funktion entfernt die Schriftarten in der angegebenen Datei aus der Systemschriftarttabelle.

Wenn die Schriftart mithilfe der Funktion AddFontResourceEx hinzugefügt wurde, müssen Sie die RemoveFontResourceEx-Funktion verwenden.

Syntax

BOOL RemoveFontResourceA(
  [in] LPCSTR lpFileName
);

Parameter

[in] lpFileName

Ein Zeiger auf eine NULL-Zeichenfolge, die eine Schriftartressourcendatei benennt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Es wird empfohlen, wenn eine App Schriftarten aus der Systemschriftarttabelle hinzufügt oder entfernt, andere Fenster über die Änderung zu benachrichtigen, indem sie eine WM_FONTCHANGE Nachricht an alle Fenster der obersten Ebene im System sendet. Die App sendet diese Nachricht, indem sie die SendMessage-Funktion aufruft, wobei der hwnd-Parameter auf HWND_BROADCAST festgelegt ist.

Wenn ausstehende Verweise auf eine Schriftart vorhanden sind, bleibt die zugeordnete Ressource geladen, bis sie von keinem Gerätekontext verwendet wird. Wenn die Schriftart in der Schriftartenregistrierung (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) aufgeführt und an einem anderen Speicherort als dem Ordner %windir%\fonts\ installiert wird, kann sie in andere aktive Sitzungen (einschließlich Sitzung 0) geladen werden.

Wenn Sie versuchen, eine vorhandene Schriftartdatei, die eine Schriftart enthält, durch ausstehende Verweise darauf zu ersetzen, wird möglicherweise ein Fehler angezeigt, der darauf hinweist, dass die ursprüngliche Schriftart nicht gelöscht werden kann, da sie auch nach dem Aufrufen von RemoveFontResource verwendet wird. Wenn Ihre App erfordert, dass die Schriftartdatei ersetzt wird, rufen Sie RemoveFontResource in einer Schleife auf, um die Ressourcenanzahl der ursprünglichen Schriftart auf Null zu reduzieren, wie in diesem Beispielcode gezeigt. Wenn weiterhin Fehler auftreten, ist dies ein Hinweis darauf, dass die Schriftartdatei in anderen Sitzungen geladen bleibt. Stellen Sie sicher, dass die Schriftart nicht in der Schriftartenregistrierung aufgeführt ist, und starten Sie das System neu, um sicherzustellen, dass die Schriftart aus allen Sitzungen entladen wird.

int i = 0;
while( RemoveFontResource( FontFile ) )
{
    i++;
}

// TODO: Replace font file

while( i-- )
{
    AddFontResource( FontFile );
}

Anforderungen

Weitere Informationen

AddFontResource

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

RemoveFontResourceEx

SendMessage