Picture classe

Incapsula l’oggetto che rappresenta una singola immagine in un foglio di calcolo.

Eredità: Picture → Shape

Il tipo Picture espone i seguenti membri:

Proprietà

Proprietà	Descrizione
macro_name	Ottiene e imposta il nome della macro.
is_equation	Indica se la forma contiene solo un’equazione.
is_smart_art	Indica se la forma è una smart art.
z_order_position	Restituisce la posizione di una forma nell’ordine z.
name	Ottiene e imposta il nome della forma.
alternative_text	Restituisce o imposta la stringa di testo descrittiva (alternativa) dell’oggetto `Shape`.
title	Specifica il titolo (didascalia) dell’oggetto forma corrente.
line_format	Restituisce un oggetto MsoLineFormat che contiene le proprietà di formattazione della linea per la forma specificata.
fill_format	Restituisce un oggetto MsoFillFormat che contiene le proprietà di formattazione del riempimento per la forma specificata.
line	Ottiene lo stile della linea
fill	Restituisce un oggetto `Shape.fill_format` che contiene le proprietà di formattazione del riempimento per la forma specificata.
shadow_effect	Rappresenta un oggetto `ShadowEffect` che specifica l’effetto ombra per l’elemento o la forma del grafico.
reflection	Rappresenta un oggetto `ReflectionEffect` che specifica l’effetto di riflessione per l’elemento o la forma del grafico.
glow	Rappresenta un oggetto `GlowEffect` che specifica l’effetto bagliore per l’elemento o la forma del grafico.
soft_edges	Ottiene e imposta il raggio di sfocatura da applicare ai bordi, in unità di punti.
three_d_format	Ottiene e imposta il formato 3D della forma.
format_picture	Ottiene e imposta le opzioni del formato immagine.
is_hidden	Indica se l’oggetto è visibile.
is_lock_aspect_ratio	Vero significa che le proporzioni della forma sono bloccate.
is_aspect_ratio_locked	Vero significa che le proporzioni della forma sono bloccate.
rotation_angle	Ottiene e imposta la rotazione della forma.
hyperlink	Ottiene il collegamento ipertestuale della forma.
id	Ottiene l’identificatore di questa forma.
spid	Specifica un identificatore di stringa facoltativo che un’applicazione può utilizzare per identificare una forma specifica.
spt	Specifica un numero facoltativo che un’applicazione può utilizzare per associare una particolare forma a un tipo di forma definito.
worksheet	Ottiene l’oggetto `Shape.worksheet` che contiene questa forma.
is_group	Indica se questa forma è una forma di gruppo.
is_in_group	Indica se la forma è raggruppata.
is_word_art	Indica se questa forma è una parola artistica.
text_effect	Restituisce un oggetto TextEffectFormat che contiene le proprietà di formattazione degli effetti di testo per la forma specificata. Si applica agli oggetti Forma che rappresentano WordArt.
is_locked	Vero significa che l’oggetto non può essere modificato quando il foglio è protetto. Si noti che questo valore è significativo solo se il foglio di lavoro o gli oggetti nel foglio di lavoro sono protetti.
is_printable	Indica se l’oggetto è stampabile. Se False, questa forma non verrà stampata durante la stampa.
mso_drawing_type	Ottiene il tipo di disegno.
auto_shape_type	Ottiene e imposta il tipo di forma automatica.
anchor_type	Ottiene e imposta il tipo di segnaposto di ancoraggio della forma.
placement	Rappresenta il modo in cui l’oggetto del disegno è collegato alle celle sottostanti. La proprietà controlla il posizionamento di un oggetto su un foglio di lavoro.
upper_left_row	Rappresenta l’indice della riga superiore.
upper_delta_y	Ottiene o imposta lo scostamento verticale della forma dalla riga dell’angolo superiore sinistro.
upper_left_column	Rappresenta l’indice della colonna nell’angolo in alto a sinistra.
upper_delta_x	Ottiene o imposta lo scostamento orizzontale della forma dalla colonna dell’angolo superiore sinistro.
lower_right_row	Rappresenta l’indice della riga nell’angolo inferiore destro.
lower_delta_y	Ottiene o imposta lo scostamento verticale della forma dalla riga dell’angolo inferiore destro.
lower_right_column	Rappresenta l’indice della colonna nell’angolo inferiore destro.
lower_delta_x	Ottiene o imposta lo scostamento orizzontale della forma dalla colonna dell’angolo inferiore destro.
right	Rappresenta la larghezza dello scostamento orizzontale della forma dalla colonna dell’angolo inferiore destro, in pixel.
bottom	Rappresenta la larghezza dello scostamento verticale della forma dalla riga dell’angolo inferiore inferiore, in pixel.
width	Rappresenta la larghezza della forma, in unità di pixel.
width_inch	Rappresenta la larghezza della forma, in unità di pollici.
width_pt	Rappresenta la larghezza della forma, in unità di punto.
width_cm	Rappresenta la larghezza della forma, in unità di centimetri.
height	Rappresenta l’altezza della forma, in unità di pixel.
height_inch	Rappresenta l’altezza della forma, in pollici.
height_pt	Rappresenta l’altezza della forma, in unità di punti.
height_cm	Rappresenta l’altezza della forma, in unità di centimetri.
left	Rappresenta lo scostamento orizzontale della forma dalla sua colonna di sinistra, in pixel.
left_inch	Rappresenta lo scostamento orizzontale della forma dalla sua colonna di sinistra, in pollici.
left_cm	Rappresenta lo scostamento orizzontale della forma dalla sua colonna di sinistra, in centimetri.
top	Rappresenta lo scostamento verticale della forma dalla sua riga superiore, in pixel.
top_inch	Rappresenta lo scostamento verticale della forma dalla sua riga superiore, in pollici.
top_cm	Rappresenta lo scostamento verticale della forma dalla sua riga superiore, in centimetri.
top_to_corner	Ottiene e imposta lo scostamento verticale della forma dal bordo superiore del foglio di lavoro, in pixel.
left_to_corner	Ottiene e imposta lo scostamento orizzontale della forma dal bordo sinistro del foglio di lavoro.
x	Ottiene e imposta lo scostamento orizzontale della forma dal bordo sinistro del foglio di lavoro, in pixel.
y	Ottiene e imposta lo scostamento verticale della forma dal bordo superiore del foglio di lavoro, in pixel.
width_scale	Ottiene e imposta la scala della larghezza, in unità percentuali della larghezza dell’immagine originale. Se la forma non è un’immagine, la proprietà WidthScale restituisce solo 100;
height_scale	Ottiene 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_shape	Rappresenta lo scostamento verticale della forma dal bordo superiore della forma padre, in unità di 1/4000 dell’altezza della forma madre.
left_in_shape	Rappresenta lo spostamento orizzontale della forma dal bordo sinistro della forma padre, in unità di 1/4000 della larghezza della forma madre.
width_in_shape	Rappresenta la larghezza della forma, in unità di 1/4000 della forma madre.
height_in_shape	Rappresenta lo scostamento verticale della forma dal bordo superiore della forma padre, in unità di 1/4000 dell’altezza della forma padre.
group	Ottiene la forma del gruppo che contiene questa forma.
type	Ottiene il tipo di forma automatica.
has_line	Ottiene e imposta il bordo della linea visibile della forma.
is_filled	Indica se il formato di riempimento è visibile.
is_flipped_horizontally	Ottiene e imposta se la forma è capovolta orizzontalmente.
is_flipped_vertically	Ottiene e imposta se la forma è capovolta verticalmente.
actual_lower_right_row	Ottieni la riga effettivamente in basso.
relative_to_original_picture_size	Indica se la forma è relativa alle dimensioni originali dell’immagine.
linked_cell	Ottiene o imposta l’intervallo del foglio di lavoro collegato al valore del controllo.
input_range	Ottiene o imposta l’intervallo del foglio di lavoro utilizzato per riempire la casella combinata specificata.
text_shape_type	Ottiene e imposta il tipo di forma del testo preimpostato.
text_body	Ottiene e imposta l’impostazione del testo della forma.
font	Rappresenta il carattere della forma.
text_options	Rappresenta le opzioni di testo della forma.
text	Ottiene e imposta il testo di questa forma.
is_rich_text	Se il testo è in formato RTF o meno.
html_text	Ottiene e imposta la stringa HTML che contiene dati e alcuni formati in questa casella di testo.
text_vertical_overflow	Ottiene e imposta il tipo di overflow verticale del testo della forma che contiene testo.
text_horizontal_overflow	Ottiene e imposta il tipo di overflow orizzontale del testo della forma che contiene testo.
is_text_wrapped	Ottiene e imposta il tipo di testo racchiuso nella forma che contiene testo.
text_orientation_type	Ottiene e imposta il tipo di orientamento del testo della forma.
text_horizontal_alignment	Ottiene e imposta il tipo di allineamento orizzontale del testo della forma.
text_vertical_alignment	Ottiene e imposta il tipo di allineamento verticale del testo della forma.
text_direction	Ottiene/imposta la direzione del flusso del testo per questo oggetto.
text_box_options	Ottiene le informazioni di testo nella forma
control_data	Ottiene i dati di controllo.
active_x_control	Ottiene il controllo ActiveX.
paths	Ottiene i percorsi di una forma geometrica personalizzata.
create_id	Ottiene e imposta l’ID di creazione per questa forma.
is_decorative	Indica se l’oggetto è decorativo.
original_height	Ottiene l’altezza originale dell’immagine.
original_width	Ottiene la larghezza originale dell’immagine.
border_line_color	Rappresenta il colore del bordo di un’immagine.
border_weight	Ottiene o imposta lo spessore della linea del bordo di un’immagine in unità di pt.
data	Ottiene i dati dell’immagine.
source_full_name	Ottiene o imposta il percorso e il nome del file sorgente per l’immagine collegata.
formula	Ottiene e imposta i dati della formula.
is_auto_size	Vero indica che la dimensione dell’oggetto ole verrà modificata automaticamente in base alla dimensione dell’istantanea del contenuto incorporato quando l’oggetto ole viene attivato.
is_link	Restituisce true se l’immagine è collegata a un file.
is_dynamic_data_exchange	Ottiene o imposta se lo scambio di dati dinamici
display_as_icon	Vero se l’oggetto specificato viene visualizzato come icona e l’immagine non verrà modificata automaticamente.
image_type	Ottiene il formato dell’immagine.
original_height_cm	Ottiene l’altezza originale dell’immagine, in centimetri.
original_width_cm	Ottiene la larghezza originale dell’immagine, in centimetri.
original_height_inch	Ottiene l’altezza originale dell’immagine, in pollici.
original_width_inch	Ottiene la larghezza originale dell’immagine, in pollici.
signature_line	Ottiene e imposta la riga della firma

