FontCollection::GetLastStatus-Methode (gdiplusheaders.h)

Die FontCollection::GetLastStatus-Methode gibt einen Wert zurück, der das Ergebnis des vorherigen Methodenaufrufs dieses FontCollection-Objekts angibt.

Syntax

Status GetLastStatus();

Rückgabewert

Typ: Status

Die FontCollection::GetLastStatus-Methode gibt ein Element der Status-Enumeration zurück.

Wenn die vorherige Methode, die für dieses FontCollection-Objekt aufgerufen wurde, erfolgreich war, gibt FontCollection::GetLastStatus Ok zurück.

Wenn bei der vorherigen Methode ein Fehler aufgetreten ist, gibt FontCollection::GetLastStatus eines der anderen Elemente der Status-Enumeration zurück, das die Art des Fehlers angibt.

Hinweise

Sie können FontCollection::GetLastStatus unmittelbar nach dem Erstellen eines FontCollection-Objekts aufrufen, um zu bestimmen, ob der Konstruktor erfolgreich war. FontCollection::GetLastStatus gibt Ok zurück, wenn der Konstruktor erfolgreich war. Andernfalls wird ein Wert zurückgegeben, der die Art des Fehlers angibt.

Beachten Sie, dass sich die Implementierung von FontCollection::GetLastStatus in den Font - und FontCollection-Klassen von der Implementierung dieser Methode in anderen Klassen unterscheidet. Außerdem unterscheidet sich die Implementierung von FontCollection::GetLastStatus in der Font-Klasse von der Implementierung von FontCollection::GetLastStatus in der FontCollection-Klasse .

Beispiele

Im folgenden Beispiel wird ein PrivateFontCollection-Objekt erstellt, die status eines Methodenaufrufs überprüft und bei erfolgreicher Ausführung Text erstellt.

VOID Example_GetLastStatus(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a PrivateFontCollection object, and add three families.
   PrivateFontCollection fontCollection;
   fontCollection.AddFontFile(L"C:\\WINNT\\Fonts\\Arial.ttf");
   fontCollection.AddFontFile(L"C:\\WINNT\\Fonts\\CourBI.ttf");
   fontCollection.AddFontFile(L"C:\\WINNT\\Fonts\\TimesBd.ttf");

   // Create an array to hold the font families, and get the font families of
   // fontCollection.
   FontFamily families[3];
   int numFamilies;
   fontCollection.GetFamilies(3, families, &numFamilies);

   // Verify that the call to GetFamilies was successful.
   Status status = fontCollection.GetLastStatus();

   // If the call was successful, draw text.
   if (status == Ok)
   {
      // Create a Font object from the first FontFamily object in the array.
      Font myFont(&families[0], 16);

      // Use myFont to draw text.
      SolidBrush solidbrush(Color(255, 0, 0, 0));
      WCHAR string[] = L"The call was successful";
      graphics.DrawString(string,
                          23, &myFont, PointF(0, 0), &solidbrush);
   }
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Weitere Informationen

Fontcollection

Privatefontcollection

Verwenden von Text und Schriftarten