GDI+: GdipGetStringFormatLineAlign

[José Roca]

The following example creates a StringFormat object, sets the string's line alignment, and then gets the line alignment setting and stores it in a variable. The code then creates a second StringFormat object and uses the stored alignment value to set the line alignment of the second StringFormat object. Next, the code uses the second StringFormat object to draw a formatted string. The code also draws the string's layout rectangle.

C++

Code Select Expand


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

   SolidBrush  solidBrush(Color(255, 255, 0, 0));
   FontFamily  fontFamily(L"Times New Roman");
   Font        font(&fontFamily, 24, FontStyleRegular, UnitPixel);
   
   // Create a StringFormat object, and set its line alignment.
   StringFormat stringFormat;
   stringFormat.SetLineAlignment(StringAlignmentCenter);

   // Get the line alignment setting from the StringFormat object.
   StringAlignment stringAlignment = stringFormat.GetLineAlignment();

   // Create a second StringFormat object with the same line alignment.
   StringFormat stringFormat2;
   stringFormat2.SetLineAlignment(stringAlignment);

   // Use the second StringFormat object in a call to DrawString.
   graphics.DrawString(
      L"This text was formatted by a second StringFormat object.",
      56,  // string length
      &font,
      RectF(30, 30, 150, 200),
      &stringFormat2,
      &solidBrush);

   // Draw the rectangle that encloses the text.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawRectangle(&pen, 30, 30, 150, 200);
}


PowerBASIC

Code Select Expand


SUB GDIP_GdipGetStringFormatLineAlign (BYVAL hdc AS DWORD)

   LOCAL hStatus AS LONG
   LOCAL pGraphics AS DWORD
   LOCAL pPen AS DWORD
   LOCAL pFont AS DWORD
   LOCAL pFontFamily AS DWORD
   LOCAL pStringFormat AS DWORD
   LOCAL pStringFormat2 AS DWORD
   LOCAL pSolidBrush AS DWORD
   LOCAL stringAlignment AS LONG
   LOCAL strFontName AS STRING
   LOCAL strText AS STRING
   LOCAL rcf AS RECTF

   hStatus = GdipCreateFromHDC(hdc, pGraphics)

   ' // Create a solid brush
   hStatus = GdipCreateSolidFill(GDIP_ARGB(255, 255, 0, 0), pSolidBrush)

   ' // Create the font
   strFontName = UCODE$("Times New Roman")
   hStatus = GdipCreateFontFamilyFromName(STRPTR(strFontName), %NULL, pFontFamily)
   IF hStatus = %StatusOk AND pFontFamily <> %NULL THEN
      hStatus = GdipCreateFont(pFontFamily, 24, %FontStyleRegular, %UnitPoint, pFont)
      GdipDeleteFontFamily(pFontFamily)
   END IF

   ' Note: You can use the wrapper function GdiPlusCreateFontFromName to create the font:
   ' hStatus = GdiPlusCreateFontFromName("Times New Roman", 24, %FontStyleRegular, %UnitPoint, pFont)

   ' // Create a StringFormat object, and set its line alignment.
   hStatus = GdipCreateStringFormat(0, %LANG_NEUTRAL, pStringFormat)
   hStatus = GdipSetStringFormatLineAlign(pStringFormat, %StringAlignmentCenter)

   ' // Get the line alignment setting from the StringFormat object.
   hStatus = GdipGetStringFormatLineAlign(pStringFormat, stringAlignment)

   ' // Create a second StringFormat object with the same line alignment.
   hStatus = GdipCreateStringFormat(0, %LANG_NEUTRAL, pStringFormat2)
   hStatus = GdipSetStringFormatLineAlign(pStringFormat, stringAlignment)

   ' // Use the second StringFormat object in a call to DrawString.
   rcf.x = 30 : rcf.y = 30 : rcf.Width = 150 : rcf.Height = 200
   strText = UCODE$("This text was formatted by a second StringFormat object.")
   hStatus = GdipDrawString(pGraphics, STRPTR(strText), LEN(strText) \ 2, pFont, rcf, pStringFormat2, pSolidBrush)

   ' // Draw the rectangle that encloses the text.
   hStatus = GdipCreatePen1(GDIP_ARGB(255, 255, 0, 0), 1, %UnitPixel, pPen)
   hStatus = GdipDrawRectangle(pGraphics, pPen, rcf.x, rcf.y, rcf.Width, rcf.Height)

   ' // Cleanup
   IF pFont THEN GdipDeleteFont(pFont)
   IF pSolidBrush THEN GdipDeleteBrush(pSolidBrush)
   IF pPen THEN GdipDeletePen(pPen)
   IF pStringFormat2 THEN GdipDeleteStringFormat(pStringFormat2)
   IF pStringFormat THEN GdipDeleteStringFormat(pStringFormat)
   IF pGraphics THEN GdipDeleteGraphics(pGraphics)

END SUB


The following illustration shows the output of the preceding code.