Статьи

Типы объектов - Score

Объект Партитура (Score)
Партитура (Score) содержит один Системный Нотоносец (SystemStaff) и один или более Нотоносцев (Staff).
for each <переменная> in возвращает каждый нотоносец в партитуре по очереди (кроме системного нотоносца).
for each <тип> <переменная> in возвращает объекты из партитуры в хронологическом порядке, начиная с верхнего нотоносца, до нижнего, а в них слева направо (тоже не включая системный нотоносец).

Методы:

Score[элемент массива]
Возвращает нотоносец с заданным индексом (начиная с 0), например, Score[0]

NthStaff(индекс нотоносца, начиная с 1)
Возвращает указанный нотоносец.

Save(имя файла)
Сохраняет партитуру, перезаписывая существующий файл с таким именем.

SaveAs(имя файла,тип[,использовать_умолчания,имя папки])
Сохраняет партитуру в не-Sibelius формате, перезаписывая существующий файл с таким именем. Необязательный параметр использовать_умолчания определяет, использовать или нет установки по умолчанию, а необязательный параметр имя папки определяет, в какую папку сохранять файл. Имя папки должно заканчиваться разделителем пути (как “\\” в Windows).
Допустимые значения типа:
"EMF" – emf
”BMP“ – windows bitmap
”PICT” – pict format
”Midi” – midi format
”EPSF” – EPS format
”TIFF” – tiff format

SaveAsSibelius2(имя файла[,имя папки])
Сохраняет партитуру в формате Sibelius 2 format, перезаписывая существующий файл с таким именем.

CreateInstrument(имя,[является именем по умолчанию])
Создаёт новый инструмент. Необязательный второй булевый параметр определяет, следует ли рассматривать заданное имя, как имя инструмента ‘по умолчанию’, которое одно и то же во всех языковых версиях Sibelius.

ApplyStyle(путь к файлу стиля,“стиль”,[“стиль”])
Импортирует названные стили из данного файла ‘Экспорта стилей’ в партитуру. Вы можете импортировать столько элементов “стиля”, сколько захотите в одном методе. Далее перечислены имена стилей:
HOUSE, TEXT, SYMBOLS, LINES, NOTEHEADS, CLEFS, STAFFTYPES, DICTIONARY, PACINGRULE, CUSTOMCHORDNAMES или ALLSTYLES.
Например: score2.ApplyStyle(“C:\NewStyle.lib”, “HOUSE”, “TEXT”);
Обратите внимание, что константа HOUSE относится, по историческим причинам, только к опциям, находящимся в диалогах Engraving Rules и Document Setup, а не ко всему House Style. Чтобы импортировать все опции из House Style, используйте константу ALLSTYLES.

RenameTextStyle(“старое имя”,”новое имя”)
Переименовывает стиль текста.

AddBars(количество)
Добавляет указанное количество тактов в конец партитуры.

InsertBars(количество,номер такта)
Вставляет указанное количество тактов после указанного такта.

SetBreakType(номер такта,тип)
Устанавливает указанный тип разрыва после указанного такта, где тип может быть одной из следующих констант: MiddleOfSystem, EndOfSystem, MiddleOfPage, EndOfPage, NotEndOfSystem или EndOfSystemOrPage. Чтобы понять взаимосвязь между этими константами и элементами меню на панели ‘Bars’, см. обзор Глобальных Констант ниже.

ExtractParts([показывать_диалог],[путь])
Разделяет партитуру на партии. Первый необязательный параметр может быть false, тогда партии будут извлечены без вывода диалога с опциями извлечения. Второй необязательный параметр определяет папку для сохранения партий (должен иметь разделитель пути).

SystemCount(номер страницы)
Количество систем на странице (первая страница партитуры - страница 1).

LineStyleIndex(имя стиля линии)
Возвращает индекс стиля линии для указанного имени или –1, если такого стиля не существует.

TextStyleIndex(имя стиля текста)
Возвращает индекс стиля текста для указанного имени или –1, если такого стиля не существует.

RemoveAllHighlights()
Удаляет все подсветки в партитуре.

Переменные:

FileName
Имя файла партитуры.

SystemStaff
Объект системного нотоносца партитуры.

Selection
Объект Выделение (Selection), то есть список всех выделенных в партитуре объектов.

Redraw
(Для записи) Установите в True (1) для перерисовки партитуры после каждого изменения, в False (0) для отключения перерисовки.

StaffCount
Количество нотоносцев в партитуре.

PageCount
Количество страниц в партитуре.

SystemCount
Количество систем в партитуре.

TransposingScore
(Для записи) Если True (1), партитура транспонированная.

ShowMultiRests
(Для записи) True (1) или False (0). Приравнивается к Layout > Show Multirests.

LiveMode
(Для записи) True (1) или False (0). Приравнивается к Play > Live Playback.

Title
Название партитуры (из File > Score Info).

Composer
Композитор произведения (из File > Score Info).

Lyricist
Автор слов (из File > Score Info).

Arranger
Аранжировщик (из File > Score Info).

Artist
Исполнитель (из File > Score Info).

Copyright
Авторские права (из File > Score Info).

ScoreWidth
Ширина страницы в партитуре (в миллиметрах).

ScoreHeight
Высота страницы в партитуре (в миллиметрах).

StaffHeight
Высота нотоносца в миллиметрах.

OriginalProgramVersion
Версия Sibelius, в которой была создана партитура; целое число следующего формата: (старший номер версии) * 1000 + (младший номер версии) * 100 + (ревизия) * 10. Таким образом, Sibelius v2.11 (v2.1.1) возвратит 2110.

ShowInFocusOnStaves
Переменная для чтения и записи. Если True, то нотоносец будет отображаться со включенной опцией ‘Focus on Staves’ (см. также Sibelius.FocusOnStaves). Эта переменная не может быть установлена в False до тех пор, пока ShowInFocusOnStaves установлен в True хотя бы для одного нотоносца в партитуре.