Shape classe

Shape classe

Rappresenta l’oggetto msodrawing.

Il tipo Shape espone i seguenti membri:

Proprietà

ProprietàDescrizione
macro_nameOttiene e imposta il nome della macro.
is_equationIndica se la forma contiene solo un’equazione.
is_smart_artIndica se la forma è arte intelligente.
z_order_positionRestituisce la posizione di una forma nell’ordine z.
nameOttiene e imposta il nome della forma.
alternative_textRestituisce o imposta la stringa di testo descrittivo (alternativa) dell’oggetto Shape.
titleSpecifica il titolo (didascalia) dell’oggetto forma corrente.
line_formatRestituisce un oggetto MsoLineFormat che contiene le proprietà di formattazione della linea per la forma specificata.
fill_formatRestituisce un oggetto MsoFillFormat che contiene le proprietà di formattazione del riempimento per la forma specificata.
lineOttiene lo stile della linea
fillRestituisce un oggetto Shape.fill_format che contiene le proprietà di formattazione del riempimento per la forma specificata.
shadow_effectRappresenta un oggetto ShadowEffect che specifica l’effetto ombra per l’elemento o la forma del grafico.
reflectionRappresenta un oggetto ReflectionEffect che specifica l’effetto di riflessione per l’elemento o la forma del grafico.
glowRappresenta un oggetto GlowEffect che specifica l’effetto bagliore per l’elemento o la forma del grafico.
soft_edgesOttiene e imposta il raggio di sfocatura da applicare ai bordi, in unità di punti.
three_d_formatOttiene e imposta il formato 3D della forma.
text_frameRestituisce un oggetto TextFrame che contiene le proprietà di allineamento e ancoraggio per la forma specificata.
format_pictureOttiene e imposta le opzioni del formato immagine.
is_hiddenIndica se l’oggetto è visibile.
is_lock_aspect_ratioVero significa che non consente modifiche alle proporzioni.
rotation_angleOttiene e imposta la rotazione della forma.
hyperlinkOttiene il collegamento ipertestuale della forma.
idOttiene l’identificatore di questa forma.
spidSpecifica una stringa facoltativa che un’applicazione può utilizzare per identificare la forma particolare.
sptSpecifica un numero facoltativo che un’applicazione può utilizzare per associare la forma particolare a un tipo di forma definito.
worksheetOttiene l’oggetto Shape.worksheet che contiene questa forma.
is_groupIndica se la forma è un gruppo.
is_in_groupIndica se la forma è raggruppata.
is_word_artIndica se questa forma è una parola d’arte.
text_effectRestituisce un oggetto TextEffectFormat che contiene proprietà di formattazione dell’effetto testo per la forma specificata.
Si applica agli oggetti Shape che rappresentano WordArt.
is_lockedVero se l’oggetto è bloccato, Falso se l’oggetto può essere modificato quando il foglio è protetto.
is_printableVero se l’oggetto è stampabile
mso_drawing_typeOttiene il tipo di disegno MSO.
auto_shape_typeOttiene e imposta il tipo di forma automatica.
anchor_typeOttiene e imposta il segnaposto di ancoraggio della forma.
placementRappresenta il modo in cui l’oggetto di disegno è collegato alle celle sottostanti.
La proprietà controlla il posizionamento di un oggetto su un foglio di lavoro.
upper_left_rowRappresenta l’indice della riga nell’angolo superiore sinistro.
upper_delta_yOttiene o imposta l’offset verticale della forma dalla riga dell’angolo superiore sinistro.
upper_left_columnRappresenta l’indice della colonna nell’angolo superiore sinistro.
upper_delta_xOttiene o imposta l’offset orizzontale della forma dalla colonna dell’angolo superiore sinistro.
lower_right_rowRappresenta l’indice della riga nell’angolo inferiore destro.
lower_delta_yOttiene o imposta l’offset verticale della forma dalla riga dell’angolo inferiore destro.
lower_right_columnRappresenta l’indice della colonna nell’angolo inferiore destro.
lower_delta_xOttiene o imposta l’offset orizzontale della forma dalla colonna dell’angolo inferiore destro.
rightRappresenta la larghezza dell’offset orizzontale della forma dalla colonna dell’angolo inferiore destro, in unità di pixel.
bottomRappresenta la larghezza dell’offset verticale della forma dalla riga dell’angolo inferiore inferiore, in unità di pixel.
widthRappresenta la larghezza della forma, in unità di pixel.
width_inchRappresenta la larghezza della forma, in unità di pollice.
width_ptRappresenta la larghezza della forma, in unità di punto.
width_cmRappresenta la larghezza della forma, in unità di centimetri.
heightRappresenta l’altezza della forma, in unità di pixel.
height_inchRappresenta l’altezza della forma, in unità di pollici.
height_ptRappresenta l’altezza della forma, in unità di punti.
height_cmRappresenta l’altezza della forma, in unità di centimetri.
leftRappresenta l’offset orizzontale della forma dalla colonna di sinistra, in unità di pixel.
left_inchRappresenta l’offset orizzontale della forma dalla colonna di sinistra, in unità di pollici.
left_cmRappresenta l’offset orizzontale della forma dalla colonna di sinistra, in unità di centimetri.
topRappresenta l’offset verticale della forma dalla riga superiore, in unità di pixel.
top_inchRappresenta l’offset verticale della forma dalla riga superiore, in unità di pollici.
top_cmRappresenta l’offset verticale della forma dalla riga superiore, in unità di centimetri.
top_to_cornerOttiene e imposta l’offset verticale della forma dal bordo superiore del foglio di lavoro, in unità di pixel.
left_to_cornerOttiene e imposta l’offset orizzontale della forma dal bordo sinistro del foglio di lavoro.
xOttiene e imposta l’offset orizzontale della forma dal bordo sinistro del foglio di lavoro, in unità di pixel.
yOttiene e imposta l’offset verticale della forma dal bordo superiore del foglio di lavoro, in unità di pixel.
width_scaleOttiene e imposta la scala della larghezza, in unità percentuali della larghezza dell’immagine originale.
Se la forma non è un’immagine, la proprietà LarghezzaScale restituisce solo 100;
height_scaleOttiene e imposta la scala dell’altezza, in unità percentuali dell’altezza dell’immagine originale.
Se la forma non è un’immagine, la proprietà HeightScale restituisce solo 100;
top_in_shapeRappresenta l’offset verticale della forma dal bordo superiore della forma genitore,
in unità di 1/4000 dell’altezza della forma madre.
left_in_shapeRappresenta l’offset orizzontale della forma dal bordo sinistro della forma genitore,
in unità di 1/4000 della larghezza della forma principale.
width_in_shapeRappresenta la larghezza della forma, in unità di 1/4000 della forma padre.
height_in_shapeRappresenta l’offset verticale della forma dal bordo superiore della forma genitore, in unità di 1/4000 dell’altezza della forma genitore.
groupOttiene la forma del gruppo che contiene questa forma.
typeOttiene il tipo di forma automatica.
has_lineOttiene e imposta il bordo della linea della forma visibile.
is_filledIndica se il formato di riempimento è visibile.
is_flipped_horizontallyOttiene e imposta se la forma viene capovolta orizzontalmente.
is_flipped_verticallyOttiene e imposta se la forma viene capovolta verticalmente.
actual_lower_right_rowOttieni la riga inferiore effettiva.
connection_pointsOttieni i punti di connessione
relative_to_original_picture_sizeIndica se la forma è relativa alla dimensione dell’immagine originale.
linked_cellOttiene o imposta l’intervallo del foglio di lavoro collegato al valore del controllo.
input_rangeOttiene o imposta l’intervallo del foglio di lavoro utilizzato per riempire la casella combinata specificata.
text_shape_typeOttiene e imposta il tipo di forma del testo preimpostato.
text_bodyOttiene e imposta l’impostazione del testo della forma.
fontRappresenta il carattere della forma.
text_optionsRappresenta le opzioni di testo della forma.
textRappresenta la stringa in questo oggetto TextBox.
is_rich_textSe il testo è rich text o meno.
html_textOttiene e imposta la stringa html che contiene dati e alcuni formati in questa casella di testo.
text_vertical_overflowOttiene e imposta il tipo di overflow verticale del testo della forma che contiene testo.
text_horizontal_overflowOttiene e imposta il tipo di overflow orizzontale del testo della forma che contiene testo.
is_text_wrappedOttiene e imposta il tipo di testo avvolto nella forma che contiene testo.
text_orientation_typeOttiene e imposta il tipo di orientamento del testo della forma.
text_horizontal_alignmentOttiene e imposta il tipo di allineamento orizzontale del testo della forma.
text_vertical_alignmentOttiene e imposta il tipo di allineamento verticale del testo della forma.
text_directionOttiene/imposta la direzione del flusso del testo per questo oggetto.
control_dataOttiene i dati di controllo.
active_x_controlOttiene il controllo ActiveX.
pathsOttiene i percorsi di una forma geometrica personalizzata.
geometryOttiene la geometria
create_idOttiene e imposta l’ID di creazione per questa forma.