Metodi

Metodo	Descrizione
`to_image(self, stream, image_type)`	Crea l’immagine della forma e la salva in un flusso nel formato specificato.
`to_image(self, image_file, options)`	Salva la forma in un file.
`to_image(self, stream, options)`	Salva la forma in un flusso.
`get_result_of_smart_art(self)`	Conversione di elementi smart art in forme raggruppate.
`to_front_or_back(self, orders)`	Porta la forma in primo piano o la manda sullo sfondo.
`get_locked_property(self, type)`	Ottiene il valore della proprietà bloccata.
`set_locked_property(self, type, value)`	Imposta la proprietà bloccata.
`add_hyperlink(self, address)`	Aggiunge un collegamento ipertestuale alla forma.
`remove_hyperlink(self)`	Rimuove il collegamento ipertestuale della forma.
`move_to_range(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column)`	Sposta la forma in un intervallo specificato.
`align_top_right_corner(self, top_row, right_column)`	Sposta l’immagine nell’angolo in alto a destra.
`get_connection_points(self)`	Ottieni i punti di connessione
`get_linked_cell(self, is_r1c1, is_local)`	Ottiene l’intervallo collegato al valore del controllo.
`set_linked_cell(self, formula, is_r1c1, is_local)`	Imposta l’intervallo collegato al valore del controllo.
`get_input_range(self, is_r1c1, is_local)`	Ottiene l’intervallo utilizzato per riempire il controllo.
`set_input_range(self, formula, is_r1c1, is_local)`	Imposta l’intervallo utilizzato per riempire il controllo.
`update_selected_value(self)`	Aggiorna il valore selezionato con il valore della cella collegata.
`calculate_text_size(self)`	Ricalcola l’area del testo
`format_characters(self, start_index, length, font, flag)`	Formatta alcuni caratteri con l’impostazione del font.
`characters(self, start_index, length)`	Restituisce un oggetto Characters che rappresenta un intervallo di caratteri all’interno del testo.
`get_characters(self)`	Restituisce tutti gli oggetti Characters che rappresenta un intervallo di caratteri all’interno del testo.
`get_rich_formattings(self)`	Restituisce tutti gli oggetti Characters che rappresenta un intervallo di caratteri all’interno del testo.
`remove_active_x_control(self)`	Rimuovere il controllo ActiveX.
`is_same_setting(self, obj)`	Restituisce un valore che indica se la forma è la stessa.
`get_actual_box(self)`	Ottieni la posizione e le dimensioni effettive della forma (dopo aver applicato rotazione, capovolgimento, ecc.)
`fit_to_text_size(self)`	Ricalcola un’area di testo adatta alla visualizzazione di tutto il contenuto di testo.
`copy(self, source, options)`	Copia l’immagine.
`move(self, upper_left_row, upper_left_column)`	Sposta l’immagine nella posizione specificata.
`place_in_cell(self)`	Metti questa immagine nella cella

Esempio

from aspose.cells import SaveFormat, Workbook

# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Workbook object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding a picture at the location of a cell whose row and column indices
# are 5 in the worksheet. It is "F6" cell
worksheet.pictures.add(5, 5, "image.gif")
# Saving the Excel file
workbook.save("book1.xls", SaveFormat.EXCEL_97_TO_2003)

Guarda anche

PicFormatOption classe PictureCollection classe