Метод Application.TimescaleEdit (Project)

Статья
04/07/2023

Позволяет изменять масштаб и формат шкалы времени на диаграмме Ганта или в другом повременном представлении.

Синтаксис

выражение. TimescaleEdit( _MajorUnits_, _MinorUnits_, _MajorLabel_, _MinorLabel_, _MajorAlign_, _MinorAlign_, _MajorCount_, _MinorCount_, _MajorTicks_, _MinorTicks_, _Enlarge_, _Separator_, _MajorUseFY_, _MinorUseFY_, _TopUnits_, _TopLabel_, _TopAlign_, _TopCount_, _TopTicks_, _TopUseFY_, _TierCount_ )

выражение: переменная, представляющая объект Application.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
MajorUnits	Необязательный	Variant	Единицы времени для среднего уровня шкалы времени. Укажите с помощью перечисления PjTimescaleUnit . Значение по умолчанию — pjTimescaleWeeks (3).
MinorUnits	Необязательный	Variant	Единицы времени для нижнего уровня шкалы времени. Укажите с помощью перечисления PjTimescaleUnit . Значение по умолчанию — pjTimescaleDays (2).
MajorLabel	Необязательный	Variant	Метки даты или времени для среднего уровня шкалы времени. Укажите одно из следующих перечислений: PjDateLabel, PjDayLabel, PjMonthLabel или PjWeekLabel. Значение по умолчанию — pjWeekLabelWeek_mmm_dd_yyy (13). Например, значения по умолчанию: 7, 10 и 14 марта 10.
MinorLabel	Необязательный	Variant	Метки даты или времени для нижнего уровня шкалы времени. Укажите одно из следующих перечислений: PjDateLabel, PjDayLabel, PjMonthLabel или PjWeekLabel. Значение по умолчанию — pjDayLabelDay_di (20). Например, значения по умолчанию: S, M и T.
MajorAlign	Необязательный	Variant	Перечисление PjAlignment указывает, как выравнивать метки в течение каждого периода времени среднего уровня. Значение по умолчанию — pjLeft (0).
MinorAlign	Необязательный	Variant	Перечисление PjAlignment указывает, как выровнять метки в течение каждого периода времени нижнего уровня. Значение по умолчанию — pjLeft (0).
MajorCount	Необязательный	Variant	Указывает интервал единицы времени, в котором будут отображаться метки для среднего уровня. Например, если единица времени составляет недели, значение 1 отображает метку каждую неделю; значение 2 отображает метку каждые две недели.
MinorCount	Необязательный	Variant	Указывает интервал единиц времени, в котором будут отображаться метки для нижнего уровня. Например, если единица времени — часы, значение 1 отображает метку каждый час; значение 2 отображает метку каждые два часа.
MajorTicks	Необязательный	Variant	Указывает, должны ли отображаться такты, разделяющие периоды времени на среднем уровне. Например, если единица времени — дни, то значение False удаляет отметки между днями.
MinorTicks	Необязательный	Variant	Указывает, должны ли отображаться такты, разделяющие периоды времени на нижнем уровне. Например, если единица времени — часы, значение False удаляет отметки между часами.
Увеличить	Необязательный	Variant	Указывает процент горизонтального расширения шкалы времени. Например, значение 150 расширяет шкалу времени на 150 %.
Separator	Необязательный	Variant	Указывает, должны ли отображаться линии, разделяющие верхний, средний и нижний уровни шкалы времени. Например, значение False удаляет строки.
MajorUseFY	Необязательный	Variant	Указывает, следует ли основывать метки среднего уровня на финансовом году. Значение по умолчанию — False.
MinorUseFY	Необязательный	Variant	Указывает, следует ли основывать метки нижнего уровня на финансовом году. Значение по умолчанию — False.
TopUnits	Необязательный	Variant	Единицы времени для верхнего уровня шкалы времени. Укажите с помощью перечисления PjTimescaleUnit . Значение по умолчанию — pjTimescaleMonths (2).
TopLabel	Необязательный	Variant	Метки даты или времени для верхнего уровня шкалы времени. Укажите одно из следующих перечислений: PjDateLabel, PjDayLabel, PjMonthLabel или PjWeekLabel. Значение по умолчанию — pjDayLabelDay_di (20). Например, значения по умолчанию: S, M и T.
TopAlign	Необязательный	Variant	Перечисление PjAlignment указывает, как выравнивать метки в течение каждого периода времени верхнего уровня. Значение по умолчанию — pjLeft (0).
TopCount	Необязательный	Variant	Указывает интервал единицы времени, в котором будут отображаться метки для верхнего уровня. Например, если единица времени — месяцы, значение 1 отображает метку каждый месяц; значение 2 отображает метку каждые два месяца.
TopTicks	Необязательный	Variant	Указывает, должны ли отображаться галочки, разделяющие периоды времени на верхнем уровне. Например, если единица времени — месяцы, значение False удаляет метки между месяцами.
TopUseFY	Необязательный	Variant	Указывает, следует ли основывать метки верхнего уровня на финансовом году. Значение по умолчанию — False.
TierCount	Необязательный	Variant	Указывает количество уровней шкалы времени. Целочисленное значение 3 показывает все три уровня; значение 2 — по умолчанию и показывает средний и нижний уровни; Значение 1 отображает только средний уровень.

Возвращаемое значение

Boolean

Примечания

Чтобы вручную изменить шкалу времени в Project, щелкните шкалу времени правой кнопкой мыши и выберите пункт Шкала времени. При выполнении метода TimescaleEdit без параметров отображается диалоговое окно Шкала времени . Если пользователь выбрал отмену, timescaleEdit возвращает значение False. Если пользователь вносит допустимые изменения и нажимает кнопку ОК, timescaleEdit возвращает значение True.

Пример

В следующем примере задается шкала времени на три уровня, где единицы верхнего уровня — месяцы, верхние метки — это название месяца и года, единицы среднего уровня — недели, а метки среднего уровня — это числа месяцев и дней. Например, метки верхнего уровня — май 2012 г. и июнь 2012 г., а метки среднего уровня — 27 и 6/3.

TimescaleEdit TierCount:=3, _ 
    TopUnits:=PjTimescaleUnit.pjTimescaleMonths, _ 
    TopLabel:=PjMonthLabel.pjMonthLabelMonth_mmmm_yyyy, _ 
    MajorUnits:=PjTimescaleUnit.pjTimescaleWeeks, _ 
    MajorLabel:=PjWeekLabel.pjWeekLabelWeek_mm_dd

Примечание.

Значения диапазона времени метки в параметрах TopLabel, MajorLabel и MinorLabel должны быть совместимы с единицей времени указанного уровня шкалы времени. Например, если единица времени нижнего уровня — часы, значение MinorLabel:=PjDateLabel.pjHour_hhAM параметра является допустимым. Однако значение MinorLabel:=PjDateLabel.pjHalfYear_hhh_Half параметра приводит к ошибке во время выполнения 1101: "Значение аргумента недопустимо".

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.