PARAFORMAT2 구조체(서식 있는 편집 2.0)

아티클
08/15/2024

서식 있는 편집 컨트롤의 단락 서식 특성에 대한 정보를 포함합니다. PARAFORMAT2PARAFORMAT 구조의 Microsoft Rich Edit 2.0 확장입니다. Microsoft Rich Edit 2.0을 사용하면 EM_GETPARAFORMAT 및 EM_SETPARAFORMAT 메시지와 함께 구조를 사용할 수 있습니다.

통사론

typedef struct _paraformat2 {
  UINT  cbSize;
  DWORD dwMask;
  WORD  wNumbering;
  union {
    WORD wReserved;
    WORD wEffects;
  };
  LONG  dxStartIndent;
  LONG  dxRightIndent;
  LONG  dxOffset;
  WORD  wAlignment;
  SHORT cTabCount;
  LONG  rgxTabs[MAX_TAB_STOPS];
  LONG  dySpaceBefore;
  LONG  dySpaceAfter;
  LONG  dyLineSpacing;
  SHORT sStyle;
  BYTE  bLineSpacingRule;
  BYTE  bOutlineLevel;
  WORD  wShadingWeight;
  WORD  wShadingStyle;
  WORD  wNumberingStart;
  WORD  wNumberingStyle;
  WORD  wNumberingTab;
  WORD  wBorderSpace;
  WORD  wBorderWidth;
  WORD  wBorders;
} PARAFORMAT2;

회원

cbSize

형식: UINT

구조체 크기(바이트)입니다. 이 구조를 풍부한 편집 컨트롤에 전달하기 전에 cbSizePARAFORMAT 또는 PARAFORMAT2 구조체의 크기로 설정합니다. cbSizePARAFORMAT 구조체의 크기와 같으면 컨트롤은 PARAFORMAT 멤버만 사용합니다.

dwMask

형식: DWORD

유효한 정보를 포함하는 PARAFORMAT2 구조체의 멤버입니다. dwMask 멤버는 두 비트 플래그 집합의 값 조합일 수 있습니다. 하나의 집합은 유효한 구조체 멤버를 나타냅니다. 다른 집합은 wEffects 멤버의 유효한 특성을 나타냅니다.

유효한 구조체 멤버를 나타내려면 다음 값을 설정합니다.

값	의미
PFM_ALIGNMENT	wAlignment 멤버가 유효합니다.
PFM_ALL	PFM_STARTINDENT, PFM_RIGHTINDENT, PFM_OFFSET, PFM_ALIGNMENT, PFM_TABSTOPS, PFM_NUMBERING, PFM_OFFSETINDENT 및 PFM_RTLPARA 조합합니다.
PFM_ALL2	PFM_ALL, PFM_EFFECTS, PFM_SPACEBEFORE, PFM_SPACEAFTER, PFM_LINESPACING, PFM_STYLE, PFM_SHADING, PFM_BORDER, PFM_NUMBERINGTAB, PFM_NUMBERINGSTART 및 PFM_NUMBERINGSTYLE 조합합니다.
PFM_BORDER	wBorderSpace, wBorderWidth및 wBorders 멤버가 유효합니다.
PFM_LINESPACING	dyLineSpacing 및 bLineSpacingRule 멤버가 유효합니다.
PFM_NUMBERING	wNumbering 멤버가 유효합니다.
PFM_NUMBERINGSTART	wNumberingStart 멤버가 유효합니다.
PFM_NUMBERINGSTYLE	wNumberingStyle 멤버가 유효합니다.
PFM_NUMBERINGTAB	wNumberingTab 멤버가 유효합니다.
PFM_OFFSET	dxOffset 멤버가 유효합니다.
PFM_OFFSETINDENT	dxStartIndent 멤버가 유효합니다. 들여쓰기를 설정하는 경우 dxStartIndent 현재 들여쓰기를 기준으로 들여쓰기 크기를 지정합니다.
PFM_OUTLINELEVEL	bOutlineLevel 멤버가 유효합니다.
PFM_RIGHTINDENT	dxRightIndent 멤버가 유효합니다.
PFM_SHADING	wShadingWeight 및 wShadingStyle 멤버는 유효합니다.
PFM_SPACEAFTER	dySpaceAfter 멤버가 유효합니다.
PFM_SPACEBEFORE	dySpaceBefore 멤버가 유효합니다.
PFM_STARTINDENT	dxStartIndent 멤버는 유효하며 왼쪽 여백에서 들여쓰기를 지정합니다. PFM_STARTINDENT 및 PFM_OFFSETINDENT 모두 지정되면 PFM_STARTINDENT 우선합니다.
PFM_STYLE	sStyle 멤버가 유효합니다.
PFM_TABSTOPS	cTabCount 및 rgxTabs 멤버는 유효합니다.

