서식 적용

테이블의 각 요소는 다른 형식으로 적용 할 수 있습니다. 예를 들어 테이블 서식은 전체 테이블에 적용되고 행 서식은 특정 행에만 적용되며 셀 서식은 특정 셀에만 적용됩니다.

Aspose.Words 풍부한 제공 API 테이블에 서식을 검색하고 적용하려면 당신은 사용할 수 있습니다 Table, RowFormat,그리고 CellFormat 노드는 서식을 설정합니다.

이 기사에서는 다른 테이블 노드에 서식을 적용하는 방법과 테이블 서식 설정에 대해 설명합니다 Aspose.Words 지원.

다른 노드에 서식 적용

이 섹션에서는 다양한 테이블 노드에 서식을 적용하는 것을 살펴볼 것입니다.

표 수준 서식 지정

테이블에 서식을 적용하려면 해당 테이블에서 사용할 수 있는 속성을 사용할 수 있습니다 Table 노드 사용 Table, PreferredWidth,그리고 TableCollection 수업

테이블 속성을 적용하려면 테이블에 하나 이상의 행이 있어야 합니다. 이것은 테이블을 만들 때 DocumentBuilder,이 포맷은 첫 번째 호출 후 수행해야합니다 InsertCell,또는 첫 번째 행이 테이블에 추가 된 후,또는 노드가 테이블에 직접 삽입 될 때 DOM.

아래 그림은 Table 서식 지정 기능 Microsoft Word 그리고 그 속성들은 Aspose.Words.

formattin-features-table-level-aspose-words-cpp

formatting-table-options-aspose-words-cpp

다음 코드 예제에서는 개요 테두리를 테이블에 적용하는 방법을 보여 줍니다:

다음 코드 예제에서는 모든 테두리가 활성화된 테이블(그리드)을 작성하는 방법을 보여 줍니다:

행 수준 서식 지정

행 수준

참고: Row 의 자식 노드 만 될 수 있습니다 Table. 동시에,적어도 하나가 있어야 합니다. Cell 그 안에 Row 그래서 서식을 적용 할 수 있습니다.

아래 그림은 Row 서식 지정 기능 Microsoft Word 그리고 그 속성들은 Aspose.Words.

formatting-row-level-aspose-words-cpp

다음 코드 예제에서는 테이블 행 서식을 수정하는 방법을 보여 줍니다:

셀 수준 서식 지정

셀 수준 포맷은 Cell, CellFormat,그리고 CellCollection 수업

참고: Cell 의 자식 노드 만 될 수 있습니다 Row. 동시에,적어도 하나가 있어야 합니다. Paragraph 그 안에 Cell 그래서 서식을 적용 할 수 있습니다.

그 외에도 Paragraph,당신은 또한 삽입 할 수 있습니다 Table 에 Cell.

아래 그림은 Cell 서식 지정 기능 Microsoft Word 그리고 그 속성들은 Aspose.Words.

formatting-cell-level-aspose-words-cpp

auto-formatting-cell-level-aspose-words-cpp

다음 코드 예제에서는 표 셀의 서식을 수정하는 방법을 보여 줍니다:

다음 코드 예제에서는 셀 내용의 왼쪽/위쪽/오른쪽/아래쪽에 추가할 공간(점 단위)을 설정하는 방법을 보여 줍니다:

행 높이 지정

행 높이를 설정하는 가장 간단한 방법은 DocumentBuilder. 적절한 사용 RowFormat 속성,당신은 기본 높이 설정을 설정하거나 테이블의 각 행에 대해 다른 높이를 적용 할 수 있습니다.

그 안에 Aspose.Words,테이블 행 높이는:

행 높이 속성 – Height
지정된 행의 높이 규칙 속성 – HeightRule

이 경우 각 행에 대해 다른 높이를 설정할 수 있습니다.이를 통해 테이블 설정을 광범위하게 제어 할 수 있습니다.

개체의 높이를 지정하는 규칙 옵션은 다음을 사용하여 설정할 수 있습니다 HeightRule 열거

다음 코드 예제에서는 단일 셀을 포함하는 테이블을 만들고 행 서식을 적용하는 방법을 보여 줍니다:

테이블 및 셀 너비 지정

테이블 Microsoft Word 문서는 테이블 및 개별 셀의 크기를 조정하는 여러 가지 방법을 제공합니다. 이러한 속성은 테이블의 모양과 동작을 상당히 제어 할 수 있으므로 Aspose.Words 테이블의 동작을 지원합니다. Microsoft Word.

