StringFormatFlags 열거형(gdiplusenums.h)

아티클
02/28/2024

StringFormatFlags 열거형은 텍스트 레이아웃 정보(예: 방향 및 클리핑) 및 표시 조작(예: 줄임표 삽입, 숫자 대체 및 글꼴에서 지원되지 않는 문자 표현)을 지정합니다.

Syntax

typedef enum StringFormatFlags {
  StringFormatFlagsDirectionRightToLeft = 0x00000001,
  StringFormatFlagsDirectionVertical = 0x00000002,
  StringFormatFlagsNoFitBlackBox = 0x00000004,
  StringFormatFlagsDisplayFormatControl = 0x00000020,
  StringFormatFlagsNoFontFallback = 0x00000400,
  StringFormatFlagsMeasureTrailingSpaces = 0x00000800,
  StringFormatFlagsNoWrap = 0x00001000,
  StringFormatFlagsLineLimit = 0x00002000,
  StringFormatFlagsNoClip = 0x00004000,
  StringFormatFlagsBypassGDI = 0x80000000
} ;

상수


`StringFormatFlagsDirectionRightToLeft` 값: 0x00000001 읽기 순서가 오른쪽에서 왼쪽으로 되도록 지정합니다. 가로 텍스트의 경우 문자를 오른쪽에서 왼쪽으로 읽습니다. 세로 텍스트의 경우 오른쪽에서 왼쪽으로 열을 읽습니다. 기본적으로 가로 또는 세로 텍스트는 왼쪽에서 오른쪽으로 읽습니다.
`StringFormatFlagsDirectionVertical` 값: 0x00000002 디스플레이 디바이스에서 개별 텍스트 줄이 세로로 그려지게 지정합니다. 기본적으로 텍스트 줄은 가로이며, 각 새 줄은 이전 줄 아래에 있습니다.
`StringFormatFlagsNoFitBlackBox` 값: 0x00000004 문자열의 레이아웃 사각형을 오버행할 수 있도록 문자 부분을 지정합니다. 기본적으로 문자는 먼저 사각형의 경계 내에 정렬된 다음, 경계를 계속 돌출하는 문자는 오버행을 방지하여 레이아웃 사각형 외부의 픽셀에 영향을 주지 않도록 위치가 변경됩니다. 기울임꼴 소문자 F(f)는 돌출 부분이 있을 수 있는 문자의 예입니다. 이 플래그를 설정하면 문자가 위와 아래 선에 시각적으로 정렬되지만 레이아웃 사각형 외부에 있는 문자의 일부가 잘리거나 그려질 수 있습니다.
`StringFormatFlagsDisplayFormatControl` 값: 0x00000020 유니코드 레이아웃 컨트롤 문자가 대표 문자로 표시되도록 지정합니다.
`StringFormatFlagsNoFontFallback` 값: 0x00000400 요청된 글꼴에서 지원되지 않는 문자에 대체 글꼴이 사용되도록 지정합니다. 기본적으로 누락된 문자는 "글꼴 누락" 문자(일반적으로 열린 사각형)로 표시됩니다.
`StringFormatFlagsMeasureTrailingSpaces` 값: 0x00000800 각 줄의 끝에 있는 공간이 문자열 측정에 포함되도록 지정합니다. 기본적으로 경계 사각형은 에서 반환합니다. Graphics::MeasureString 메서드는 각 줄의 끝에 있는 공간을 제외합니다. 측정값에 해당 공간을 포함하도록 이 플래그를 설정합니다.
`StringFormatFlagsNoWrap` 값: 0x00001000 다음 줄로 텍스트 줄 바꿈을 사용하지 않도록 지정합니다. NoWrap은 레이아웃 사각형 대신 원점이 사용될 때 암시됩니다. 기본적으로 사각형 내에서 텍스트를 그릴 때 텍스트는 사각형의 경계 내에 있는 마지막 단어 경계에서 끊어지고 다음 줄로 래핑됩니다.
`StringFormatFlagsLineLimit` 값: 0x00002000 레이아웃 사각형에 전체 줄만 배치되도록 지정합니다. 기본적으로 레이아웃은 텍스트가 끝날 때까지 또는 클리핑의 결과로 더 이상 줄이 표시되지 않을 때까지 계속됩니다. 기본 설정을 사용하면 줄 높이의 전체 배수가 아닌 레이아웃 사각형에 의해 마지막 줄이 부분적으로 가려질 수 있습니다. 전체 선만 표시되도록 하려면 이 플래그를 설정하고 적어도 한 줄의 높이만큼 높은 레이아웃 사각형을 제공해야 합니다.
`StringFormatFlagsNoClip` 값: 0x00004000 레이아웃 사각형을 돌출하는 문자와 레이아웃 사각형 외부로 확장되는 텍스트를 표시할 수 있도록 지정합니다. 기본적으로 레이아웃 사각형 외부로 확장되는 모든 돌출 문자와 텍스트가 잘립니다. 레이아웃 사각형 외부로 확장되는 모든 후행 공백(선 끝에 있는 공백)이 잘립니다. 따라서 후행 공백이 측정에 포함되는 경우 이 플래그의 설정은 문자열 측정에 영향을 미칩니다. 클리핑을 사용하도록 설정하면 레이아웃 사각형 외부로 확장되는 후행 공백이 측정값에 포함되지 않습니다. 클리핑을 사용하지 않도록 설정하면 레이아웃 사각형 외부에 있는지 여부에 관계없이 모든 후행 공백이 측정값에 포함됩니다.
`StringFormatFlagsBypassGDI` 값: 0x80000000

설명

여러 플래그 집합은 결합된 효과를 생성할 수 있습니다.

StringFormatFlagsDirectionVertical 및 StringFormatFlagsDirectionRightToLeft를 모두 설정하면 개별 텍스트 줄이 세로로 그려집니다. 첫 번째 줄은 레이아웃 사각형의 오른쪽 가장자리에서 시작됩니다. 텍스트의 두 번째 줄은 첫 번째 줄의 왼쪽에 있는 등입니다.
StringFormatFlagsDirectionVertical이 설정되고 StringFormatFlagsDirectionRightToLeft가 설정되지 않은 경우 개별 텍스트 줄이 세로로 그려집니다. 첫 번째 줄은 레이아웃 사각형의 왼쪽 가장자리에서 시작됩니다. 텍스트의 두 번째 줄은 첫 번째 줄의 오른쪽에 있습니다.
StringFormatFlagsDirectionRightToLeft가 설정되고 StringFormatFlagsDirectionVertical이 설정되지 않은 경우 텍스트의 개별 줄은 가로이고 읽기 순서는 오른쪽에서 왼쪽으로 지정됩니다. 이 설정은 문자가 표시되는 순서를 변경하지 않고 단순히 문자를 읽을 수 있는 순서를 지정합니다.

StringFormatFlagsDirectionVertical 및 StringFormatFlagsDirectionRightToLeft 플래그는 문자열 맞춤에 영향을 줄 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	gdiplusenums.h(Gdiplus.h 포함)