ChartShape Klasse

ChartShape Klasse

Stellt die Form des Diagramms dar. Eigenschaften und Methoden für das ChartObject-Objekt steuern das Erscheinungsbild und die Größe des eingebetteten Diagramms auf dem Arbeitsblatt.

Nachlass: ChartShapeShape

Der Typ ChartShape macht die folgenden Member verfügbar:

Eigenschaften

EigentumBeschreibung
macro_nameRuft den Namen des Makros ab und legt ihn fest.
is_equationGibt an, ob die Form nur eine Gleichung enthält.
is_smart_artGibt an, ob es sich bei der Form um Smart Art handelt.
z_order_positionGibt die Position einer Form in der Z-Reihenfolge zurück.
nameRuft den Namen der Form ab und legt ihn fest.
alternative_textGibt die beschreibende (alternative) Textzeichenfolge des Shape-Objekts zurück oder legt sie fest.
titleGibt den Titel (Beschriftung) des aktuellen Formobjekts an.
line_formatGibt ein MsoLineFormat-Objekt zurück, das Linienformatierungseigenschaften für die angegebene Form enthält.
fill_formatGibt ein MsoFillFormat-Objekt zurück, das Füllformatierungseigenschaften für die angegebene Form enthält.
lineRuft den Linienstil ab
fillGibt ein Shape.fill_format-Objekt zurück, das Füllungsformatierungseigenschaften für die angegebene Form enthält.
shadow_effectStellt ein ShadowEffect-Objekt dar, das den Schatteneffekt für das Diagrammelement oder die Form angibt.
reflectionStellt ein ReflectionEffect-Objekt dar, das den Reflexionseffekt für das Diagrammelement oder die Form angibt.
glowStellt ein GlowEffect-Objekt dar, das den Glüheffekt für das Diagrammelement oder die Form angibt.
soft_edgesRuft den auf die Kanten anzuwendenden Unschärferadius in Punkteinheiten ab und legt diesen fest.
three_d_formatRuft das 3D-Format der Form ab und legt es fest.
text_frameGibt ein TextFrame-Objekt zurück, das die Ausrichtungs- und Verankerungseigenschaften für die angegebene Form enthält.
format_pictureRuft die Optionen des Bildformats ab und legt diese fest.
is_hiddenGibt an, ob das Objekt sichtbar ist.
is_lock_aspect_ratio„True“ bedeutet, dass keine Änderungen im Seitenverhältnis zulässig sind.
rotation_angleRuft die Drehung der Form ab und legt sie fest.
hyperlinkRuft den Hyperlink der Form ab.
idRuft den Bezeichner dieser Form ab.
spidGibt eine optionale Zeichenfolge an, die eine Anwendung zum Identifizieren der bestimmten Form verwenden kann.
sptGibt eine optionale Zahl an, die eine Anwendung verwenden kann, um die bestimmte Form einem definierten Formtyp zuzuordnen.
worksheetRuft das Shape.worksheet-Objekt ab, das diese Form enthält.
is_groupGibt an, ob es sich bei der Form um eine Gruppe handelt.
is_in_groupGibt an, ob die Form gruppiert ist.
is_word_artGibt an, ob es sich bei dieser Form um eine Wortkunst handelt.
text_effectGibt ein TextEffectFormat-Objekt zurück, das Texteffektformatierungseigenschaften für die angegebene Form enthält.
Gilt für Shape-Objekte, die WordArt darstellen.
is_lockedTrue, wenn das Objekt gesperrt ist, False, wenn das Objekt geändert werden kann, während das Blatt geschützt ist.
is_printableTrue, wenn das Objekt druckbar ist
mso_drawing_typeRuft den MSO-Zeichnungstyp ab.
auto_shape_typeRuft den automatischen Formtyp ab und legt ihn fest.
anchor_typeRuft den Platzhalter für den Formanker ab und legt ihn fest.
placementStellt die Art und Weise dar, wie das Zeichenobjekt an die darunter liegenden Zellen angehängt wird.
Die Eigenschaft steuert die Platzierung eines Objekts auf einem Arbeitsblatt.
upper_left_rowStellt den Zeilenindex der oberen linken Ecke dar.
upper_delta_yRuft den vertikalen Versatz der Form von ihrer oberen linken Eckreihe ab oder legt diesen fest.
upper_left_columnStellt den Spaltenindex in der oberen linken Ecke dar.
upper_delta_xRuft den horizontalen Versatz der Form von ihrer oberen linken Eckspalte ab oder legt diesen fest.
lower_right_rowStellt den Zeilenindex in der unteren rechten Ecke dar.
lower_delta_yRuft den vertikalen Versatz der Form von der unteren rechten Eckreihe ab oder legt diesen fest.
lower_right_columnStellt den Spaltenindex in der unteren rechten Ecke dar.
lower_delta_xRuft den horizontalen Versatz der Form von ihrer unteren rechten Eckspalte ab oder legt diesen fest.
rightStellt die Breite des horizontalen Versatzes der Form von ihrer unteren rechten Eckspalte in der Einheit Pixel dar.
bottomStellt die Breite des vertikalen Versatzes der Form von ihrer unteren unteren Eckreihe in Pixeleinheiten dar.
widthStellt die Breite der Form in der Einheit Pixel dar.
width_inchStellt die Breite der Form in der Einheit Zoll dar.
width_ptStellt die Breite der Form in Punkteinheiten dar.
width_cmStellt die Breite der Form in der Einheit Zentimeter dar.
heightStellt die Höhe der Form in der Einheit Pixel dar.
height_inchStellt die Höhe der Form in der Einheit Zoll dar.
height_ptStellt die Höhe der Form in Punkteinheiten dar.
height_cmStellt die Höhe der Form in der Einheit Zentimeter dar.
leftStellt den horizontalen Versatz der Form von ihrer linken Spalte in Pixeleinheiten dar.
left_inchStellt den horizontalen Versatz der Form von ihrer linken Spalte in der Einheit Zoll dar.
left_cmStellt den horizontalen Versatz der Form von ihrer linken Spalte in der Einheit Zentimeter dar.
topStellt den vertikalen Versatz der Form von ihrer oberen Reihe in Pixeleinheiten dar.
top_inchStellt den vertikalen Versatz der Form von ihrer oberen Reihe in der Einheit Zoll dar.
top_cmStellt den vertikalen Versatz der Form von ihrer oberen Reihe in der Einheit Zentimeter dar.
top_to_cornerRuft den vertikalen Versatz der Form vom oberen Rand des Arbeitsblatts in Pixeleinheiten ab und legt ihn fest.
left_to_cornerRuft den horizontalen Versatz der Form vom linken Rand des Arbeitsblatts ab und legt diesen fest.
xRuft den horizontalen Versatz der Form vom linken Rand des Arbeitsblatts in Pixeleinheiten ab und legt diesen fest.
yRuft den vertikalen Versatz der Form vom oberen Rand des Arbeitsblatts in Pixeleinheiten ab und legt diesen fest.
width_scaleRuft die Breitenskala in Prozent der ursprünglichen Bildbreite ab und legt diese fest.
Wenn es sich bei der Form nicht um ein Bild handelt, gibt die Eigenschaft „WidthScale“ nur 100 zurück.
height_scaleRuft die Höhenskala in Prozent der ursprünglichen Bildhöhe ab und legt sie fest.
Wenn es sich bei der Form nicht um ein Bild handelt, gibt die HeightScale-Eigenschaft nur 100 zurück;
top_in_shapeStellt den vertikalen Versatz der Form vom oberen Rand der übergeordneten Form dar.
in der Einheit 1/4000 der Höhe der übergeordneten Form.
left_in_shapeStellt den horizontalen Versatz der Form vom linken Rand der übergeordneten Form dar.
in der Einheit 1/4000 der Breite der übergeordneten Form.
width_in_shapeStellt die Breite der Form in Einheiten von 1/4000 der übergeordneten Form dar.
height_in_shapeStellt den vertikalen Versatz der Form vom oberen Rand der übergeordneten Form in der Einheit 1/4000 der Höhe der übergeordneten Form dar.
groupRuft die Gruppenform ab, die diese Form enthält.
typeRuft den automatischen Formtyp ab.
has_lineRuft ab und legt fest, dass der Linienrand der Form sichtbar ist.
is_filledGibt an, ob das Füllformat sichtbar ist.
is_flipped_horizontallyRuft ab und legt fest, ob die Form horizontal gespiegelt wird.
is_flipped_verticallyRuft ab und legt fest, ob die Form vertikal gespiegelt wird.
actual_lower_right_rowHolen Sie sich die tatsächliche untere Reihe.
connection_pointsHolen Sie sich die Verbindungspunkte
relative_to_original_picture_sizeGibt an, ob die Form relativ zur Originalbildgröße ist.
linked_cellRuft den mit dem Wert des Steuerelements verknüpften Arbeitsblattbereich ab oder legt diesen fest.
input_rangeRuft den Arbeitsblattbereich ab, der zum Füllen des angegebenen Kombinationsfelds verwendet wird, oder legt diesen fest.
text_shape_typeRuft den voreingestellten Textformtyp ab und legt ihn fest.
text_bodyRuft die Einstellung des Texts der Form ab und legt diese fest.
fontStellt die Schriftart der Form dar.
text_optionsStellt die Textoptionen der Form dar.
textStellt die Zeichenfolge in diesem TextBox-Objekt dar.
is_rich_textOb es sich bei dem Text um Rich Text handelt oder nicht.
html_textRuft die HTML-Zeichenfolge ab, die Daten und einige Formate in diesem Textfeld enthält, und legt diese fest.
text_vertical_overflowRuft den vertikalen Textüberlauftyp der Form ab, die Text enthält, und legt diesen fest.
text_horizontal_overflowRuft den horizontalen Textüberlauftyp der Form ab, die Text enthält, und legt diesen fest.
is_text_wrappedRuft den Textumbruchtyp der Form ab, die Text enthält, und legt diesen fest.
text_orientation_typeRuft den Textausrichtungstyp der Form ab und legt ihn fest.
text_horizontal_alignmentRuft den horizontalen Textausrichtungstyp der Form ab und legt diesen fest.
text_vertical_alignmentRuft den vertikalen Textausrichtungstyp der Form ab und legt diesen fest.
text_directionRuft die Richtung des Textflusses für dieses Objekt ab bzw. legt sie fest.
control_dataRuft die Kontrolldaten ab.
active_x_controlRuft das ActiveX-Steuerelement ab.
pathsRuft die Pfade einer benutzerdefinierten geometrischen Form ab.
geometryRuft die Geometrie ab
create_idRuft die Erstellungs-ID für diese Form ab und legt sie fest.
chartGibt ein Chart-Objekt zurück, das das im Objekt enthaltene Diagramm darstellt.