테이블 요소에는 개별 셀뿐만 아니라 전체 테이블의 너비를 계산하는 방법에 영향을 줄 수 있는 여러 가지 속성이 있습니다:

테이블에 선호하는 너비
개별 셀의 기본 너비
테이블에 자동 맞춤 허용

이 문서에서는 다양한 테이블 너비 계산 속성의 작동 방식과 테이블 너비 계산을 완벽하게 제어하는 방법에 대해 자세히 설명합니다. 이건 예상대로 테이블 레이아웃이 표시되지 않는 경우 이러한 경우에 알고 특히 유용합니다.

대부분의 경우 테이블 너비보다 선호하는 셀이 권장됩니다. 선호하는 셀 너비는 DOCX 형식 사양과 Aspose.Words 모델

셀 너비는 실제로 계산된 값입니다. DOCX 형식 실제 셀 너비는 많은 것에 따라 달라질 수 있습니다. 예를 들어 페이지 여백이나 기본 테이블 너비를 변경하면 실제 셀 너비에 영향을 줄 수 있습니다.

기본 셀 너비는 문서에 저장된 셀 속성입니다. 그것은 아무 것도 의존하지 않으며 테이블이나 셀의 다른 속성을 변경할 때 변경되지 않습니다.

이 문서에서 설명하는 모든 속성 및 메서드는 테이블의 작동 방식과 관련이 있습니다 Microsoft Word. 따라서 대부분의 경우 프로그래밍 방식으로 테이블을 빌드하고 있지만 원하는 테이블을 만드는 것이 어렵다면 대신 시각적으로 테이블을 작성해 볼 수 있습니다. Microsoft Word 먼저 서식 값을 응용 프로그램에 복사하기 만하면됩니다.

기본 너비 사용 방법

테이블 또는 개별 셀의 원하는 너비는 기본 너비 속성을 통해 정의됩니다. 즉,기본 너비는 전체 테이블 또는 개별 셀에 대해 지정할 수 있습니다. 어떤 경우에는 이 너비를 정확히 맞추지 못할 수도 있지만 대부분의 경우 실제 너비는 이 값에 가깝습니다.

적절한 기본 너비 유형 및 값은 다음과 같은 방법을 사용하여 설정됩니다 PreferredWidth 클래스:

그 Auto 자동 또는"선호하는 너비 없음"을 지정하는 방법
그 FromPercent 백분율 너비를 지정하는 방법
그 FromPoints 너비(점)를 지정하는 방법

아래 그림은 preferred width setting features 그 안에 Microsoft Word 그리고 그 속성들은 Aspose.Words.

formatting-table-properties-aspose-words-cpp

이러한 옵션이 문서의 실제 테이블에 어떻게 적용되는지에 대한 예는 아래 그림에서 볼 수 있습니다.

todo:image_alt_text

테이블에서 기본 설정 너비를 사용하려면 먼저 테이블에 하나 이상의 행이 포함되어 있는지 확인해야 합니다. 이 때문에 이러한 테이블 서식 Microsoft Word 문서 또는 만든 문서에서 Aspose.Words 테이블의 행에 저장됩니다.

기본 테이블 또는 셀 너비 지정

그 안에 Aspose.Words,테이블 및 셀 너비는 다음을 사용하여 설정됩니다 Table.PreferredWidth 재산 및 CellFormat.PreferredWidth 속성,에서 사용할 수있는 옵션 PreferredWidthType 열거:

Auto,선호하는 너비 집합이 없는 것과 같습니다.
Percent,창 또는 컨테이너 크기의 사용 가능한 공간을 기준으로 요소에 맞으며 사용 가능한 너비가 변경될 때 값을 다시 계산합니다
Points,지정된 너비의 요소에 해당하는 점

기본적으로 테이블은 페이지의 사용 가능한 공간의 100%에 적합하다고 설명할 수 있습니다. 이 경우 테이블이 왼쪽 및 오른쪽 페이지 여백 사이의 공간을 차지하려고합니다.

를 사용하여 Table.PreferredWidth 속성은 컨테이너에 대한 기본 너비(페이지,텍스트 열 또는 중첩 테이블 인 경우 외부 테이블 셀)를 조정합니다.

