본문 바로가기
Python/xlwings

파이썬 xlwings.shapes 함수 활용하기

by PySun 2024. 12. 6.
반응형

파이썬 xlwings.shapes 함수: Excel에서 도형 데이터 다루기

엑셀 파일을 자동화하고 데이터를 조작하는 그 어느 때보다 쉬워졌습니다. 이 모든 것이 xlwings와 함께라면 더욱 간단해집니다. 이번 포스팅에서는 xlwings.shapes 함수를 활용하여 엑셀 도형을 생성하고 조작하는 방법을 알아보겠습니다.

xlwings.shapes 함수 소개

xlwings.shapes 함수는 파이썬을 통해 엑셀 워크북 내의 도형을 작성하고 조작하는 데 유용합니다. 이 함수를 사용하면 도형을 추가하거나 속성을 변경할 수 있습니다. 비즈니스 보고서에 시각적 요소를 더하고 싶을 때 아주 큰 도움이 되는 기능이죠!

함수 시그니처

xlwings.sheets['Sheet1'].shapes

매개변수:

  • xlwings.sheets: 도형을 추가할 엑셀 시트를 지정합니다.

반환 값:

  • 지정된 시트 내의 모든 도형을 관리할 수 있는 개체를 반환합니다.

사용 예제

기본 도형 추가 예제

다음은 xlwings.shapes 함수를 사용하여 엑셀 시트에 도형을 추가하는 기본 예제입니다.

import xlwings as xw

# 엑셀 앱 열기
wb = xw.Workbook()
sheet = wb.sheets['Sheet1']

# 도형 추가
shape = sheet.shapes.add_shape(container=xw.utils.ShapeType.RECTANGLE, left=100, top=100, width=200, height=100)
shape.text = "안녕하세요, xlwings!"

wb.save('도형_예제.xlsx')
wb.close()
# 새로운 엑셀 파일에 도형이 추가된다.

도형 속성 변경 예제

도형의 속성을 변경하고 싶다면 다음과 같이 작성할 수 있습니다.

import xlwings as xw

# 엑셀 앱 열기
wb = xw.Workbook('도형_예제.xlsx')
sheet = wb.sheets['Sheet1']

# 기존 도형 가져오기
shape = sheet.shapes[0]  # 첫 번째 도형

# 속성 변경
shape.fill.solid()  # 색상 채우기
shape.fill.fore_color = xw.utils.rgb_to_colour(255, 0, 0)  # 빨간색으로 변경

# 도형 텍스트 변경
shape.text = "변경된 텍스트"

wb.save()
wb.close()
# 도형의 색상과 텍스트가 변경된다.

결론

xlwings.shapes 함수는 엑셀 내에서 도형을 손쉽게 관리할 수 있게 도와줍니다. 도형을 추가하고, 속성을 수정함으로써 데이터를 보다 시각적으로 표현할 수 있어 많은 사용자에게 유용합니다. 지금 바로 xlwings를 활용해 보세요!

  • 엑셀 파일을 단순한 스프레드시트에서 시각적인 보고서로 바꿔보세요!
  • 도형 추가로 오랜 시간 동안 지루했던 보고서를 눈에 띄게 변화시킬 수 있습니다!
반응형