FontCollection::GetLastStatus メソッド (gdiplusheaders.h)

FontCollection::GetLastStatus メソッドは、この FontCollection オブジェクトの以前のメソッド呼び出しの結果を示す値を返します。

構文

Status GetLastStatus();

戻り値

種類: 状態

FontCollection::GetLastStatus メソッドは Status 列挙の要素を返します。

この FontCollection オブジェクトで呼び出された前のメソッドが成功した場合、 FontCollection::GetLastStatus は OK を返します。

前のメソッドが失敗した場合、 FontCollection::GetLastStatus は、エラーの性質を示す Status 列挙の他の要素のいずれかを返します。

注釈

FontCollection オブジェクトを構築した直後に FontCollection::GetLastStatus を呼び出して、コンストラクターが成功したかどうかを判断できます。 コンストラクターが成功した場合、FontCollection::GetLastStatus は Ok を返します。 それ以外の場合は、エラーの性質を示す値を返します。

Font クラスおよび FontCollection クラスでの FontCollection::GetLastStatus の実装は、他のクラスでのこのメソッドの実装とは異なります。 また、Font クラスでの FontCollection::GetLastStatus の実装は、FontCollection クラスの FontCollection::GetLastStatus の実装とは異なります。

例

次の例では、 PrivateFontCollection オブジェクトを作成し、メソッド呼び出しの状態を確認し、成功した場合はテキストを描画します。

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);
   }
}

要件

要件	値
サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusheaders.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll

こちらもご覧ください

FontCollection

PrivateFontCollection

テキストとフォントの使用