Статьи

Типы объектов - Selection, Staff, SystemStaff

Объект Выделение (Selection)
for each <переменная> in возвращает все тактовые объекты (BarObject, т.е. все объекты, которые содержатся в такте) в выделении.
for each <тип> <переменная> in возвращает все объекты типа <тип> в выделении. Обратите внимание, что, если выделение является системным выделением (т.е. выделено двойной линией в Sibelius), объекты из системного нотоносца будут возвращены в этих циклах.

Методы:

Отсутствуют.

Переменные:

IsPassage
True, если выделение представляет пассаж (в отличие от множественного выделения).

TopStaff
Номер верхнего нотоносца в пассаже.

BottomStaff
Номер нижнего нотоносца в пассаже.

FirstBarNumber
Номер первого такта в пассаже.

LastBarNumber
Номер последнего такта в пассаже.



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

Методы:

Staff[элемент массива]
Возвращает такт с указанным номером (начиная с 1), например, Staff[1].

NthBar(n)
Возвращает такт с указанным номером, начиная с 1.

AddNote(позиция,звуковысотность,длительность,[залигована [,голос [,диатоническая звуковысотность[,номер струны]]]])
Добавляет ноту; если в указанной позиции уже есть NoteRest , добавляет к нему (тогда значение длительности игнорируется); в противном случае создаёт новое NoteRest. При необходимости добавляет новый такт в конце нотоносца. Позиция измеряется в 1/256 четверти от начала партитуры. Необязательный параметр «залигована » должен быть True, если Вы хотите, чтобы нота была залигована. Нота относится к 1 голосу, если отсутствует необязательный параметр «голос» (может принимать значения 1, 2, 3 или 4). Вы также можете установить параметр «диатоническая звуковысотность», т.е. номер ‘имени ноты’, которому эта нота соответствует; 7 в октаве (35 = средняя До, 36 = Ре, 37 = Ми и т.д.). Если диатоническая звуковысотность равна нулю, то она рассчитывается, исходя из звуковысотности MIDI. Необязательный параметр «номер струны» задаёт номер струны для этой ноты, но он имеет значение только для табулатурных нотоносцев.
Если этот параметр не установлен, номер струны рассчитывается, исходя из текущего типа табулатурного нотоносца и опций гитарной аппликатуры (заданных в Notes > Guitar Tab Fingering).

AddLine(позиция,длительность,индекс стиля линии,[dx],[dy],[номер голоса],[скрытая])
Добавляет линию (см. Описание объекта Такт (Bar) ниже).

AddClef(позиция,стиль ключа)
Добавляет ключ в указанную позицию нотоносца.

CurrentKeySignature(номер такта)
Возвращает Тональность (KeySignature),действительную для указанного такта.

Переменные:

BarCount
Количество тактов в нотоносце.

InstrumentName
Имя инструмента для нотоносца.

DefaultInstrumentName
Имя инструмента по умолчанию (уникальное), для которого этот нотоносец был создан. Оно одинаковое, не зависимо от языковой версии Sibelius, и является предпочтительным при создании инструмента. Для создания инструмента с таким именем передайте ‘True’ в качестве второго аргумента методу Score.CreateInstrument.

NumStavesInSameInstrument
Количество нотоносцев, принадлежащих по умолчанию инструменту, для которого был создан этот нотоносец.

IsSystemStaff
True или False, в зависимости от того, является этот нотоносец системным или нет.

InitialClefStyle
Тип начального ключа нотоносца.

InitialKeySignature
Возвращает объект KeySignature для начала нотоносца.



Системный нотоносец (SystemStaff)
В партитуре имеется всего один объект SystemStaff. SystemStaff содержит объекты, относящиеся ко всем нотоносцам, такие как SpecialBarlines и текст, использующий один из системных стилей. В отличие от обычных нотоносцев, SystemStaff не виден в партитуре. Большинство переменных и методов, поддерживаемых объектами типа Нотоносец (Stave), недоступны для Системного нотоносца. Ниже перечислены те, которые поддерживаются им.

Методы:

SystemStaff[элемент массива]
Возвращает указанный такт (начиная с 1), например, SystemStaff[1].

NthBar(n)
Возвращает указанный такт начиная с 1.

CurrentTimeSignature(номер такта)
Возвращает Размер (TimeSignature), действительный для указанного такта.

CurrentKeySignature(номер такта)
Возвращает Тональность (KeySignature),действительную для указанного такта.

Переменные:

BarCount
Количество тактов в нотоносце.

IsSystemStaff
Возвращает True для SystemStaff.

InitialKeySignature
Возвращает начальную тональность (KeySignature).