Methoden

MethodeBeschreibung
to_imageErstellt das Formbild und speichert es in einem Stream im angegebenen Format.
to_imageSpeichert die Form in einer Datei.
to_imageSpeichert die Form in einem Stream.
format_charactersFormatiert einige Zeichen mit der Schriftarteinstellung.
format_charactersFormatiert einige Zeichen mit der Schriftarteinstellung.
get_result_of_smart_artKonvertieren von Smart Art in gruppierte Formen.
to_front_or_backBringt die Form nach vorne oder nach hinten.
get_locked_propertyRuft den Wert der gesperrten Eigenschaft ab.
set_locked_propertyLegen Sie die gesperrte Eigenschaft fest.
add_hyperlinkFügt der Form einen Hyperlink hinzu.
remove_hyperlinkEntfernen Sie den Hyperlink der Form.
move_to_rangeVerschiebt die Form in einen angegebenen Bereich.
align_top_right_cornerVerschiebt das Bild in die rechte obere Ecke.
get_connection_pointsHolen Sie sich die Verbindungspunkte
get_linked_cellRuft den mit dem Wert des Steuerelements verknüpften Bereich ab.
set_linked_cellLegt den Bereich fest, der mit dem Wert des Steuerelements verknüpft ist.
get_input_rangeRuft den Bereich ab, der zum Füllen des Steuerelements verwendet wird.
set_input_rangeLegt den Bereich fest, der zum Füllen des Steuerelements verwendet wird.
update_selected_valueAktualisieren Sie den ausgewählten Wert um den Wert der verknüpften Zelle.
calculate_text_sizeBerechnen Sie den Textbereich neu
charactersGibt ein Characters-Objekt zurück, das einen Bereich von Zeichen im Text darstellt.
get_charactersGibt alle Characters-Objekte zurück
das eine Reihe von Zeichen im Text darstellt.
get_rich_formattingsGibt alle Characters-Objekte zurück
das eine Reihe von Zeichen im Text darstellt.
remove_active_x_controlEntfernen Sie das ActiveX-Steuerelement.
is_same_settingGibt zurück, ob die Form gleich ist.
get_actual_boxErmitteln Sie die tatsächliche Position und Größe der Form (nach der Anwendung von Drehung, Spiegelung usw.)

Beispiel

from aspose.cells import Workbook
from aspose.cells.charts import ChartType

# Instantiating a Workbook object
workbook = Workbook()
# Obtaining the reference of the first worksheet
worksheet = workbook.worksheets[0]
# Adding a sample value to "A1" cell
worksheet.cells.get("A1").put_value(50)
# Adding a sample value to "A2" cell
worksheet.cells.get("A2").put_value(100)
# Adding a sample value to "A3" cell
worksheet.cells.get("A3").put_value(150)
# Adding a sample value to "B1" cell
worksheet.cells.get("B1").put_value(60)
# Adding a sample value to "B2" cell
worksheet.cells.get("B2").put_value(32)
# Adding a sample value to "B3" cell
worksheet.cells.get("B3").put_value(50)
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.PIE_EXPLODED, 5, 0, 25, 10)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B3"
chart.n_series.add("A1:B3", True)
# Show Data Labels
chart.n_series[0].data_labels.show_value = True
# Getting Chart Shape
chartShape = chart.chart_object
# Set Lower Right Column
chartShape.lower_right_column = 10
# Set LowerDeltaX
chartShape.lower_delta_x = 1024
# Saving the Excel file
workbook.save("book1.xls")

Siehe auch