FontFamily::GetLastStatus メソッド (gdiplusheaders.h)
FontFamily::GetLastStatus メソッドは、この FontFamily オブジェクトの最新のメソッドエラーの性質を示す値を返します。
構文
Status GetLastStatus();
戻り値
種類: 状態
FontFamily::GetLastStatus メソッドは Status 列挙体の要素を返します。
この FontFamily オブジェクトで呼び出されたメソッドが FontFamily::GetLastStatus の前回の呼び出し以降に失敗した場合、 FontFamily::GetLastStatus は Ok を返します。
FontFamily::GetLastStatus の前回の呼び出し以降に、この FontFamily オブジェクトで呼び出されたメソッドが少なくとも 1 つ失敗した場合、FontFamily::GetLastStatus は最新のエラーの性質を示す値を返します。
注釈
FontFamily オブジェクトを構築した直後に FontFamily::GetLastStatus を呼び出して、コンストラクターが成功したかどうかを判断できます。
FontFamily オブジェクトの FontFamily::GetLastStatus メソッドを初めて呼び出すと、コンストラクターが成功し、FontFamily オブジェクトでこれまでに呼び出されたすべてのメソッドが成功した場合、Ok が返されます。 それ以外の場合は、最新のエラーの性質を示す値を返します。
例
次の例では 、FontFamily オブジェクトを作成し、呼び出しの状態を確認してオブジェクトを作成します。 呼び出しが成功した場合は、テキストを描画します。
VOID Example_GetLastStatus(HDC hdc)
{
Graphics graphics(hdc);
// Create a FontFamily object.
FontFamily myFontFamily(L"arial");
// Check the status of the last call.
Status status = myFontFamily.GetLastStatus();
// If the last call succeeded, draw text.
if (status ==Ok)
{
SolidBrush solidbrush(Color(255, 0, 0, 0));
Font font(&myFontFamily, 16);
WCHAR string[] = L"status = Ok";
graphics.DrawString(string, -1, &font, PointF(0, 0), &solidbrush);
}
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP、Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | gdiplusheaders.h (Gdiplus.h を含む) |
| Library | Gdiplus.lib |
| [DLL] | Gdiplus.dll |