Elements Reference

MuseScore represents musical notation using a hierarchy of elements. This document describes the available element types and their properties.

Source Files

• src/engraving/api/v1/elements.h
• src/engraving/api/v1/qmlpluginapi.h (enumerations)

Creating Elements

// Create a new element
var element = newElement(Element.STAFF_TEXT);

// Set properties
element.text = "Hello";

// Add to score via cursor
cursor.add(element);

Element Types (Element.*)

Note-Related Elements

Text Elements

Lines and Spanners

Articulations and Ornaments

Clefs, Key, Time Signatures

Barlines and Structure

Frames

Guitar/Fretted Elements

Layout Elements

Other Elements

Common Element Properties

All elements share these base properties:

Positioning Properties

Staff Properties

Note Properties

// Access note properties
var note = cursor.element.notes[0];
console.log("Pitch: " + note.pitch);
console.log("TPC: " + note.tpc);

// Modify note
curScore.startCmd("Modify Note");
note.pitch = 60;  // Set to Middle C
note.velocity = 80;
curScore.endCmd();

Chord Properties

// Access chord properties
if (cursor.element.type == Element.CHORD) {
    var chord = cursor.element;
    var notes = chord.notes;
    for (var i = 0; i < notes.length; i++) {
        console.log("Note " + i + ": pitch=" + notes[i].pitch);
    }
}

Rest Properties

Text Element Properties

// Create and configure staff text
var text = newElement(Element.STAFF_TEXT);
text.text = "pizz.";
text.placement = Placement.ABOVE;
text.fontSize = 10;

curScore.startCmd("Add Text");
cursor.add(text);
curScore.endCmd();

Dynamic Properties

Tempo Text Properties

Hairpin Properties

Measure Properties

Segment Properties

Segment Types (Segment.*)

Enumerations

Accidental Types (Accidental.*)

Note Head Types (NoteHeadType.*)

Note Head Groups (NoteHeadGroup.*)

Direction (Direction.*)

Placement (Placement.*)

Hairpin Types (HairpinType.*)

Ottava Types (OttavaType.*)

Beam Modes (Beam.*)

Dynamic Types (DynamicType.*)