Pen::GetLastStatus メソッド (gdipluspen.h)
Pen::GetLastStatus メソッドは、この Pen オブジェクトの最新のメソッドエラーの性質を示す値を返します。
構文
Status GetLastStatus();
戻り値
種類: 状態
Pen::GetLastStatus メソッドは、Status 列挙の要素を返します。
Pen::GetLastStatus の前回の呼び出し以降に、この Pen オブジェクトで呼び出されたメソッドが失敗しなかった場合、Pen::GetLastStatus は OK を返します。
Pen::GetLastStatus の前回の呼び出し以降に、この Pen オブジェクトで呼び出されたメソッドが少なくとも 1 つ失敗した場合、Pen::GetLastStatus は最新のエラーの性質を示す値を返します。
注釈
Pen::GetLastStatus は、Pen オブジェクトを構築した直後に呼び出して、コンストラクターが成功したかどうかを判断できます。
Pen オブジェクトの Pen::GetLastStatus メソッドを初めて呼び出すと、コンストラクターが成功し、Pen オブジェクトでこれまでに呼び出されたすべてのメソッドが成功した場合、Ok が返されます。 それ以外の場合は、最新のエラーの性質を示す値を返します。
例
次の例では、 Pen オブジェクトを作成し、破線のスタイルを設定し、破線を描画します。 次に、ペンのダッシュ スタイルを設定するメソッドの状態を確認します。
VOID Example_GetLastStatus(HDC hdc)
{
Graphics graphics(hdc);
// Create a pen.
Pen pen(Color(255, 255, 0, 0), 5);
// Set the dash style, and draw a dashed line.
pen.SetDashStyle(DashStyleDash);
graphics.DrawLine(&pen, 0, 0, 200, 100);
// Check the status of the method that sets the dash style for the pen.
Status status = pen.GetLastStatus();
if(status == Ok)
{
// The call to SetDashStyle was successful.
}
else
{
// There was a problem with the call to SetDashStyle.
}
}
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP、Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | gdipluspen.h (Gdiplus.h を含む) |
Library | Gdiplus.lib |
[DLL] | Gdiplus.dll |