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

  • [アーティクル]

Font::GetLastStatus メソッドは、この Font オブジェクトの最新のメソッドエラーの性質を示す値を返します。

構文

Status GetLastStatus();

戻り値

種類: 状態

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

この Font オブジェクトで呼び出されたメソッドが失敗しなかった場合、 Font::GetLastStatus は OK を返します。

この Font オブジェクトで呼び出されたメソッドが少なくとも 1 つ失敗した場合、 Font::GetLastStatus は最新のエラーの性質を示す値を返します。

解説

Font::GetLastStatus は、Font オブジェクトを構築した直後に呼び出して、コンストラクターが成功したかどうかを判断できます。

Font オブジェクトの Font::GetLastStatus メソッドを初めて呼び出すと、コンストラクターが成功し、Font オブジェクトでこれまでに呼び出されたすべてのメソッドが成功した場合、Ok が返されます。 それ以外の場合は、最新のエラーの性質を示す値を返します。

例

次の例では、 Font オブジェクトを作成し、オブジェクトを作成するための呼び出しが成功したことを確認し、作成された場合は Font オブジェクトを使用してテキストを描画します。

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

   // Create a Font object.
   Font myFont(L"Arial", 16);

   // Check the status of the last call.
   Status status = myFont.GetLastStatus();

   // If the call to create myFont succeeded, use myFont to write text.
   if (status == Ok)
   {
       SolidBrush solidbrush(Color(255, 0, 0, 0));
       WCHAR      string[] = L"The call succeeded";
       graphics.DrawString(string, 18, &myFont, PointF(0, 0), &solidbrush);
   }
}

要件

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

関連項目

フォント

Font::IsAvailable

グラフィックス

状態

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