다음 값을 설정하여 wEffects 멤버의 유효한 특성을 나타냅니다.

값	의미
PFM_DONOTHYPHEN	PFE_DONOTHYPHEN 값이 유효합니다.
PFM_EFFECTS	PFM_RTLPARA, PFM_KEEP, PFM_KEEPNEXT, PFM_TABLE, PFM_PAGEBREAKBEFORE, PFM_NOLINENUMBER, PFM_NOWIDOWCONTROL, PFM_DONOTHYPHEN, PFM_SIDEBYSIDE 및 PFM_TABLEROWDELIMITER 조합합니다.
PFM_KEEP	PFE_KEEP 값이 유효합니다.
PFM_KEEPNEXT	PFE_KEEPNEXT 값이 유효합니다.
PFM_NOLINENUMBER	PFE_NOLINENUMBER 값이 유효합니다.
PFM_NOWIDOWCONTROL	PFE_NOWIDOWCONTROL 값이 유효합니다.
PFM_PAGEBREAKBEFORE	PFE_PAGEBREAKBEFORE 값이 유효합니다.
PFM_RTLPARA	PFE_RTLPARA 값이 유효합니다.
PFM_SIDEBYSIDE	PFE_SIDEBYSIDE 값이 유효합니다.
PFM_TABLE	PFE_TABLE 값이 유효합니다.
PFM_TABLEROWDELIMITER	PFE_TABLEROWDELIMITER 값이 유효합니다.

wNumbering

형식: WORD

글머리 기호 또는 번호 매기기 단락에 사용되는 옵션입니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_NUMBERING 플래그를 설정합니다.

이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
0	단락 번호 매기기 또는 글머리 기호가 없습니다.
PFN_BULLET	선택한 각 단락의 시작 부분에 글머리 기호를 삽입합니다.

버전 3.0 이전의 리치 편집 버전에는 단락 번호가 표시되지 않습니다. 그러나 TOM(Microsoft Text Object Model) 인터페이스와의 호환성을 위해 wNumbering 다음 값 중 하나를 지정할 수 있습니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.

값	의미
PFN_ARABIC	아랍어 번호(0, 1, 2 등)를 사용합니다.
PFN_LCLETTER	소문자(a, b, c 등)를 사용합니다.
PFN_LCROMAN	소문자 로마 문자(i, ii, iii 등)를 사용합니다.
PFN_UCLETTER	대문자(A, B, C 등)를 사용합니다.
PFN_UCROMAN	대문자 로마 문자(I, II, III 등)를 사용합니다.
7	wNumberingStart 멤버에서 지정한 유니코드 문자로 시작하는 문자 시퀀스를 사용합니다.

wReserved

wEffects

형식: WORD

이 멤버는 예약되었기 때문에 Microsoft Rich Edit 1.0에 대한 wReserved라고도 합니다.

Rich Edit 1.0: Reserved; 값은 0이어야 합니다.

서식 있는 편집 2.0: 단락 효과를 지정하는 비트 플래그 집합입니다. 이러한 플래그는 TOM 인터페이스와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.

이 멤버는 다음 값의 조합일 수 있습니다.

