다음을 통해 공유


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

서식 있는 편집 컨트롤의 단락 서식 특성에 대한 정보를 포함합니다. PARAFORMAT2PARAFORMAT 구조의 Microsoft Rich Edit 2.0 확장입니다. Microsoft Rich Edit 2.0을 사용하면 EM_GETPARAFORMATEM_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, wBorderWidthwBorders 멤버가 유효합니다.
PFM_LINESPACING
dyLineSpacingbLineSpacingRule 멤버가 유효합니다.
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
wShadingWeightwShadingStyle 멤버는 유효합니다.
PFM_SPACEAFTER
dySpaceAfter 멤버가 유효합니다.
PFM_SPACEBEFORE
dySpaceBefore 멤버가 유효합니다.
PFM_STARTINDENT
dxStartIndent 멤버는 유효하며 왼쪽 여백에서 들여쓰기를 지정합니다. PFM_STARTINDENT 및 PFM_OFFSETINDENT 모두 지정되면 PFM_STARTINDENT 우선합니다.
PFM_STYLE
sStyle 멤버가 유효합니다.
PFM_TABSTOPS
cTabCountrgxTabs 멤버는 유효합니다.
 

다음 값을 설정하여 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