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

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

構文

Status GetLastStatus();

戻り値

種類: 状態

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

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

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

解説

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

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

例

次の例では、パスからリージョンを作成します。 次に、コードは Region::GetBounds メソッドを呼び出し、その後に Region::GetDataSize を呼び出します。 次に、このコードは Region::GetLastStatus を呼び出します。 この時点まですべてのメソッド呼び出しが成功した場合、 Region::GetLastStatus は OK を返します。

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

   Point points[] = {
      Point(110, 20),
      Point(120, 30),
      Point(100, 60),
      Point(120, 70),
      Point(150, 60),
      Point(140, 10)};

   Rect rect;
   UINT size;
   GraphicsPath path;

   path.AddClosedCurve(points, 6);

   // Create a region from a path.
   Region pathRegion(&path);    

   pathRegion.GetBounds(&rect, &graphics);
   size = pathRegion.GetDataSize();

   if(pathRegion.GetLastStatus() == Ok)
   {
       // All methods called thus far have been successful.
   }
}

要件

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