값	의미
PFE_DONOTHYPHEN	자동 하이픈 넣기를 사용하지 않도록 설정합니다.
PFE_KEEP	단락 내에 페이지 나누기가 없습니다.
PFE_KEEPNEXT	이 단락과 다음 단락 사이에 페이지 나누기가 없습니다.
PFE_NOLINENUMBER	줄 번호 매기기(구현되지 않음)를 사용하지 않도록 설정합니다.
PFE_NOWIDOWCONTROL	선택한 단락에 대해 과부 및 분리 컨트롤을 사용하지 않도록 설정합니다.
PFE_PAGEBREAKBEFORE	선택한 단락 앞에 페이지 나누기를 삽입합니다.
PFE_RTLPARA	오른쪽에서 왼쪽으로 읽기 순서를 사용하여 텍스트를 표시합니다(서식 있는 편집 2.1 이상).
PFE_SIDEBYSIDE	단락을 나란히 표시합니다(구현되지 않음).
PFE_TABLE	단락이 표 행입니다.
PFE_TABLEROWDELIMITER	단락은 표에 있는 행의 시작 구분 기호(U+FFF9 U+000D) 또는 끝 구분 기호(U+FFFB U+000D)입니다.

dxStartIndent

형식: LONG

단락의 첫 줄 들여쓰기(트윅)입니다. 후속 줄 들여쓰기 dxOffset 멤버에 따라 다릅니다. dxStartIndent 멤버를 사용하려면 dwMask 멤버에서 PFM_STARTINDENT 또는 PFM_OFFSETINDENT 플래그를 설정합니다. 들여쓰기를 설정하는 경우 PFM_STARTINDENT 플래그를 사용하여 왼쪽 여백에서 절대 들여쓰기를 지정합니다. 또는 PFM_OFFSETINDENT 플래그를 사용하여 단락의 현재 들여쓰기를 기준으로 들여쓰기를 지정합니다. 두 플래그 중 하나를 사용하여 현재 들여쓰기를 검색합니다.

dxRightIndent

형식: LONG

오른쪽 여백을 기준으로 단락 오른쪽의 들여쓰기(twips)입니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_RIGHTINDENT 플래그를 설정합니다.

dxOffset

형식: LONG

첫 번째 줄의 들여쓰기를 기준으로 두 번째 줄과 후속 줄의 들여쓰기(twips)입니다. 이 멤버가 음수이면 첫 번째 줄이 들여쓰기되거나 이 멤버가 양수이면 들여쓰기됩니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_OFFSET 플래그를 설정합니다.

wAlignment

형식: WORD

단락 맞춤입니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_ALIGNMENT 플래그를 설정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
PFA_LEFT	단락은 왼쪽 여백에 맞춥니다.
PFA_RIGHT	단락은 오른쪽 여백에 맞춥니다.
PFA_CENTER	단락의 가운데가 지정됩니다.
PFA_JUSTIFY	RichEdit 2.0:단락이 정당화됩니다. RichEdit 3.0 이전의 서식 있는 편집 컨트롤은 왼쪽 여백에 맞춰 정렬된 텍스트를 표시합니다.
PFA_FULL_INTERWORD	단락은 공백만 확장하여 양쪽으로 정렬됩니다.

cTabCount

형식: SHORT

rgxTabs 배열에 정의된 탭 중지 횟수입니다.

rgxTabs[MAX_TAB_STOPS]

형식: LONG

절대 탭 중지 위치의 배열입니다. 배열의 각 요소는 탭 정지에 대한 정보를 지정합니다. 24개의 하위 비트는 절대 오프셋을 트윅 단위로 지정합니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_TABSTOPS 플래그를 설정합니다.

Rich Edit 2.0: TOM 인터페이스와의 호환성을 위해 8개의 상위 비트를 사용하여 각 탭 정지에 대한 추가 정보를 저장할 수 있습니다.

비트 24-27은 탭 맞춤을 나타내기 위해 다음 값 중 하나를 지정할 수 있습니다. 이러한 비트는 Microsoft Rich Edit 3.0 이전 버전의 서식 있는 편집 컨트롤 디스플레이에 영향을 미치지 않습니다.

값	의미
0	일반 탭
1	가운데 탭
2	오른쪽 맞춤 탭
3	10진수 탭
4	Word 막대 탭(세로 막대)

