Kurs blockieren
Klasse für einen Block. Normalerweise nicht direkt aufgerufen, wird workspace.newBlock() bevorzugt.
Unterschrift:
export declare class Block implements IASTNodeLocation, IDeletable
Implementierungen: IASTNodeLocation, IDeletable
Konstruktoren
Konstruktor | Modifikatoren | Beschreibung |
---|---|---|
(Konstruktor)(workspace, prototypName, opt_id) | Konstruiert eine neue Instanz der Klasse Block |
Attribute
Property | Modifikatoren | Typ | Beschreibung |
---|---|---|---|
childBlocks_ | protected |
dieses[] | |
collapsed_ | protected |
boolean | |
COLLAPSED_FIELD_NAME |
|
String | Die sprachneutrale ID für das minimierte Feld. |
COLLAPSED_INPUT_NAME |
|
String | Die sprachneutrale ID der minimierten Eingabe. |
colour_ | protected |
String | Farbe des Blocks im Format "#RRGGBB" |
compose? | (p1: Blockieren) => ungültig | (Optional) Eine optionale Funktion, die den Block basierend auf den Inhalten des Mutator-Dialogfelds neu konfiguriert. | |
contextMenu | boolean | ||
Daten | String | null | Optionale Textdaten, die zwischen Blöcken und XML ausgetauscht werden Hat keine Wirkung. Kann von Dritten für Meta-Informationen verwendet werden. | |
verzerren? | (p1: Arbeitsbereich) => Blockieren | (Optional) Eine optionale Funktion, mit der die Komponenten dieses Blocks in das Dialogfeld des Mutators eingetragen werden. | |
destroy? | () => void | (Optional) Eine optionale Methode, die bei der Vernichtung aufgerufen wird. | |
domToMutation? | (p1: Element) => void | (Optional) Eine optionale Deserialisierungsmethode, um zu definieren, wie der Mutationsstatus aus XML deserialisiert wird. Dies muss mit der Definition von mutationToDom gekoppelt werden. |
|
EntwicklerVariables abrufen? | () => string[] | (Optional) Eine optionale Property zum Deklarieren von Entwicklervariablen. Gibt eine Liste von Variablennamen zur Verwendung durch Generatoren zurück. Entwicklervariablen werden dem Nutzer nie angezeigt, jedoch im generierten Code als globale Variablen deklariert. | |
Hut? | String | (Optional) Die Bezeichnung des Huttyps. | |
helpUrl | string | Function | null | String für die Blockhilfe oder Funktion, die eine URL zurückgibt. Null für keine Hilfe. | |
Symbole | IIcon[] | ||
id | String | ||
init? | () => void | (Optional) Eine optionale Methode, die während der Initialisierung aufgerufen wird. | |
inputList | Eingabe[] | ||
inputInline? | boolean | (Optional) | |
inputsInlineDefault? | boolean | (Optional) | |
isInFlyout | boolean | ||
isInMutator | boolean | ||
isInsertionMarker_ | protected |
boolean | Dieser Wert ist "True", wenn dieser Block eine Einfügungsmarkierung ist. |
loadExtraState? | (p1: alle) => nichtig | (Optional) Eine optionale Serialisierungsmethode, um zu definieren, wie der zusätzliche Status des Blocks (z. B. Mutationsstatus) von einem JSON-kompatiblen Element deserialisiert wird. Dies muss mit der Definition von saveExtraState gekoppelt werden. |
|
mutationToDom? | (...p1: any[]) => Element | (Optional) Eine optionale Serialisierungsmethode, um zu definieren, wie der Mutationsstatus in XML serialisiert wird Dies muss mit der Definition von domToMutation gekoppelt sein. |
|
nextConnection | Verbindung | null | ||
onchange? | ((p1: Abstract) => void) | null | Optional: Eine optionale Callback-Methode, die verwendet wird, wenn sich der übergeordnete Arbeitsbereich des Blocks ändert. Diese wird normalerweise nur vom Konstruktor, von der Funktion zum Initialisieren des Blocktyps oder von einer Funktion zum Initialisieren von Erweiterungen aufgerufen. | |
outputConnection | Verbindung | null | ||
outputShape_ | protected |
Zahl | null | |
parentBlock_ | protected |
dies | null | |
previousConnection | Verbindung | null | ||
gerendert | boolean | null | ||
RTL | boolean | ||
saveExtraState? | (doFullSerialization?: boolean) => beliebig | (Optional) Eine optionale Serialisierungsmethode, um zu definieren, wie der zusätzliche Status des Blocks (z. B. Mutationsstatus) in einen JSON-kompatiblen Wert serialisiert werden soll. Dies muss mit der Definition von loadExtraState gekoppelt werden. |
|
styleName_ | protected |
String | Name des Blockstils. |
suppressPrefixSuffix | boolean | null | Eine optionale Eigenschaft, mit der das Hinzufügen von STATEMENT_PREFIX und STATEMENT_SUFFIX zu generiertem Code unterdrückt wird. | |
Kurzinfo | Tooltip.TipInfo | ||
Typ | String | ||
Arbeitsbereich | Workspace |
Methoden
Methode | Modifikatoren | Beschreibung |
---|---|---|
addIcon(icon) | Fügt das angegebene Symbol zum Block hinzu. | |
allInputsFilled(opt_shadowBlocksAreFilled) | Prüft rekursiv, ob alle Eingaben für Anweisungen und Werte mit Blöcken gefüllt sind. Prüft auch alle folgenden Anweisungsblöcke in diesem Stapel. | |
appendDummyInput(name) | Hängt eine Dummy-Eingabezeile an. | |
appendEndRowInput(name) | Hängt eine Eingabe an, die die Zeile beendet. | |
appendInput(input) | Hängt die angegebene Eingabezeile an. Ermöglicht das Anhängen benutzerdefinierter Eingaben an den Block. |
|
appendStatementInput(name) | Hängt eine Anweisungseingabezeile an. | |
appendValueInput(name) | Hängt eine Werteingabezeile an. | |
bumpNeighbours() | Bringen Sie nicht verbundene Blöcke in Ausrichtung. Zwei Blöcke, die eigentlich nicht miteinander verbunden sind, sollten nicht zufällig auf dem Bildschirm übereinander angeordnet sein. | |
dispose(healStack) | Diesen Block entsorgen. | |
disposeInternal() | protected |
Beseitigt diesen Block, ohne die für den oberen Block erforderlichen Schritte zu tun. Es werden z.B. keine Ereignisse ausgelöst oder der Block vom Stromnetz getrennt. |
doInit_() | protected |
Ruft die Funktion „init()“ auf, verarbeitet die Auslösung des zugehörigen Ereignisses usw. |
getChildren(ordered) | Suchen Sie alle Blöcke, die direkt in diesem Blöcke verschachtelt sind. Enthält Werte- und Anweisungseingaben sowie folgende Anweisungen. Schließt alle Verbindungen auf einem Ausgabetab oder einer vorhergehenden Anweisung aus. Blöcke werden optional nach Position (von oben nach unten) sortiert. | |
getColour() | Farbe eines Blocks abrufen | |
getCommentText() | Gibt den Kommentar zu diesem Block zurück (oder null, wenn kein Kommentar vorhanden ist). | |
getDescendants(ordered) | Suchen Sie alle Blöcke, die direkt oder indirekt in diesem Blöcke verschachtelt sind. Nimmt diesen Block in die Liste auf. Enthält Werte- und Anweisungseingaben sowie folgende Anweisungen. Schließt alle Verbindungen auf einem Ausgabetab oder vorhergehenden Anweisungen aus. Blöcke werden optional nach Position (von oben nach unten) sortiert. | |
getField(name) | Gibt das benannte Feld eines Blocks zurück | |
getFieldValue(name) | Gibt den sprachneutralen Wert des angegebenen Felds zurück. | |
getHue(). | Ruft den HSV-Farbton eines Blocks ab. Null, wenn der Farbton nicht festgelegt ist. | |
getIcon(type) | ||
getIcons() | ||
getInheritedDisabled() | Ermitteln Sie, ob die Blockierung aufgrund von übergeordneten Elementen deaktiviert wurde. Die eigene deaktivierte Property der Blockierung wird nicht berücksichtigt. | |
getInput(name) | Ruft das benannte Eingabeobjekt ab. | |
getInputsInline() | Ruft ab, ob Werteingaben horizontal oder vertikal angeordnet sind. | |
getInputTargetBlock(name) | Ruft den Block ab, der mit der benannten Eingabe verknüpft ist. | |
getInputWithBlock(block) | Gibt die Eingabe zurück, die eine Verbindung zum angegebenen Block herstellt. | |
getNextBlock() | Gibt den nächsten Anweisungsblock zurück, der direkt mit diesem Block verbunden ist. | |
getOutputShape() | Ruft die Ausgabeform des Blocks ab. | |
getParent() | Gibt den übergeordneten Block zurück oder null, wenn sich dieser Block auf der obersten Ebene befindet. Der übergeordnete Block ist entweder der Block, der mit der vorherigen Verbindung verbunden ist (bei einem Anweisungsblock), oder der Block, der mit der Ausgabeverbindung verbunden ist (bei einem Wertblock). | |
getPreviousBlock() | Gibt den Block zurück, der mit der vorherigen Verbindung verbunden ist. | |
getRelativeToSurfaceXY(). | Gibt die Koordinaten der oberen linken Ecke dieses Blocks relativ zum Ursprung der Zeichnungsoberfläche (0,0) in Arbeitsbereichseinheiten zurück. | |
getRootBlock() | Geben Sie den obersten Block in der Baumstruktur dieses Blocks zurück. Dieses Element wird selbst zurückgegeben, wenn sich dieser Block auf der obersten Ebene befindet. | |
getStyleName() | Rufen Sie den Namen des Blockstils ab. | |
getSurroundParent() | Return the parent block that surrounds the current block, or null if this block has no surrounding block. Ein übergeordneter Block kann einfach die vorherige Anweisung sein, während der umgebende Block eine if-Anweisung, eine während-Schleife usw. ist. | |
getTooltip() | Gibt die Kurzinfo für diesen Block zurück | |
getVars() | Gibt alle Variablen zurück, auf die in diesem Block verwiesen wird. | |
hasIcon(type) | ||
initModel() | Rufen Sie initModel für alle Felder des Blocks auf. Kann mehrmals aufgerufen werden. InitModel oder initSvg muss nach dem Erstellen eines Blocks und vor der ersten Interaktion mit diesem aufgerufen werden. Interaktionen sind UI-Aktionen (z.B. Klicken und Ziehen) und das Auslösen von Ereignissen (z.B. Erstellen, Löschen und Ändern). | |
isCollapsed() | Ruft ab, ob der Block minimiert ist oder nicht. | |
isDeletable() | Gibt an, ob dieser Block löschbar ist oder nicht. | |
isDisposed() | Gibt zurück, ob dieser Block verworfen / gelöscht wurde. | |
isDuplicatable() | Ruft ab, ob der Block duplizierbar ist oder nicht. Durch das Duplizieren dieses Blocks und der Nachfolger wird dieser Block zur Überschreitung der Kapazität des Arbeitsbereichs. Dieser Block kann nicht dupliziert werden. Wenn durch das Duplizieren dieses Blocks und von Nachfolgertypen ein beliebiger Typ über ihre maxInstances hinausgeht, kann dieser Block nicht dupliziert werden. | |
isEnabled() | Ermitteln Sie, ob diese Blockierung aktiviert ist oder nicht. | |
isInsertionMarker() | Ruft ab, ob dieser Block ein Einfügungsmarkierungsblock ist oder nicht. | |
isOwnDeletable() | Gibt an, ob die eigene löschbare Eigenschaft dieses Blocks „true“ oder „false“ ist. | |
isOwnEditable() | Gibt an, ob die bearbeitbare Eigenschaft dieser Blockierung wahr oder falsch ist. | |
isShadow() | Ermitteln Sie, ob dieser Block ein Schattenblock ist. | |
jsonInit(json) | Initialisieren Sie diesen Block mit einer plattformübergreifenden, internationalisierungsfreundlichen JSON-Beschreibung. | |
mixin(mixinObj, opt_disableCheck) | Fügen Sie diesem Blockobjekt Schlüssel/Wert-Paare aus mixinObj hinzu. Standardmäßig wird mit dieser Methode geprüft, ob die Schlüssel in mixinObj vorhandene Werte im Block, einschließlich Prototyp-Werten, nicht überschreiben. Das bietet eine gewisse Absicherung gegen Inkompatibilitäten von Mixin-/Erweiterungen mit zukünftigen Blockfunktionen. Diese Prüfung kann deaktiviert werden, indem „true“ als zweites Argument übergeben wird. | |
moveBy(dx, dy, reason) | Block wird um einen relativen Offset verschoben. | |
moveInputBefore(name, refName) | Verschiebt einen benannten Eingang an eine andere Position in diesem Block. | |
moveNumberedInputBefore(inputIndex, refIndex) | Verschiebt einen nummerierten Eingang an eine andere Position in diesem Block. | |
removeIcon(type) | Entfernt das Symbol, dessen getType mit dem angegebenen type iconType übereinstimmt, aus dem Block. | |
removeInput(name, opt_quiet) | Entfernt eine Eingabe aus diesem Block. | |
renameVarById(oldId, newId) | Benachrichtigung, dass eine Variable umbenannt wird. Wenn die ID mit einer der Variablen dieses Blocks übereinstimmt, benennen Sie die ID um. | |
setCollapsed(collapsed) | Legen Sie fest, ob der Block minimiert werden soll. | |
setColour(colour) | Farbe eines Blocks ändern | |
setCommentText(text) | Kommentartext für diesen Block festlegen. | |
setDeletable(deletable) | Legen Sie fest, ob dieser Block gelöscht werden kann oder nicht. | |
setEditable(editable) | Legen Sie fest, ob diese Blockierung bearbeitet werden kann. | |
setEnabled(enabled) | Legen Sie fest, ob die Blockierung aktiviert ist. | |
setFieldValue(newValue, name) | Legt den Wert des angegebenen Felds für diesen Block fest. | |
setHelpUrl(url) | Geben Sie die URL der Hilfeseite dieser Blockierung an. | |
setInputsInline(newBoolean) | Legt fest, ob Werteingaben horizontal oder vertikal angeordnet werden. | |
setMovable(movable) | Legen Sie fest, ob dieser Block verschiebbar ist. | |
setMutator(_mutator) | Ein Mutator-Dialogfeld für diesen Block festlegen. | |
setNextStatement(newBoolean, opt_check) | Legen Sie fest, ob ein weiterer Block an den unteren Rand dieses Blocks verkettet werden kann. | |
setOnChange(onchangeFn) | Legt eine Callback-Funktion fest, die immer dann verwendet wird, wenn sich der übergeordnete Arbeitsbereich des Blocks ändert. Dabei werden alle vorherigen onchange-Handler ersetzt. Diese wird normalerweise nur vom Konstruktor, von der Funktion zum Initialisieren des Blocktyps oder von einer Funktion zum Initialisieren von Erweiterungen aufgerufen. | |
setOutput(newBoolean, opt_check) | Legt fest, ob dieser Block einen Wert zurückgibt. | |
setOutputShape(outputShape) | Legt die Ausgabeform des Blocks fest. | |
setPreviousStatement(newBoolean, opt_check) | Legen Sie fest, ob dieser Block mit dem Ende eines anderen Blocks verkettet werden kann. | |
setStyle(blockStyleName) | Legt die Stil- und Farbwerte eines Blocks fest. | |
setTooltip(newTip) | Legt die Kurzinfo für diesen Block fest. | |
setWarningText(_text, _opt_id) | Legen Sie den Warntext für diesen Block fest. | |
toDevString() | Diese Methode gibt eine Zeichenfolge zurück, die diesen Block in den Entwicklerbegriffen beschreibt (Typname und -ID; nur Englisch). Ist für die Verwendung in Konsolenprotokollen und -fehlern vorgesehen. Falls Sie einen String benötigen, in dem die Muttersprache des Nutzers verwendet wird (einschließlich Blocktext, Feldwerte und untergeordnete Blöcke), verwenden Sie [toString()]. |
|
toString(opt_maxLength, opt_emptyToken) | Erstellen Sie eine menschenlesbare Textdarstellung dieses Blocks und aller untergeordneten Elemente. | |
unplug(opt_healStack) | Entfernen Sie diesen Block aus dem oberen Block. Wenn dieser Block eine Anweisung ist, verbinden Sie optional den darunter liegenden Block mit dem Block oben. |