ListBox classe

Rappresenta un oggetto casella di riepilogo.

Eredità: ListBox → Shape

Il tipo ListBox 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.
item_count	Ottiene il numero di elementi nella casella di riepilogo.
selected_index	Ottiene o imposta il numero di indice dell’elemento attualmente selezionato in una casella di riepilogo o in una casella combinata. Basato sullo zero.
selected_cells	Ottiene le celle selezionate. Restituisce null se l’intervallo di input non è impostato o non è selezionato alcun elemento
shadow	Indica se la casella combinata ha ombreggiatura 3D.
selection_type	Ottiene o imposta la modalità di selezione della casella di riepilogo specificata.
page_change	Specifica l’importo di cui viene modificato il valore del controllo quando l’utente clicca sulla barra di scorrimento verso l’alto o verso il basso.

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.
`selected_item(self, item_index, is_selected)`	Imposta se l’elemento è selezionato
`is_selected(self, item_index)`	Indica se l’elemento è selezionato.

Esempio

from aspose.cells import Workbook
from aspose.cells.drawing import PlacementType, SelectionType

# Create a new Workbook.
workbook = Workbook()
# Get the first worksheet.
sheet = workbook.worksheets[0]
# Get the worksheet cells collection.
cells = sheet.cells
# Input a value.
cells.get("B3").put_value("Choose Dept:")
# Set it bold.
style = cells.get("B3").get_style()
style.font.is_bold = True
cells.get("B3").set_style(style)
# Input some values that denote the input range
# for the list box.
cells.get("A2").put_value("Sales")
cells.get("A3").put_value("Finance")
cells.get("A4").put_value("MIS")
cells.get("A5").put_value("R&D")
cells.get("A6").put_value("Marketing")
cells.get("A7").put_value("HRA")
# Add a new list box.
listBox = sheet.shapes.add_list_box(2, 0, 3, 0, 122, 100)
# Set the placement type.
listBox.placement = PlacementType.FREE_FLOATING
# Set the linked cell.
listBox.linked_cell = "A1"
# Set the input range.
listBox.input_range = "A2:A7"
# Set the selection style.
listBox.selection_type = SelectionType.SINGLE
# Set the list box with 3-D shading.
listBox.shadow = True
# Saves the file.
workbook.save(r"tstlistbox.xls")

Guarda anche

LineShape classe MsoFillFormat classe