OleObject classe
OleObject classe
Rappresenta OleObject in un foglio di lavoro.
Il tipo OleObject 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_formatche contiene le proprietà di formattazione del riempimento per la forma specificata. | 
| shadow_effect | Rappresenta un oggetto ShadowEffectche specifica l’effetto ombra per l’elemento o la forma del grafico. | 
| reflection | Rappresenta un oggetto ReflectionEffectche specifica l’effetto di riflessione per l’elemento o la forma del grafico. | 
| glow | Rappresenta un oggetto GlowEffectche 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.worksheetche 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. | 
| 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 OleObject è collegato al file. | 
| display_as_icon | Vero se l’oggetto specificato viene visualizzato come icona e l’immagine non verrà modificata automaticamente. | 
| image_data | Rappresenta l’immagine dell’oggetto ole come array di byte. | 
| object_data | Rappresenta i dati dell’oggetto ole incorporato come array di byte. | 
| full_object_bin | Ottiene i dati binari completi dell’oggetto ole incorporato nel file modello. | 
| image_source_full_name | Ottiene o imposta il percorso e il nome del file sorgente per l’immagine collegata. | 
| prog_id | Ottiene o imposta il ProgID dell’oggetto OLE. | 
| file_format_type | Ottiene e imposta il tipo di file dei dati dell’oggetto ole incorporato | 
| object_source_full_name | Restituisce il nome completo di origine del file sorgente per l’oggetto OLE collegato. | 
| label | Ottiene e imposta l’etichetta di visualizzazione dell’oggetto ole collegato. | 
| source_full_name | Restituisce il nome completo di origine del file sorgente per l’oggetto OLE collegato. | 
| auto_update | Specifica se il collegamento all’OleObject viene aggiornato automaticamente o meno. | 
| auto_load | Specifica 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_identifier | Ottiene e imposta l’identificatore di classe dell’oggetto incorporato. Indica quale applicazione apre il file incorporato. | 
| image_type | Ottiene il formato immagine dell’oggetto ole. | 
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. | 
| 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
- modulo aspose.cells.drawing
- classe GlowEffect
- classe OleObject
- classe ReflectionEffect
- classe ShadowEffect
- classe Shape