Master.GetFormulasU-Methode (Visio)

  • Artikel

Gibt die Formeln vieler Zellen zurück.

Syntax

Ausdruck. GetFormulasU( _SID_SRCStream()_ , _formulaArray()_ )

Ausdruck Eine Variable, die ein Master-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
SID_SRCStream() Erforderlich Integer Ein Datenstrom, der die abzufragenden Zellen identifiziert.
formulaArray() Erforderlich Variant Ausgabeparameter. Ein Array, das Formeln abgefragter Zellen empfängt.

Rückgabewert

Nichts

Bemerkungen

Die GetFormulasU-Methode ähnelt der FormulaU-Eigenschaft eines Cell-Objekts , mit der Ausnahme, dass Sie sie verwenden können, um die Formeln vieler Zellen gleichzeitig und nicht von einer Zelle gleichzeitig abzurufen. Die GetFormulasU-Methode ist eine Spezialisierung der GetResults-Methode , die zum Abrufen von Zellformeln oder Ergebnissen verwendet werden kann. Das Einrichten eines Aufrufs der GetFormulasU-Methode erfordert etwas weniger Arbeit als das Einrichten der GetResults-Methode .

Verwenden Sie die GetFormulasU-Methode , um Formeln in universeller Syntax einer beliebigen Gruppe von Zellen in einer beliebigen Gruppe von Formen der Seite oder des Masters abzurufen.

SID_SRCStream() ist ein Array von ganzen 2-Byte-Zahlen. SID_SRCStream() sollte ein eindimensionales Array von 4 n 2-Byte-Ganzzahlen für n>= 1 sein. Die GetFormulasU-Methode interpretiert SID_SRCStream() folgendermaßen:

{sheetID, sectionIdx, rowIdx, cellIdx}n

Dabei ist sheetID die ID-Eigenschaft des Shape-Objekts auf dem Zeichenblatt oder Master, dessen Zellformel abgerufen werden soll.

Hinweis

Wenn die sheetID in einem Eintrag visInvalShapeID (-1) ist oder das untere Byte von sectionIdxvisSectionInval (255) ist, wird der Eintrag ignoriert, und eine leere Variante wird im entsprechenden Ergebnisarrayeintrag zurückgegeben. Der Grund dafür ist, dass das gleiche SID_SRCStream() -Array für mehrere Aufrufe von GetFormulasU, SetFormulas und ähnlichen Methoden verwendet werden kann, wobei der Aufrufer nur geringfügige Änderungen am Datenstrom zwischen Aufrufen vornehmen muss.

Wenn die GetFormulasU-Methode erfolgreich ist, gibt formulaArray() ein eindimensionales Array von n Varianten zurück, die von 0 bis n - 1 indiziert sind. Jede Variante gibt eine Formel als Zeichenfolge zurück. formulaArray() ist ein out-Parameter, der von der GetFormulasU-Methode zugeordnet wird, die den Besitz an den Aufrufer zurückgibt. Der Aufrufer sollte zum Schluss die SafeArrayDestroy-Prozedur für das zurückgegebene Array ausführen. Beachten Sie, dass die SafeArrayDestroy-Prozedur den Nebeneffekt hat, dass die Varianten, auf die von den Einträgen des Arrays verwiesen wird, gelöscht werden, sodass die Zuordnung aller Zeichenfolgen aufgehoben wird, die die GetFormulasU-Methode zurückgibt. (Microsoft Visual Basic und Visual Basic for Applications übernehmen dies für Sie.) Die GetFormulasU-Methode schlägt fehl, wenn formulaArray()null ist.

Hinweis

Ab Microsoft Visio 2000 können Sie sowohl lokale als auch universelle Namen verwenden, um auf Shapes, Master-Shapes, Dokumente, Zeichenblätter, Zeilen, Add-Ons, Zellen, Hyperlinks, Formatvorlagen, Schriftarten, Master-Shape-Verknüpfungen, Benutzeroberflächenobjekte und Layer von Visio zu verweisen. Wenn ein Benutzer z. B. ein Shape verwendet, gibt er einen lokalen Namen an. Ab Microsoft Office Visio 2003 werden in der ShapeSheet-Kalkulationstabelle nur universelle Namen in Zellformeln und Werten angezeigt. (In früheren Versionen wurden universelle Namen in der Benutzeroberfläche nicht angezeigt.)

Als Entwickler können Sie universelle Namen in einem Programm verwenden, falls Sie einen Namen nicht jedes Mal ändern möchten, wenn eine Lösung lokalisiert wird. Verwenden Sie die GetFormulas-Methode, um mehr als eine Formel abzurufen, wenn Sie die lokale Syntax verwenden. Verwenden Sie die GetFormulasU-Methode, um mehr als eine Formel abzurufen, wenn Sie die universelle Syntax verwenden.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.