Text
텍스트를 표시할 때 사용하는 아이템입니다.
Basic
이름 | 타입 | 설명 | 필수여부 |
---|---|---|---|
Name | string | 아이템에 고유한 이름을 설정합니다. | no |
Tag | string | 아이템에 태그값을 설정합니다. | no |
Visible | boolean | 아이템의 표시 여부를 설정합니다. | yes |
Page Break | PageBreakMode | 아이템을 출력하기 전에 페이지를 어떻게 나눌 것인지 대해 설정합니다. | no |
Excel
셀 배치나 병합 혹은 셀 수식을 적용할 수 있는 속성
이름 | 타입 | 설명 | 필수여부 |
---|---|---|---|
Row | number | 셀의 행 위치값을 설정합니다. | yes |
Col | number | 셀의 열 위치값을 설정합니다. | yes |
Row Span | number | 셀의 행 병합을 설정합니다. | no |
Col Span | number | 셀의 열 병합을 설정합니다. | no |
Formula | string | 셀의 값에 관련된 수식을 설정합니다. | no |
Format | string | 셀에 값에 관련된 표현 형식을 설정합니다. | no |
Formula
셀의 값에 관련된 수식을 설정합니다.
- 타입: string
- 기본값: undefined
수식 적용 예시
셀 지정 표현식
sum("셀 위치값", "셀 위치값")
적용예시)
sum(A1, B1, C1)
A1, B1, C1의 각 셀의 값을 합계 수식으로 설정하는 예시
셀 범위 표현식
sum("범위 시작 셀 위치값":"범위 끝 셀 위치값")
적용예시)
sum(A1:C1)
A1 부터 C1 범위의 셀을 합계 수식으로 설정하는 예시
수식 디자인 적용 예시
- Formula 속성에
sum("셀위치", "셀위치", ...)
등으로 합계 수식을 설정합니다.
- 적용 모습을 확인합니다.
밴드에서 수식 적용 예시
밴드 아이템에서는 설정한 데이터에 따라 데이터 행의 갯수가 동적이므로 특정 표현식을 써서 원하는 데이터 밴드 내의 셀 정보를 가져올 수 있습니다.
밴드의 데이터 행에서 현재 행 표현식 사용
현재 데이터행 표현식
밴드기준의 셀 열 위치 + #
적용예시)
B#*C#
데이터 로우 영역에서 데이터가 출력되는 행 기준으로 B열 * C열 수식을 설정한 예시
- Formula 속성에
(셀의 열위치 + #) * (셀의 열위치 + #)
표현식으로 데이터 행의 B열 C열을 곱하는 수식을 설정합니다.
- 적용 모습을 확인합니다.
밴드의 푸터 영역에서 데이터행 표현식 사용
푸터에서 특정 데이터행 표현식
밴드 기준의 셀 열 위치 + 행 숫자
적용예시)
D1
밴드 기준에서 데이터 행 D열의 첫번째 행의 값
푸터에서 마지막 데이터행 표현식
밴드 기준의 셀 열 위치 + _
적용예시)
D_
밴드 기준에서 데이터 행 D열의 마지막 행의 값
- Formula 속성에
sum(D1:D_)
표현식으로 데이터 행의 D열의 첫행부터 마지막행까지 합계를 구하는 수식을 설정합니다.
- 적용 모습을 확인합니다.
Format
셀에 값에 관련된 표현 형식을 설정합니다.
- 타입: string
- 기본값: undefined
Event
이름 | 타입 | 설명 | 필수여부 |
---|---|---|---|
OnGetValue | ReportItemValueCallback | 아이템에 표시되는 값을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다. | no |
OnGetStyles | ReportItemStyleCallback | 아이템에 적용되는 스타일을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다. | no |
OnGetVisible | ReportItemVisibleCallback | 아이템의 표시 여부를 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다. | no |
OnGetContextValue | ContextValueCallback | 아이템에 표시되는 값을 변경할 수 있는 이벤트 함수 관련 로직을 설정합니다. | no |
Bound
이름 | 타입 | 설명 | 필수여부 |
---|---|---|---|
Rotation | number | 아이템의 회전 각도를 설정합니다. | no |
Rotation
아이템의 회전 각도를 설정합니다.
- 타입: number
- 기본값: undefined
Data
이름 | 타입 | 설명 | 필수여부 |
---|---|---|---|
Data | string | 아이템에 리포트에 존재하는 데이터를 연결합니다. | no |
Value | string | 아이템에 연결된 데이터에서 표시할 필드를 선택하거나 ContextData를 입력 합니다. | no |
Link Field | string | 링크기능 사용시 linkUrl 값을 연결할 필드를 선택합니다. | no |
Merge Rule | string | 다음행과 병합해야 할 조건을 설정합니다. | no |
Link Field
링크기능 사용시 linkUrl 값을 연결할 필드를 선택합니다.
- 타입: string
- 기본값: undefined
Merge Rule
Band
아이템의 Data Row
영역 안에서만 적용되는 규칙입니다.
다음행과 병합해야 할 조건을 설정합니다.
- 타입: string
- 기본값: undefined
설명
value
로 설정하면 다음행의 값이 같은 경우에 자동으로 행을 병합합니다.:필드명
데이터의 필드명으로 설정하면 다음 데이터 행의 설정한 필드명과 데이터가 같은 경우 자동으로 행을 병합합니다.
Link
이름 | 타입 | 설명 | 필수여부 |
---|---|---|---|
LinkUrl | string | 이 속성에 url 입력하면 미리보기 상태에서 클릭시 웹 브라우저에서 해당 url로 이동합니다. | no |
LinkTarget | string | 링크기능 사용시 브라우저의 실행 타겟 (opens in a new tab)을 지정합니다. | no |
Text
텍스트 아이템에서 사용되는 속성
이름 | 타입 | 설명 | 필수여부 |
---|---|---|---|
Wrap | boolean | 표시되는 데이터가 텍스트 아이템의 넓이를 넘어설 경우에 줄바꿈 여부를 설정합니다. | yes |
Multi Line | boolean | 텍스트 아이템에서 줄바꿈이 가능하도록 설정합니다. | no |
Text | string | 텍스트 아이템에 표시될 문구를 설정합니다. | no |
Wrap
표시되는 데이터가 텍스트 아이템의 넓이를 넘어설 경우에 줄바꿈 여부를 설정합니다. 이때 Width가 명시적으로 입력되지 않은 경우 wrap
속성은 적용되지 않습니다.
- 타입: boolean
- 기본값: false
Multi Line
텍스트 아이템에서 줄바꿈이 가능하도록 설정합니다.
- 타입: boolean
- 기본값: false
설명
true
로 설정할 경우 문자열에 줄바꿈 기능의 문자가 포함된 경우 출력시 해당 위치에서 줄바꿈 됩니다.
줄바꿈 문자는 아래와 같습니다.
<br>
|<br/>
- 이스케이프 문자:
\r
|\n
|\r\n
Text
텍스트 아이템에 표시될 문구를 설정합니다.
- 타입: string
- 기본값: undefined
Editing
미리보기에서 편집이 가능하도록 설정하는 속성
Editable
텍스트 아이템을 미리보기에서 편집 가능하도록 설정합니다.
- 타입: boolean
- 기본값: false
Type
편집기의 종류를 설정합니다.
- 타입: EditType
- 기본값: text
Internationalization
다국어 관련 정보를 설정하는 속성
Field
다국어 설정에서 연결할 필드를 설정합니다.
- 타입: string
- 기본값: undefined
Styles
이름 | 타입 | 설명 | 필수여부 |
---|---|---|---|
Border | string | 아이템의 테두리를 설정합니다. | no |
Border Left | string | 아이템의 왼쪽 테두리를 설정합니다. | no |
Border Right | string | 아이템의 오른쪽 테두리를 설정합니다. | no |
Border Top | string | 아이템의 위쪽 테두리를 설정합니다. | no |
Border Bottom | string | 아이템의 아래쪽 테두리를 설정합니다. | no |
Font Family | string | 아이템의 글꼴을 설정합니다. | no |
Font Size | number | 아이템의 텍스트 크기를 설정합니다. | no |
Font Style | string | 아이템의 글꼴체를 설정합니다. | no |
Text Decoration | string | 아이템의 텍스트에 선 스타일을 설정합니다. | no |
Font Weight | string | 아이템의 텍스트 굵기를 설정합니다. | no |
Color | string | 아이템의 텍스트 색상을 설정합니다. | no |
Background Color | string | 아이템의 배경 색상을 설정합니다. | no |
Text Align | string | 아이템의 텍스트 가로 정렬을 설정합니다. | no |
Vertical Align | string | 아이템의 세로 정렬을 설정합니다. | no |
Padding | string | 아이템의 왼쪽 내부 여백을 설정합니다. | no |