비트 28-31은 탭 지시선의 유형을 나타내기 위해 다음 값 중 하나를 지정할 수 있습니다. 이러한 비트는 서식 있는 편집 컨트롤 표시에 영향을 미치지 않습니다.

값	의미
0	리더 없음
1	점선 지시선
2	파선 지시선
3	밑줄이 그은 리더
4	두꺼운 선 지시선
5	이중 선 지시선

dySpaceBefore

형식: LONG

단락 위의 간격 크기(트윅)입니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_SPACEBEFORE 플래그를 설정합니다. 값은 0보다 크거나 같아야 합니다.

dySpaceAfter

형식: LONG

단락 아래 간격의 크기를 트윅 단위로 지정합니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_SPACEAFTER 플래그를 설정합니다. 값은 0보다 크거나 같아야 합니다.

dyLineSpacing

형식: LONG

선 사이의 간격입니다. 이 값을 해석하는 방법에 대한 설명은 bLineSpacingRule 멤버를 참조하세요. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_LINESPACING 플래그를 설정합니다.

sStyle

형식: SHORT

텍스트 스타일입니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_STYLE 플래그를 설정합니다. 이 멤버는 TOM 인터페이스 및 Word와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.

bLineSpacingRule

형식: BYTE

줄 간격의 유형입니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_LINESPACING 플래그를 설정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
0	단일 간격입니다. dyLineSpacing 멤버는 무시됩니다.
1	1-반 간격. dyLineSpacing 멤버는 무시됩니다.
2	이중 간격입니다. dyLineSpacing 멤버는 무시됩니다.
3	dyLineSpacing 멤버는 한 줄에서 다음 줄까지의 간격을 트윅 단위로 지정합니다. 그러나 dyLineSpacing 단일 간격보다 작은 값을 지정하는 경우 컨트롤은 단일 간격 텍스트를 표시합니다.
4	dyLineSpacing 멤버는 한 줄에서 다음 줄 사이의 간격을 트윅 단위로 지정합니다. 이 컨트롤은 dyLineSpacing 단일 간격보다 작은 값을 지정하는 경우에도 지정된 정확한 간격을 사용합니다.
5	dyLineSpacing/20의 값은 한 줄에서 다음 줄 사이의 간격입니다. 따라서 dyLineSpacing 20으로 설정하면 단일 간격 텍스트가 생성되고, 40은 이중 간격, 60은 3배 간격이 지정됩니다.

bOutlineLevel

형식: BYTE

예약; 은 0이어야 합니다.

wShadingWeight

형식: WORD

음영에 사용되는 백분율 전경색입니다. wShadingStyle 멤버는 전경 및 배경 음영 색을 지정합니다. 값이 5이면 전경색 5%와 배경색 95%로 구성된 음영 색을 나타냅니다. 이러한 멤버를 사용하려면 dwMask 멤버에서 PFM_SHADING 플래그를 설정합니다. 이 멤버는 Word와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.

wShadingStyle

형식: WORD

배경 음영에 사용되는 스타일 및 색입니다. 비트 0에서 3은 음영 스타일을 포함하고, 비트 4~7에는 전경색 인덱스가 포함되고, 비트 8~11에는 배경색 인덱스가 포함됩니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_SHADING 플래그를 설정합니다. 이 멤버는 Word와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.

음영 스타일은 다음 값 중 하나일 수 있습니다.

값	의미
0	없음
1	어두운 가로
2	어두운 세로
3	어두운 아래쪽 대각선
4	대각선 어둡게
5	어두운 눈금
6	어두운 격자선
7	가로로 밝게
8	연한 세로
9	조명 아래로 대각선
10	대각선 켜기
11	라이트 그리드
12	밝은 격자선

전경색 및 배경색 인덱스는 다음 값 중 하나일 수 있습니다.

값	의미
0	검정
1	파랑
2	청록색
3	녹색
4	자홍색
5	빨강
6	황색
7	하얀
8	감색
9	진한 시안색
10	진한 녹색
11	어두운 자홍색
12	진한 빨간색
13	진한 노랑
14	진한 회색
15	연한 회색

