PARAFORMAT2 구조체(서식 있는 편집 2.0)
서식 있는 편집 컨트롤의 단락 서식 특성에 대한 정보를 포함합니다. 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
구조체 크기(바이트)입니다. 이 구조를 풍부한 편집 컨트롤에 전달하기 전에 cbSize 를 PARAFORMAT 또는 PARAFORMAT2 구조체의 크기로 설정합니다. cbSize가 PARAFORMAT 구조체의 크기와 같으면 컨트롤은 PARAFORMAT 멤버만 사용합니다.
dwMask
형식: DWORD
유효한 정보를 포함하는 PARAFORMAT2 구조체의 멤버입니다. dwMask 멤버는 두 비트 플래그 집합의 값 조합일 수 있습니다. 하나의 집합은 유효한 구조체 멤버를 나타냅니다. 또 다른 집합은 wEffects 멤버의 유효한 특성을 나타냅니다.
유효한 구조체 멤버를 나타내려면 다음 값을 설정합니다.
wEffects 멤버의 유효한 특성을 나타내려면 다음 값을 설정합니다.
wNumbering
형식: WORD
글머리 기호 또는 번호 매기기 단락에 사용되는 옵션입니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_NUMBERING 플래그를 설정합니다.
이 멤버는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
단락 번호 매기기 또는 글머리 기호가 없습니다. |
|
선택한 각 단락의 시작 부분에 글머리 기호를 삽입합니다. |
버전 3.0 이전의 서식 있는 편집 버전에는 단락 번호가 표시되지 않습니다. 그러나 TOM(Microsoft Text Object Model ) 인터페이스와의 호환성을 위해 wNumbering 은 다음 값 중 하나를 지정할 수 있습니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.
wReserved
wEffects
형식: WORD
이 멤버는 예약되었기 때문에 Microsoft Rich Edit 1.0용 wReserved 라고도 합니다.
리치 편집 1.0: 예약; 값은 0이어야 합니다.
리치 편집 2.0: 단락 효과를 지정하는 비트 플래그 집합입니다. 이러한 플래그는 TOM 인터페이스와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.
이 멤버는 다음 값의 조합일 수 있습니다.
dxStartIndent
형식: LONG
단락의 첫 줄 들여쓰기(twips)입니다. 후속 줄의 들여쓰기 는 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 플래그를 설정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
cTabCount
형식: SHORT
rgxTabs 배열에 정의된 탭 중지 횟수입니다.
rgxTabs[MAX_TAB_STOPS]
형식: LONG
절대 탭 중지 위치의 배열입니다. 배열의 각 요소는 탭 정지에 대한 정보를 지정합니다. 24개의 하위 비트는 절대 오프셋을 트윅 단위로 지정합니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_TABSTOPS 플래그를 설정합니다.
리치 편집 2.0: TOM 인터페이스와의 호환성을 위해 8개의 상위 비트를 사용하여 각 탭 정지에 대한 추가 정보를 저장할 수 있습니다.
비트 24-27은 탭 맞춤을 나타내기 위해 다음 값 중 하나를 지정할 수 있습니다. 이러한 비트는 Microsoft Rich Edit 3.0 이전 버전의 서식 있는 편집 컨트롤 디스플레이에 영향을 미치지 않습니다.
| 값 | 의미 |
|---|---|
|
일반 탭 |
|
가운데 탭 |
|
오른쪽 맞춤 탭 |
|
10진수 탭 |
|
Word 막대 탭(세로 막대) |
비트 28-31은 탭 리더의 유형을 나타내기 위해 다음 값 중 하나를 지정할 수 있습니다. 이러한 비트는 서식 있는 편집 컨트롤 디스플레이에 영향을 미치지 않습니다.
| 값 | 의미 |
|---|---|
|
리더 없음 |
|
점선 리더 |
|
파선 리더 |
|
밑줄이 그은 리더 |
|
굵은 선 리더 |
|
이중 선 리더 |
dySpaceBefore
형식: LONG
단락 위의 간격 크기(twips)입니다. 이 멤버를 사용하려면 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 플래그를 설정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
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 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.
음영 스타일은 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
없음 |
|
어두운 가로 |
|
어두운 세로 |
|
어두운 아래쪽 대각선 |
|
어둡게 위로 대각선 |
|
어두운 눈금 |
|
어두운 격자 |
|
가로로 밝게 |
|
밝은 세로 |
|
조명 아래쪽 대각선 |
|
대각선 켜기 |
|
라이트 그리드 |
|
밝은 격자 |
전경 및 배경색 인덱스는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
검정 |
|
파랑 |
|
녹청 |
|
녹색 |
|
자홍 |
|
빨간색 |
|
노란색 |
|
흰색 |
|
진한 파란색 |
|
진한 시안 |
|
진한 녹색 |
|
어두운 마젠타 |
|
진한 빨간색 |
|
진한 노랑 |
|
진한 회색 |
|
연한 회색 |
wNumberingStart
형식: WORD
번호 매기기 단락에 사용되는 시작 번호 또는 유니코드 값입니다. wNumbering 멤버와 함께 이 멤버를 사용합니다. 이 멤버는 TOM 인터페이스와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트 또는 글머리 기호를 표시하는 데는 사용하지 않습니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_NUMBERINGSTART 플래그를 설정합니다.
wNumberingStyle
형식: WORD
번호 매기기 단락에 사용되는 번호 매기기 스타일입니다. wNumbering 멤버와 함께 이 멤버를 사용합니다. 이 멤버는 TOM 인터페이스와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 3.0 이전의 서식 있는 편집 버전은 텍스트 또는 글머리 기호를 표시하는 데 사용하지 않습니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_NUMBERINGSTYLE 플래그를 설정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
wNumberingTab
형식: WORD
단락 번호와 단락 텍스트 사이의 최소 간격(twips)입니다. wNumbering 멤버와 함께 이 멤버를 사용합니다. wNumberingTab 멤버는 TOM 인터페이스와의 호환성을 위해 포함됩니다. Microsoft Rich Edit 3.0 이전의 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_NUMBERINGTAB 플래그를 설정합니다.
wBorderSpace
형식: WORD
테두리와 단락 텍스트 사이의 간격(트윅)입니다. wBorderSpace 멤버는 Word 호환성을 위해 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_BORDER 플래그를 설정합니다.
wBorderWidth
형식: WORD
테두리 너비(twips)입니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_BORDER 플래그를 설정합니다.
wBorders
형식: WORD
테두리 위치, 스타일 및 색입니다. 비트 0에서 7은 테두리 위치를 지정하고, 비트 8에서 11은 테두리 스타일을 지정하고, 비트 12에서 15는 테두리 색 인덱스를 지정합니다. 이 멤버를 사용하려면 dwMask 멤버에서 PFM_BORDER 플래그를 설정합니다.
비트 0에서 7로 다음 값의 조합을 사용하여 테두리 위치를 지정합니다.
| 값 | 의미 |
|---|---|
|
왼쪽 테두리입니다. |
|
오른쪽 테두리. |
|
위쪽 테두리. |
|
아래쪽 테두리. |
|
테두리 내부. |
|
바깥쪽 테두리. |
|
자동 칠기. 이 비트가 설정된 경우 비트 12~15의 색 인덱스는 사용되지 않습니다. |
비트 8에서 11에 대해 다음 값 중 하나를 사용하여 테두리 스타일을 지정합니다.
| 값 | 의미 |
|---|---|
|
없음 |
|
3/4 점 |
|
11/2 점 |
|
21/4 점 |
|
3점 |
|
41/2 점 |
|
6점 |
|
3/4 포인트 더블 |
|
11/2 점 더블 |
|
21/4 점 더블 |
|
3/4 포인트 회색 |
|
3/4 포인트 회색 파선 |
비트 12에서 15에 대해 다음 값 중 하나를 사용하여 테두리 색을 지정합니다. 자동 칠기 비트(비트 6)가 설정된 경우 이 값은 무시됩니다.
| 값 | 의미 |
|---|---|
|
검정 |
|
파랑 |
|
녹청 |
|
녹색 |
|
자홍 |
|
빨간색 |
|
노란색 |
|
흰색 |
|
진한 파란색 |
|
진한 시안 |
|
진한 녹색 |
|
어두운 마젠타 |
|
진한 빨간색 |
|
진한 노랑 |
|
진한 회색 |
|
연한 회색 |
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | richedit.h |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기