TextBox classe

Incapsula l’oggetto che rappresenta una casella di testo in un foglio di calcolo.

Eredità: TextBox → Shape

Il tipo TextBox 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 è arte intelligente.
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 descrittivo (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.
text_frame	Restituisce un oggetto TextFrame che contiene le proprietà di allineamento e ancoraggio per la forma specificata.
format_picture	Ottiene e imposta le opzioni del formato immagine.
is_hidden	Indica se l’oggetto è visibile.
is_lock_aspect_ratio	Vero significa che non consente modifiche alle proporzioni.
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 una stringa facoltativa che un’applicazione può utilizzare per identificare la forma particolare.
spt	Specifica un numero facoltativo che un’applicazione può utilizzare per associare la forma particolare a un tipo di forma definito.
worksheet	Ottiene l’oggetto `Shape.worksheet` che contiene questa forma.
is_group	Indica se la forma è un gruppo.
is_in_group	Indica se la forma è raggruppata.
is_word_art	Indica se questa forma è una parola d’arte.
text_effect	Restituisce un oggetto TextEffectFormat che contiene proprietà di formattazione dell’effetto testo per la forma specificata. Si applica agli oggetti Shape che rappresentano WordArt.
is_locked	Vero se l’oggetto è bloccato, Falso se l’oggetto può essere modificato quando il foglio è protetto.
is_printable	Vero se l’oggetto è stampabile
mso_drawing_type	Ottiene il tipo di disegno MSO.
auto_shape_type	Ottiene e imposta il tipo di forma automatica.
anchor_type	Ottiene e imposta il segnaposto di ancoraggio della forma.
placement	Rappresenta 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_row	Rappresenta l’indice della riga nell’angolo superiore sinistro.
upper_delta_y	Ottiene o imposta l’offset verticale della forma dalla riga dell’angolo superiore sinistro.
upper_left_column	Rappresenta l’indice della colonna nell’angolo superiore sinistro.
upper_delta_x	Ottiene o imposta l’offset 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 l’offset 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 l’offset orizzontale della forma dalla colonna dell’angolo inferiore destro.
right	Rappresenta la larghezza dell’offset orizzontale della forma dalla colonna dell’angolo inferiore destro, in unità di pixel.
bottom	Rappresenta la larghezza dell’offset verticale della forma dalla riga dell’angolo inferiore inferiore, in unità di pixel.
width	Rappresenta la larghezza della forma, in unità di pixel.
width_inch	Rappresenta la larghezza della forma, in unità di pollice.
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 unità di 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 l’offset orizzontale della forma dalla colonna di sinistra, in unità di pixel.
left_inch	Rappresenta l’offset orizzontale della forma dalla colonna di sinistra, in unità di pollici.
left_cm	Rappresenta l’offset orizzontale della forma dalla colonna di sinistra, in unità di centimetri.
top	Rappresenta l’offset verticale della forma dalla riga superiore, in unità di pixel.
top_inch	Rappresenta l’offset verticale della forma dalla riga superiore, in unità di pollici.
top_cm	Rappresenta l’offset verticale della forma dalla riga superiore, in unità di centimetri.
top_to_corner	Ottiene e imposta l’offset verticale della forma dal bordo superiore del foglio di lavoro, in unità di pixel.
left_to_corner	Ottiene e imposta l’offset orizzontale della forma dal bordo sinistro del foglio di lavoro.
x	Ottiene e imposta l’offset orizzontale della forma dal bordo sinistro del foglio di lavoro, in unità di pixel.
y	Ottiene e imposta l’offset verticale della forma dal bordo superiore del foglio di lavoro, in unità di 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à LarghezzaScale 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 l’offset verticale della forma dal bordo superiore della forma genitore, in unità di 1/4000 dell’altezza della forma madre.
left_in_shape	Rappresenta l’offset orizzontale della forma dal bordo sinistro della forma genitore, in unità di 1/4000 della larghezza della forma principale.
width_in_shape	Rappresenta la larghezza della forma, in unità di 1/4000 della forma padre.
height_in_shape	Rappresenta l’offset verticale della forma dal bordo superiore della forma genitore, in unità di 1/4000 dell’altezza della forma genitore.
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 della forma visibile.
is_filled	Indica se il formato di riempimento è visibile.
is_flipped_horizontally	Ottiene e imposta se la forma viene capovolta orizzontalmente.
is_flipped_vertically	Ottiene e imposta se la forma viene capovolta verticalmente.
actual_lower_right_row	Ottieni la riga inferiore effettiva.
connection_points	Ottieni i punti di connessione
relative_to_original_picture_size	Indica se la forma è relativa alla dimensione dell’immagine originale.
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	Rappresenta la stringa in questo oggetto TextBox.
is_rich_text	Se il testo è rich text 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 avvolto 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.
control_data	Ottiene i dati di controllo.
active_x_control	Ottiene il controllo ActiveX.
paths	Ottiene i percorsi di una forma geometrica personalizzata.
geometry	Ottiene la geometria
create_id	Ottiene e imposta l’ID di creazione per questa forma.

Metodi

Metodo	Descrizione
to_image	Crea l’immagine della forma e la salva in un flusso nel formato specificato.
to_image	Salva la forma in un file.
to_image	Salva la forma in un flusso.
format_characters	Formatta alcuni caratteri con l’impostazione del carattere.
format_characters	Formatta alcuni caratteri con l’impostazione del carattere.
get_equation_paragraph	Ottieni il paragrafo matematico specificato dalla proprietà TextBody dell’oggetto TextBox. Avviso: (1) Restituisce NULL quando l’indice è fuori limite o non è stato trovato. (2) Restituisce NULL anche se la posizione dell’indice specificata non è un paragrafo matematico.
get_equation_paragraph	Ottiene il primo paragrafo matematico dalla proprietà TextBody dell’oggetto TextBox.
get_result_of_smart_art	Conversione di arte intelligente in forme raggruppate.
to_front_or_back	Porta la forma in primo piano o la manda in secondo piano.
get_locked_property	Ottiene il valore della proprietà bloccata.
set_locked_property	Imposta la proprietà bloccata.
add_hyperlink	Aggiunge un collegamento ipertestuale alla forma.
remove_hyperlink	Rimuovere il collegamento ipertestuale della forma.
move_to_range	Sposta la forma in un intervallo specificato.
align_top_right_corner	Sposta l’immagine nell’angolo in alto a destra.
get_connection_points	Ottieni i punti di connessione
get_linked_cell	Ottiene l’intervallo collegato al valore del controllo.
set_linked_cell	Imposta l’intervallo collegato al valore del controllo.
get_input_range	Ottiene l’intervallo utilizzato per riempire il controllo.
set_input_range	Imposta l’intervallo utilizzato per riempire il controllo.
update_selected_value	Aggiorna il valore selezionato in base al valore della cella collegata.
calculate_text_size	Ricalcolare l’area di testo
characters	Restituisce un oggetto Characters che rappresenta un intervallo di caratteri all’interno del testo.
get_characters	Restituisce tutti gli oggetti Characters che rappresenta un intervallo di caratteri all’interno del testo.
get_rich_formattings	Restituisce tutti gli oggetti Characters che rappresenta un intervallo di caratteri all’interno del testo.
remove_active_x_control	Rimuovi il controllo ActiveX.
is_same_setting	Restituisce se la forma è la stessa.
get_actual_box	Ottieni la posizione e la dimensione effettive della forma (dopo aver applicato rotazione, capovolgimento, ecc.)

Esempio

from aspose.cells import Workbook
from aspose.cells.drawing import MsoLineDashStyle, MsoLineStyle, PlacementType
from aspose.pydrawing import Color

# Instantiate a new Workbook.
workbook = Workbook()
# Get the first worksheet in the book.
worksheet = workbook.worksheets[0]
# Add a new textbox to the collection.
textboxIndex = worksheet.text_boxes.add(2, 1, 160, 200)
# Get the textbox object.
textbox0 = worksheet.text_boxes[textboxIndex]
# Fill the text.
textbox0.text = "ASPOSE______The .NET and JAVA Component Publisher!"
# Set the textbox to adjust it according to its contents.
textbox0.text_body.text_alignment.auto_size = True
# Set the placement.
textbox0.placement = PlacementType.FREE_FLOATING
# Set the font color.
textbox0.font.color = Color.blue
# Set the font to bold.
textbox0.font.is_bold = True
# Set the font size.
textbox0.font.size = 14
# Set font attribute to italic.
textbox0.font.is_italic = True
# Add a hyperlink to the textbox.
textbox0.add_hyperlink("http://www.aspose.com/")
# Get the filformat of the textbox.
fillformat = textbox0.fill
# Set the fillcolor.
fillformat.solid_fill.color = Color.silver
# Get the lineformat type of the textbox.
lineformat = textbox0.line
# Set the line style.
lineformat.compound_type = MsoLineStyle.THIN_THICK
# Set the line weight.
lineformat.weight = 6.0
# Set the dash style to squaredot.
lineformat.dash_style = MsoLineDashStyle.SQUARE_DOT
# Add another textbox.
textboxIndex = worksheet.text_boxes.add(15, 4, 85, 120)
# Get the second textbox.
textbox1 = worksheet.text_boxes[textboxIndex]
# Input some text to it.
textbox1.text = "This is another simple text box"
# Set the placement type as the textbox will move and
# resize with cells.
textbox1.placement = PlacementType.MOVE_AND_SIZE
# Save the excel file.
workbook.save("tsttextboxes.xlsx")

Guarda anche

Spinner classe classe TextBoxCollection