다음 코드 예제에서는 테이블을 페이지 너비의 50%에 자동 맞춤으로 설정하는 방법을 보여 줍니다:

를 사용하여 CellFormat.PreferredWidth 주어진 셀의 속성은 원하는 폭을 조정합니다.

다음 코드 예제에서는 서로 다른 기본 너비 설정을 설정하는 방법을 보여 줍니다:

원하는 너비 유형 및 값 찾기

당신은 사용할 수 있습니다 Type 그리고 Value 원하는 테이블 또는 셀의 기본 너비 세부 정보를 찾는 속성.

다음 코드 예제에서는 테이블 셀의 기본 너비 유형을 검색하는 방법을 보여 줍니다:

자동 맞춤 설정 방법

그 AllowAutoFit 속성은 테이블의 셀이 선택한 기준에 따라 성장하고 축소 할 수 있습니다. 예를 들어,다음을 사용할 수 있습니다 AutoFit to Window 옵션 페이지의 폭에 테이블을 맞게,그리고 AutoFit to Content 각 셀이 그 내용에 따라 성장하거나 축소 할 수 있도록하는 옵션.

또한, AllowAutoFit 속성은 기본 셀 너비와 함께 사용하여 해당 콘텐츠에 자동으로 맞지만 초기 너비도 있는 셀의 서식을 지정할 수 있습니다. 필요한 경우 셀 너비가이 너비를지나 커질 수 있습니다.

기본적으로, Aspose.Words 다음을 사용하여 새 테이블을 삽입합니다 AutoFit to Window. 테이블은 사용 가능한 페이지 너비에 따라 크기가 조정됩니다. 테이블의 크기를 조정하려면 AutoFit 방법 이 방법은 AutoFitBehavior 테이블에 적용되는 자동 맞춤 유형을 지정하는 열거형입니다.

자동 맞춤 메서드는 실제로 테이블에 다른 속성을 동시에 적용하는 바로 가기입니다. 이것들은 실제로 테이블에 관찰된 행동을 주는 속성입니다. 각 자동 맞춤 옵션에 대해 이러한 속성에 대해 설명합니다.

다음 코드 예제에서는 해당 내용에 따라 각 셀을 축소하거나 확장하도록 테이블을 설정하는 방법을 보여 줍니다:

AutoFit 창에 테이블

창에 자동 맞추기가 테이블에 적용되면 실제로 다음 작업이 백그라운드에서 수행됩니다:

그 Table.AllowAutoFit 속성을 사용하여 사용 가능한 콘텐츠에 맞게 열 크기를 자동으로 조정할 수 있습니다 Table.PreferredWidth 100 의 가치%
CellFormat.PreferredWidth 모든 테이블 셀에서 제거됩니다
이것은 약간 다르다는 점에 유의하십시오. Microsoft Word 각 셀의 기본 너비가 현재 크기 및 내용에 따라 적절한 값으로 설정된 동작입니다. Aspose.Words 그들은 단지 대신 삭제 얻을 수 있도록 선호하는 폭을 업데이트하지 않습니다.
현재 테이블 콘텐츠에 대해 열 너비가 다시 계산됩니다.
사용자가 텍스트를 편집할 때 테이블의 열 너비가 자동으로 변경됩니다

다음 코드 예제에서는 테이블을 페이지 너비에 자동으로 맞추는 방법을 보여 줍니다:

AutoFit 표에서 내용

테이블에 콘텐츠가 자동으로 장착되면 다음 단계가 실제로 백그라운드에서 수행됩니다:

그 Table.AllowAutoFit 속성에 따라 각 셀의 크기를 자동으로 조정할 수 있습니다
기본 테이블 너비는 다음에서 제거됩니다 Table.PreferredWidth, CellFormat.PreferredWidth 각 테이블 셀에 대해 제거됩니다
이 자동 맞춤 옵션은 다음과 같이 셀에서 원하는 너비를 제거합니다 Microsoft Word. 열 크기를 유지하고 콘텐츠에 맞게 열을 늘리거나 줄이려면 열 크기를 설정해야 합니다. Table.AllowAutoFit 재산 True 자동 맞춤 단축키를 사용하는 대신 자체적으로.
최종 결과는 사용자가 텍스트를 편집할 때 콘텐츠에 가장 잘 맞도록 열 너비와 전체 테이블의 너비가 자동으로 크기가 조정되는 테이블입니다

다음 코드 예제에서는 테이블의 내용을 자동으로 맞추는 방법을 보여 줍니다:

사용 안 함 AutoFit 테이블 및 고정 열 너비 사용

테이블에 자동 맞추기가 비활성화되어 있고 고정된 열 너비가 대신 사용되는 경우 다음 단계가 수행됩니다:

Table.AllowAutoFit 속성이 비활성화되므로 열이 해당 콘텐츠로 커지거나 축소되지 않습니다
전체 테이블의 기본 너비는 다음에서 제거됩니다 Table.PreferredWidth, CellFormat.PreferredWidth 모든 테이블 셀에서 제거됩니다
최종 결과는 열 너비가 CellFormat.Width 속성 및 사용자가 텍스트를 입력하거나 페이지 크기를 조정할 때 열이 자동으로 크기가 조정되지 않는 속성

너비가 지정되지 않은 경우 CellFormat.Width,1 인치(72 점)의 기본값이 사용됩니다.

다음 코드 예제에서는 자동 맞춤을 사용하지 않도록 설정하고 지정된 테이블에 대해 고정 너비를 사용하도록 설정하는 방법을 보여 줍니다:

셀 너비를 계산할 때 우선 순위

Aspose.Words 사용자가 다음을 포함하여 여러 개체를 통해 테이블 또는 셀의 너비를 정의할 수 있습니다 CellFormat -그것의 Width 속성은 대부분 이전 버전에서 남아 있지만 셀 너비 설정을 단순화하는 데 여전히 유용합니다.

그 사실을 아는 것이 중요합니다. CellFormat.Width 속성은 테이블에 이미 있는 다른 너비 속성에 따라 다르게 작동합니다.

Aspose.Words 셀 너비를 계산할 때 다음 순서를 사용합니다:

주문	재산	설명
	AllowAutoFit 결정된다	만약 AutoFit 활성화됨: -테이블 콘텐츠를 수용 하기 위해 선호 폭 과거 성장할 수 있습니다-그것은 일반적으로 선호 폭 아래로 축소 하지 않습니다 -모든 변경 CellFormat.Width 값이 무시되고 셀이 그 내용에 맞게 됩니다
	PreferredWidthType 의 값으로 Points 또는 Percent	CellFormat.Width 무시됨
	PreferredWidthType 의 값으로 Auto	값 CellFormat.Width 복사되어 셀의 기본 너비(점 단위)가 됩니다.

너비 속성에 대한 변경 사항은 기본 너비에서 업데이트되지 않으며 대신 기본 너비에 적용해야 합니다.

고정 테이블 레이아웃을 만드는 동안 셀 너비를 지정하십시오. 너비가 없는 셀은 다음으로 저장할 수 없습니다 DOC 형식 이외의 문서 형식 DOC,같은 DOCX,원칙적으로 고정된 테이블 레이아웃에서 폭 없이 셀을 저장할 수 있습니다.

셀 간 간격 허용

“셀 간격"옵션과 유사한 테이블 셀 사이에 추가 공간을 가져오거나 설정할 수 있습니다 Microsoft Word. 이것은 다음을 사용하여 수행 할 수 있습니다 AllowCellSpacing 재산.

이러한 옵션이 문서의 실제 테이블에 어떻게 적용되는지에 대한 예는 아래 그림에서 볼 수 있습니다.

formatting-spacing-between-cells-aspose-words-cpp

다음 코드 예제에서는 셀 사이의 간격을 설정하는 방법을 보여 줍니다:

테두리 및 음영 적용

테두리와 음영은 다음을 사용하여 전체 테이블에 적용 할 수 있습니다 Table.SetBorder, Table.SetBorders 그리고 Table.SetShading,또는 특정 셀에만 CellFormat.Borders 그리고 CellFormat.Shading. 또한 행 테두리는 다음을 사용하여 설정할 수 있습니다 RowFormat.Borders,그러나 그늘은 이 방법으로 적용할 수 없습니다.

아래 그림은 테두리 및 그림자 설정을 보여줍니다. Microsoft Word 그리고 그 속성들은 Aspose.Words.

formatting-border-line-aspose-words-cpp

formatting-cell-color-aspose-words-cpp

다음 코드 예제에서는 다른 테두리 및 음영을 사용하여 테이블과 셀의 서식을 지정하는 방법을 보여 줍니다:

테이블의 텍스트 작업 워드 문서의 테이블 스타일 변경