Word 문서에 .NET에서 그리기 도형을 추가하는 방법

1단계: 라이브러리 가져오기

리포지토리를 복제하고 빌드합니다 Aspose.Words.sln Release 구성에서, 그런 다음 프로젝트 참조를 추가합니다 Aspose.Words.csproj 귀하의 .NET 프로젝트에서, 설명된 대로 설치 가이드. 추가 using Aspose.Words; and using Aspose.Words.Drawing; shapes와 함께 작동하는 모든 파일의 상단에.

2단계: AutoShape 추가

new Shape(doc, shapeType)을 사용해 도형을 직접 구성합니다. 여기서 shapeType은 ShapeType 값이며, 예를 들어 Rectangle, Ellipse, Star, 또는 TextBox이 있습니다. 그런 다음 DocumentBuilder.InsertNode(node)으로 트리에 삽입합니다. Shape은 여러분이 생성하고 구성하는 구체적이며 sealed 클래스이며, 추상 ShapeBase을 상속받습니다. 추상 ShapeBase은 위치 (Left, Top, Width, Height, Rotation)와 서식 하위 객체 (Fill, Stroke, ShadowFormat, Glow, Reflection)를 정의하며, 이는 GroupShape과 공유됩니다.

단계 3: 그림 추가

DocumentBuilder.InsertImage은(는) 그림을 직접 삽입하는 경로입니다: 오버로드는 Image, 파일 경로, Stream, 또는 원시 바이트 배열을 허용하며, 명시적인 width/height 또는 전체 위치 인수(horzPos, left, vertPos, top, width, height, wrapType)를 받는 추가 오버로드가 있습니다. 결과 Shape의 ImageData 속성에 그림 데이터가 저장됩니다 — 이미지를 교체하려면 ImageData.SetImage(...)를 호출하고, 기본 조정을 위해 CropTop/CropBottom/CropLeft/CropRight, Brightness, Contrast, GrayScale를 사용하십시오.

단계 4: 모양 위치 지정 및 텍스트 줄 바꿈

인라인 모양(InsertImage의 기본 결과)은 주변 텍스트와 함께 흐르며 플로팅될 때까지 위치 속성을 무시합니다 — 모양이 어떤 모드에 있는지 확인하려면 IsInline을 확인하십시오. 모양을 플로팅하려면 WrapType를 인라인이 아닌 값으로 설정하고, RelativeHorizontalPosition/RelativeVerticalPosition(각각 Page, Margin, Column 또는 유사한 앵커를 기준)와 함께 Left/Top 오프셋을 설정합니다. WrapSide은 측면별 줄 바꿈을 제어하고, HorizontalAlignment/VerticalAlignment는 명시적 오프셋 대신 간단한 상대 정렬을 처리합니다.

단계 5: 모양 채우기 및 스타일 지정

Shape.Fill ( Fill 객체) 은 모양의 내부를 채웁니다: 단색은 Fill.Solid(color), 그라디언트는 Fill.OneColorGradient(...)/Fill.TwoColorGradient(...), 패턴은 Fill.Patterned(patternType), 그림 채우기는 Fill.SetImage(...) — 현재 활성화된 항목은 FillType이 보고합니다. 외곽선은 Stroke 속성에서 가져옵니다. 효과의 경우, ShadowFormat, Glow(GlowFormat), Reflection(ReflectionFormat), SoftEdge(SoftEdgeFormat) 각각이 자체 설정과 효과를 없애는 Remove() 메서드를 제공합니다.

단계 6: 여러 모양 그룹화

DocumentBuilder.InsertGroupShape(shapes)을 사용하여 여러 모양을 하나의 단위로 결합하면 GroupShape을 반환합니다. GroupShape 자체도 ShapeBase이므로 그룹 전체에 적용되는 자체 Fill, ShadowFormat, Glow, Reflection을 보유합니다; 그룹의 좌표 변환이 일관되게 유지되도록 개별 자식이 아니라 GroupShape을 이동하거나 크기를 조정하십시오. 텍스트를 포함하는 모양의 경우, Shape.TextBox ( TextBox 객체) 가 패딩(InternalMarginLeft/Right/Top/Bottom), 자동 크기 조정(FitShapeToText), 텍스트 방향(LayoutFlow), 수직 정렬(VerticalAnchor)을 제어합니다.

7단계: 워터마크 추가

Document.Watermark은(는) 수동으로 삽입한 도형과 무관하게 문서 전체에 단일 워터마크를 관리합니다. 텍스트 워터마크는 Watermark.SetText(text) 또는 SetText(text, options)를 호출하고, 그림 워터마크는 SetImage(...)을 호출하십시오; Watermark.Remove()는 이를 지우고, Watermark.Type는 현재 WatermarkType(Text, Image, 또는 None)을 보고합니다. TextWatermarkOptions은 FontFamily, FontSize, Color, 및 Layout(WatermarkLayout.Horizontal 또는 Diagonal)를 설정합니다; ImageWatermarkOptions은 Scale와 IsWashout를 설정합니다.