Metodi

MetodoDescrizione
to_imageCrea l’immagine della forma e la salva in un flusso nel formato specificato.
to_imageSalva la forma in un file.
to_imageSalva la forma in un flusso.
format_charactersFormatta alcuni caratteri con l’impostazione del carattere.
format_charactersFormatta alcuni caratteri con l’impostazione del carattere.
get_result_of_smart_artConversione di arte intelligente in forme raggruppate.
to_front_or_backPorta la forma in primo piano o la manda in secondo piano.
get_locked_propertyOttiene il valore della proprietà bloccata.
set_locked_propertyImposta la proprietà bloccata.
add_hyperlinkAggiunge un collegamento ipertestuale alla forma.
remove_hyperlinkRimuovere il collegamento ipertestuale della forma.
move_to_rangeSposta la forma in un intervallo specificato.
align_top_right_cornerSposta l’immagine nell’angolo in alto a destra.
get_connection_pointsOttieni i punti di connessione
get_linked_cellOttiene l’intervallo collegato al valore del controllo.
set_linked_cellImposta l’intervallo collegato al valore del controllo.
get_input_rangeOttiene l’intervallo utilizzato per riempire il controllo.
set_input_rangeImposta l’intervallo utilizzato per riempire il controllo.
update_selected_valueAggiorna il valore selezionato in base al valore della cella collegata.
calculate_text_sizeRicalcolare l’area di testo
charactersRestituisce un oggetto Characters che rappresenta un intervallo di caratteri all’interno del testo.
get_charactersRestituisce tutti gli oggetti Characters
che rappresenta un intervallo di caratteri all’interno del testo.
get_rich_formattingsRestituisce tutti gli oggetti Characters
che rappresenta un intervallo di caratteri all’interno del testo.
remove_active_x_controlRimuovi il controllo ActiveX.
is_same_settingRestituisce se la forma è la stessa.
get_actual_boxOttieni la posizione e la dimensione effettive della forma (dopo aver applicato rotazione, capovolgimento, ecc.)

Esempio

from aspose.cells import Workbook

# Initialize a new workbook.
book = Workbook()
# Add a shape.(e.g rectangle)
shape = book.worksheets[0].shapes.add_rectangle(2, 0, 2, 0, 130, 130)
# do your business
# Save the excel file.
book.save("exmaple.xlsx")

Guarda anche