FontCollection ::GetLastStatus, méthode (gdiplusheaders.h)
La méthode FontCollection ::GetLastStatus retourne une valeur qui indique le résultat de l’appel de méthode précédent de cet objet FontCollection .
Syntaxe
Status GetLastStatus();
Valeur de retour
Type : État
La méthode FontCollection ::GetLastStatus retourne un élément de l’énumération Status .
Si la méthode précédente appelée sur cet objet FontCollection a réussi, FontCollection ::GetLastStatus retourne Ok.
Si la méthode précédente a échoué, FontCollection ::GetLastStatus retourne l’un des autres éléments de l’énumération Status qui indique la nature de l’échec.
Remarques
Vous pouvez appeler FontCollection ::GetLastStatus immédiatement après la construction d’un objet FontCollection pour déterminer si le constructeur a réussi. FontCollection ::GetLastStatus retourne Ok si le constructeur a réussi. Sinon, il retourne une valeur qui indique la nature de la défaillance.
Notez que l’implémentation de FontCollection ::GetLastStatus dans les classes Font et FontCollection est différente de l’implémentation de cette méthode dans d’autres classes. En outre, l’implémentation de FontCollection ::GetLastStatus dans la classe Font est différente de l’implémentation de FontCollection ::GetLastStatus dans la classe FontCollection .
Exemples
L’exemple suivant crée un objet PrivateFontCollection, vérifie la status d’un appel de méthode et, en cas de réussite, dessine du texte.
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);
}
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | gdiplusheaders.h (inclure Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |