Método FontCollection::GetLastStatus (gdiplusheaders.h)

O método FontCollection::GetLastStatus retorna um valor que indica o resultado da chamada de método anterior desse objeto FontCollection .

Sintaxe

Status GetLastStatus();

Retornar valor

Tipo: Status

O método FontCollection::GetLastStatus retorna um elemento da enumeração Status .

Se o método anterior invocado neste objeto FontCollection for bem-sucedido, FontCollection::GetLastStatus retornará Ok.

Se o método anterior falhou, FontCollection::GetLastStatus retornará um dos outros elementos da enumeração Status que indica a natureza da falha.

Comentários

Você pode chamar FontCollection::GetLastStatus imediatamente após construir um objeto FontCollection para determinar se o construtor foi bem-sucedido. FontCollection::GetLastStatus retornará Ok se o construtor tiver sido bem-sucedido. Caso contrário, ele retornará um valor que indica a natureza da falha.

Observe que a implementação de FontCollection::GetLastStatus nas classes Font e FontCollection é diferente da implementação desse método em outras classes. Além disso, a implementação de FontCollection::GetLastStatus na classe Font é diferente da implementação de FontCollection::GetLastStatus na classe FontCollection .

Exemplos

O exemplo a seguir cria um objeto PrivateFontCollection, verifica o status de uma chamada de método e, se bem-sucedido, desenha texto.

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

   // Create a PrivateFontCollection object, and add three families.
   PrivateFontCollection fontCollection;
   fontCollection.AddFontFile(L"C:\\WINNT\\Fonts\\Arial.ttf");
   fontCollection.AddFontFile(L"C:\\WINNT\\Fonts\\CourBI.ttf");
   fontCollection.AddFontFile(L"C:\\WINNT\\Fonts\\TimesBd.ttf");

   // Create an array to hold the font families, and get the font families of
   // fontCollection.
   FontFamily families[3];
   int numFamilies;
   fontCollection.GetFamilies(3, families, &numFamilies);

   // Verify that the call to GetFamilies was successful.
   Status status = fontCollection.GetLastStatus();

   // If the call was successful, draw text.
   if (status == Ok)
   {
      // Create a Font object from the first FontFamily object in the array.
      Font myFont(&families[0], 16);

      // Use myFont to draw text.
      SolidBrush solidbrush(Color(255, 0, 0, 0));
      WCHAR string[] = L"The call was successful";
      graphics.DrawString(string,
                          23, &myFont, PointF(0, 0), &solidbrush);
   }
}

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho gdiplusheaders.h (inclua Gdiplus.h)
Biblioteca Gdiplus.lib
DLL Gdiplus.dll

Confira também

Fontcollection

Privatefontcollection

Usando texto e fontes