OleObject classe

OleObject classe

Rappresenta OleObject in un foglio di lavoro.

Eredità: OleObjectShape

Il tipo OleObject 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 è una smart art.
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 descrittiva (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.
format_pictureOttiene e imposta le opzioni del formato immagine.
is_hiddenIndica se l’oggetto è visibile.
is_lock_aspect_ratioVero significa che le proporzioni della forma sono bloccate.
is_aspect_ratio_lockedVero significa che le proporzioni della forma sono bloccate.
rotation_angleOttiene e imposta la rotazione della forma.
hyperlinkOttiene il collegamento ipertestuale della forma.
idOttiene l’identificatore di questa forma.
spidSpecifica un identificatore di stringa facoltativo che un’applicazione può utilizzare per identificare una forma specifica.
sptSpecifica un numero facoltativo che un’applicazione può utilizzare per associare una particolare forma a un tipo di forma definito.
worksheetOttiene l’oggetto Shape.worksheet che contiene questa forma.
is_groupIndica se questa forma è una forma di gruppo.
is_in_groupIndica se la forma è raggruppata.
is_word_artIndica se questa forma è una parola artistica.
text_effectRestituisce 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_lockedVero 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_printableIndica se l’oggetto è stampabile.
Se False, questa forma non verrà stampata durante la stampa.
mso_drawing_typeOttiene il tipo di disegno.
auto_shape_typeOttiene e imposta il tipo di forma automatica.
anchor_typeOttiene e imposta il tipo di segnaposto di ancoraggio della forma.
placementRappresenta 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_rowRappresenta l’indice della riga superiore.
upper_delta_yOttiene o imposta lo scostamento verticale della forma dalla riga dell’angolo superiore sinistro.
upper_left_columnRappresenta l’indice della colonna nell’angolo in alto a sinistra.
upper_delta_xOttiene o imposta lo scostamento 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 lo scostamento 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 lo scostamento orizzontale della forma dalla colonna dell’angolo inferiore destro.
rightRappresenta la larghezza dello scostamento orizzontale della forma dalla colonna dell’angolo inferiore destro, in pixel.
bottomRappresenta la larghezza dello scostamento verticale della forma dalla riga dell’angolo inferiore inferiore, in pixel.
widthRappresenta la larghezza della forma, in unità di pixel.
width_inchRappresenta la larghezza della forma, in unità di pollici.
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 pollici.
height_ptRappresenta l’altezza della forma, in unità di punti.
height_cmRappresenta l’altezza della forma, in unità di centimetri.
leftRappresenta lo scostamento orizzontale della forma dalla sua colonna di sinistra, in pixel.
left_inchRappresenta lo scostamento orizzontale della forma dalla sua colonna di sinistra, in pollici.
left_cmRappresenta lo scostamento orizzontale della forma dalla sua colonna di sinistra, in centimetri.
topRappresenta lo scostamento verticale della forma dalla sua riga superiore, in pixel.
top_inchRappresenta lo scostamento verticale della forma dalla sua riga superiore, in pollici.
top_cmRappresenta lo scostamento verticale della forma dalla sua riga superiore, in centimetri.
top_to_cornerOttiene e imposta lo scostamento verticale della forma dal bordo superiore del foglio di lavoro, in pixel.
left_to_cornerOttiene e imposta lo scostamento orizzontale della forma dal bordo sinistro del foglio di lavoro.
xOttiene e imposta lo scostamento orizzontale della forma dal bordo sinistro del foglio di lavoro, in pixel.
yOttiene e imposta lo scostamento verticale della forma dal bordo superiore del foglio di lavoro, in 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à WidthScale 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 lo scostamento verticale della forma dal bordo superiore della forma padre,
in unità di 1/4000 dell’altezza della forma madre.
left_in_shapeRappresenta lo spostamento orizzontale della forma dal bordo sinistro della forma padre,
in unità di 1/4000 della larghezza della forma madre.
width_in_shapeRappresenta la larghezza della forma, in unità di 1/4000 della forma madre.
height_in_shapeRappresenta lo scostamento verticale della forma dal bordo superiore della forma padre, in unità di 1/4000 dell’altezza della forma padre.
groupOttiene la forma del gruppo che contiene questa forma.
typeOttiene il tipo di forma automatica.
has_lineOttiene e imposta il bordo della linea visibile della forma.
is_filledIndica se il formato di riempimento è visibile.
is_flipped_horizontallyOttiene e imposta se la forma è capovolta orizzontalmente.
is_flipped_verticallyOttiene e imposta se la forma è capovolta verticalmente.
actual_lower_right_rowOttieni la riga effettivamente in basso.
relative_to_original_picture_sizeIndica se la forma è relativa alle dimensioni originali dell’immagine.
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.
textOttiene e imposta il testo di questa forma.
is_rich_textSe il testo è in formato RTF 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 racchiuso 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.
text_box_optionsOttiene le informazioni di testo nella forma
control_dataOttiene i dati di controllo.
active_x_controlOttiene il controllo ActiveX.
pathsOttiene i percorsi di una forma geometrica personalizzata.
create_idOttiene e imposta l’ID di creazione per questa forma.
is_decorativeIndica se l’oggetto è decorativo.
is_auto_sizeVero 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_linkRestituisce true se OleObject è collegato al file.
display_as_iconVero se l’oggetto specificato viene visualizzato come icona
e l’immagine non verrà modificata automaticamente.
image_dataRappresenta l’immagine dell’oggetto ole come array di byte.
object_dataRappresenta i dati dell’oggetto ole incorporato come array di byte.
full_object_binOttiene i dati binari completi dell’oggetto ole incorporato nel file modello.
image_source_full_nameOttiene o imposta il percorso e il nome del file sorgente per l’immagine collegata.
prog_idOttiene o imposta il ProgID dell’oggetto OLE.
file_format_typeOttiene e imposta il tipo di file dei dati dell’oggetto ole incorporato
object_source_full_nameRestituisce il nome completo di origine del file sorgente per l’oggetto OLE collegato.
labelOttiene e imposta l’etichetta di visualizzazione dell’oggetto ole collegato.
source_full_nameRestituisce il nome completo di origine del file sorgente per l’oggetto OLE collegato.
auto_updateSpecifica se il collegamento all’OleObject viene aggiornato automaticamente o meno.
auto_loadSpecifica se l’applicazione host per l’oggetto incorporato deve essere chiamata per caricare
i dati dell’oggetto automaticamente quando si apre la cartella di lavoro padre.
class_identifierOttiene e imposta l’identificatore di classe dell’oggetto incorporato.
Indica quale applicazione apre il file incorporato.
image_typeOttiene il formato immagine dell’oggetto ole.

Metodi

MetodoDescrizione
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.
set_embedded_object(self, link_to_file, object_data, source_file_name, display_as_icon, label)Imposta i dati degli oggetti incorporati.
set_embedded_object(self, link_to_file, object_data, source_file_name, display_as_icon, label, update_icon)Imposta i dati degli oggetti incorporati.
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.
set_native_source_full_name(self, source_full_name)Imposta il nome completo del file sorgente nativo con il percorso.

Esempio

from aspose.cells import Workbook
import bytearray

# Instantiate a new Workbook.
workbook = Workbook()
# Get the first worksheet.
sheet = workbook.worksheets[0]
# Define a string variable to store the image path.
ImageUrl = "school.jpg"
# Get the picture into the streams.
fs = open(ImageUrl, "rb")
# Define a byte array.
imageData = bytearray(utils.filesize(fs))
# Obtain the picture into the array of bytes from streams.
fs.readinto(imageData)
# Close the stream.
fs.close()
# Get an excel file path in a variable.
path = "Book1.xls"
# Get the file into the streams.
fs = open(path, "rb")
# Define an array of bytes.
objectData = bytearray(utils.filesize(fs))
# Store the file from streams.
fs.readinto(objectData)
# Close the stream.
fs.close()
# Add an Ole object into the worksheet with the image
# shown in MS Excel.
sheet.ole_objects.add(14, 3, 200, 220, imageData)
# Set embedded ole object data.
sheet.ole_objects[0].object_data = objectData
# Save the excel file
workbook.save(r"oleobjects.xls")

Guarda anche