Daily 달력 및 DailyFromTo 달력에서 주차 표시와 주말 강조 색상을 설정할 수 있도록 개선되었습니다.

page no.  112038980

개요

Daily 달력 및 DailyFromTo 달력에서 주차 표시 옵션(UseWeekNumber) 과 주말 강조 표시 옵션(HighlightWeekend) 이 새롭게 추가되었습니다.

또한, 제품별 설정 옵션인 CalendarWeeklyDefineDay 값에 따라 달력의 시작 요일이 자동으로 반영되도록 개선되었습니다.

1. 신규 옵션 및 개선 사항

   신규 옵션

   옵션명	데이터 타입	기본값	설명	적용 예시
   UseWeekNumber	boolean	false	Daily 달력에서 주차(Week Number) 를 함께 표시할 수 있는 옵션입니다.
   HighlightWeekend	boolean	false	주말(토, 일)을 강조 색상으로 표시할 수 있는 옵션입니다.
   DisplayStartDayOfWeek	number	0	달력에서 요일 표시를 시작할 기준 요일을 지정할 수 있는 옵션입니다.

   유의 사항

   CalendarWeeklyDefineDay 옵션은 주차 계산의 기준 요일을 지정하는 옵션이며, DisplayStartDayOfWeek 옵션은 달력 화면에 표시할 시작 요일을 지정하는 옵션입니다.
   두 옵션은 서로 다른 목적을 가지므로, 혼동하지 않도록 주의해야 합니다.

   예를 들어 CalendarWeeklyDefineDay 가 월요일로 설정되어 있더라도 DisplayStartDayOfWeek 을 일요일로 지정하면, 달력은 일요일부터 표시되지만 주차 계산은 월요일을 기준으로 수행됩니다.

   개선 사항

   달력 시작 요일 자동 반영 기능 추가

   제품별 옵션인 CalendarWeeklyDefineDay 설정값에 따라 시작 요일이 자동으로 변경됩니다.

   예를 들어, CalendarWeeklyDefineDay = 1 (월요일) 로 설정한 경우 달력은 월요일부터 시작하도록 표시됩니다.

   

   주차 표시 서식 지원

   Daily 달력에서 날짜와 함께 주차 정보를 표시할 수 있는 서식을 지원합니다.

   

   ※ 이 서식은 ViewFormat 속성에서만 사용하는 것을 권장합니다.

2. 사용 방법

   1. 제품별 옵션을 이용한 적용 방법

   설정 경로

   iMgt > 시스템 운영관리 > 제품별 옵션 설정

   설정 대상

   옵션명: UseWeekNumber, HighlightWeekend

   설정 방법

   각 옵션의 값을 true 로 설정하면 AUD 전반의 Daily 달력 및 DailyFromTo 달력에 적용됩니다.

   유의 사항

   제품별 옵션을 통해 설정한 값은 AUD 전반에 영향을 미치며, 기존의 Daily 달력 및 DailyFromTo 달력에 동일하게 적용됩니다.

   2. ScriptAPI 를 이용한 개별 적용 방법

   설정 대상

   개별 달력 컨트롤의 속성

   설정 방법

   ScriptAPI 를 사용하여 원하는 달력 컨트롤에 직접 옵션을 지정합니다.

   예제 코드

   var daily = Matrix.getObject('Calendar');
   daily.UseWeekNumber = true;     // 주차 표시 옵션 활성화
   daily.HighlightWeekend = true;  // 주말 강조 색상 사용 활성화

   우선순위

   ScriptAPI 를 통해 개별적으로 설정한 옵션은 제품별 옵션보다 우선 적용됩니다.