wNumberingStart

형식: WORD

번호 매기기 단락에 사용되는 시작 번호 또는 유니코드 값입니다. 이 멤버를 wNumbering 멤버와 함께 사용합니다. 이 멤버는 TOM 인터페이스와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트 또는 글머리 기호를 표시하는 데는 사용하지 않습니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_NUMBERINGSTART 플래그를 설정합니다.

wNumberingStyle

형식: WORD

번호 매기기 단락에 사용되는 번호 매기기 스타일입니다. 이 멤버를 wNumbering 멤버와 함께 사용합니다. 이 멤버는 TOM 인터페이스와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 3.0 이전의 서식 있는 편집 버전은 텍스트 또는 글머리 기호를 표시하는 데 사용하지 않습니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_NUMBERINGSTYLE 플래그를 설정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
PFNS_PAREN	오른쪽 괄호가 있는 숫자를 따릅니다.
PFNS_PARENS	숫자를 괄호로 묶습니다.
PFNS_PERIOD	마침표가 있는 숫자를 따릅니다.
PFNS_PLAIN	숫자만 표시합니다.
PFNS_NONUMBER	다음 번호 또는 글머리 기호를 적용하지 않고 번호 매기기 목록을 계속합니다.
PFNS_NEWNUMBER	wNumberingStart새 숫자를 시작합니다.

wNumberingTab

형식: WORD

단락 번호와 단락 텍스트 사이의 최소 간격(twips)입니다. 이 멤버를 wNumbering 멤버와 함께 사용합니다. wNumberingTab 멤버는 TOM 인터페이스와의 호환성을 위해 포함됩니다. 이전에 Microsoft Rich Edit 3.0에서 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_NUMBERINGTAB 플래그를 설정합니다.

wBorderSpace

형식: WORD

테두리와 단락 텍스트 사이의 간격(트윅)입니다. wBorderSpace 멤버는 Word와의 호환성을 위해 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_BORDER 플래그를 설정합니다.

wBorderWidth

형식: WORD

테두리 너비(트wips)입니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_BORDER 플래그를 설정합니다.

wBorders

형식: WORD

테두리 위치, 스타일 및 색입니다. 비트 0~7은 테두리 위치를 지정하고, 비트 8~11은 테두리 스타일을 지정하고, 비트 12~15는 테두리 색 인덱스를 지정합니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_BORDER 플래그를 설정합니다.

비트 0에서 7로 다음 값의 조합을 사용하여 테두리 위치를 지정합니다.

값	의미
1	왼쪽 테두리입니다.
2	오른쪽 테두리입니다.
4	위쪽 테두리입니다.
8	아래쪽 테두리입니다.
16	테두리 내부.
32	바깥쪽 테두리.
64	자동 칠하기 이 비트를 설정하면 비트 12~15의 색 인덱스가 사용되지 않습니다.

비트 8에서 11에 대해 다음 값 중 하나를 사용하여 테두리 스타일을 지정합니다.

값	의미
0	없음
1	3/4 지점
2	11/2 지점
3	21/4 지점
4	3점
5	41/2 지점
6	6포인트
7	3/4 포인트 더블
8	11/2 포인트 double
9	21/4 포인트 더블
10	3/4 포인트 회색
11	3/4 점 회색 파선

12~15비트에서 다음 값 중 하나를 사용하여 테두리 색을 지정합니다. 자동 칠하기 비트(비트 6)가 설정된 경우 이 값은 무시됩니다.

값	의미
0	검정
1	파랑
2	청록색
3	녹색
4	자홍색
5	빨강
6	황색
7	하얀
8	감색
9	진한 시안색
10	진한 녹색
11	어두운 자홍색
12	진한 빨간색
13	진한 노랑
14	진한 회색
15	연한 회색

요구 사항

요구	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	richedit.h

참고 항목

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT

다음을 통해 공유

PARAFORMAT2 구조체(서식 있는 편집 2.0)

통사론

회원

요구 사항

참고 항목

피드백

추가 리소스