Brush::GetLastStatus メソッド (gdiplusbrush.h)

[アーティクル]
03/05/2024

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

構文

Status GetLastStatus();

戻り値

種類: 状態

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

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

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

注釈

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

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

例

次の例では、 SolidBrush オブジェクト solidBrush を作成し、 solidBrush の作成に使用される呼び出しの状態を確認します。その後、呼び出しが成功した場合、コードは solidBrush を使用して四角形を塗りつぶします。

VOID Example_GetLastStatus(HDC hdc)
{
   Graphics graphics(hdc);
   // Create a SolidBrush object.
   SolidBrush solidBrush(Color(255, 0, 255, 0));
   // Get the status of the last call.
   Status lastStatus = solidBrush.GetLastStatus();
   //If the call to create myBrush was successful, use it to fill a rectangle.
   if (lastStatus == Ok)
       graphics.FillRectangle(&solidBrush, Rect(0, 0, 100, 100)); 
}

要件

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