TextBox sınıfı

Bir elektronik tabloda bir metin kutusunu temsil eden nesneyi kapsüller.

Miras: TextBox → Shape

TextBox türü aşağıdaki üyeleri ortaya çıkarır:

Özellikler

Mülk	Tanım
macro_name	Makronun adını alır ve ayarlar.
is_equation	Şeklin yalnızca bir denklem içerip içermediğini belirtir.
is_smart_art	Şeklin akıllı sanat olup olmadığını gösterir.
z_order_position	Bir şeklin z-sırasındaki konumunu döndürür.
name	Şeklin adını alır ve ayarlar.
alternative_text	`Shape` nesnesinin açıklayıcı (alternatif) metin dizesini döndürür veya ayarlar.
title	Geçerli şekil nesnesinin başlığını (başlığını) belirtir.
line_format	Belirtilen şekil için çizgi biçimlendirme özelliklerini içeren bir MsoLineFormat nesnesi döndürür.
fill_format	Belirtilen şekil için dolgu biçimlendirme özelliklerini içeren bir MsoFillFormat nesnesi döndürür.
line	Çizgi stilini alır
fill	Belirtilen şekil için dolgu biçimlendirme özelliklerini içeren `Shape.fill_format` nesnesini döndürür.
shadow_effect	Grafik öğesi veya şekli için gölge efektini belirten `ShadowEffect` nesnesini temsil eder.
reflection	Grafik öğesi veya şekli için yansıma efektini belirten `ReflectionEffect` nesnesini temsil eder.
glow	Grafik öğesi veya şekli için parıltı efektini belirten `GlowEffect` nesnesini temsil eder.
soft_edges	Kenarlara uygulanacak bulanıklık yarıçapını nokta biriminde alır ve ayarlar.
three_d_format	Şeklin 3 boyutlu formatını alır ve ayarlar.
format_picture	Resim formatının seçeneklerini alır ve ayarlar.
is_hidden	Nesnenin görünür olup olmadığını belirtir.
is_lock_aspect_ratio	Doğru, şeklin en boy oranının kilitlendiği anlamına gelir.
is_aspect_ratio_locked	Doğru, şeklin en boy oranının kilitlendiği anlamına gelir.
rotation_angle	Şeklin dönüşünü alır ve ayarlar.
hyperlink	Şeklin hiperlinkini alır.
id	Bu şeklin tanımlayıcısını alır.
spid	Bir uygulamanın belirli bir şekli tanımlamak için kullanabileceği isteğe bağlı bir dize tanımlayıcısını belirtir.
spt	Bir uygulamanın belirli bir şekli tanımlanmış bir şekil türüyle ilişkilendirmek için kullanabileceği isteğe bağlı bir sayıyı belirtir.
worksheet	Bu şekli içeren `Shape.worksheet` nesnesini alır.
is_group	Bu şeklin bir grup şekli olup olmadığını gösterir.
is_in_group	Şeklin gruplanmış olup olmadığını gösterir.
is_word_art	Bu şeklin bir kelime sanatı olup olmadığını gösterir.
text_effect	Belirtilen şekil için metin efekti biçimlendirme özelliklerini içeren bir TextEffectFormat nesnesi döndürür. WordArt’ı temsil eden Şekil nesneleri için geçerlidir.
is_locked	True, sayfa korunduğunda nesnenin değiştirilemeyeceği anlamına gelir. Bu değerin yalnızca çalışma sayfası veya çalışma sayfasındaki nesneler korunuyorsa anlamlı olduğunu unutmayın.
is_printable	Nesnenin yazdırılabilir olup olmadığını belirtir. Eğer False ise, yazdırma sırasında bu şekil yazdırılmayacaktır.
mso_drawing_type	Çizim türünü alır.
auto_shape_type	Otomatik şekil türünü alır ve ayarlar.
anchor_type	Şekil bağlantı yer tutucusunun türünü alır ve ayarlar.
placement	Çizim nesnesinin altındaki hücrelere bağlanma şeklini gösterir. Özellik, bir nesnenin çalışma sayfasındaki yerleşimini kontrol eder.
upper_left_row	En üst satırdaki indeksi temsil eder.
upper_delta_y	Şeklin sol üst köşe satırından dikey uzaklığını alır veya ayarlar.
upper_left_column	Sol üst köşedeki sütun indeksini temsil eder.
upper_delta_x	Şeklin sol üst köşesindeki sütundan yatay uzaklığını alır veya ayarlar.
lower_right_row	Sağ alt köşedeki satır indeksini temsil eder.
lower_delta_y	Şeklin sağ alt köşesindeki satırdan dikey uzaklığını alır veya ayarlar.
lower_right_column	Sağ alt köşedeki sütun indeksini temsil eder.
lower_delta_x	Şeklin sağ alt köşesindeki sütundan yatay uzaklığını alır veya ayarlar.
right	Şeklin sağ alt köşesindeki sütundan yatay uzaklığının piksel cinsinden genişliğini temsil eder.
bottom	Şeklin alt alt köşe satırından itibaren dikey ofsetinin genişliğini piksel cinsinden temsil eder.
width	Şeklin genişliğini piksel cinsinden temsil eder.
width_inch	Şeklin genişliğini inç cinsinden gösterir.
width_pt	Şeklin genişliğini nokta birimiyle temsil eder.
width_cm	Şeklin genişliğini santimetre cinsinden gösterir.
height	Şeklin yüksekliğini piksel cinsinden temsil eder.
height_inch	Şeklin yüksekliğini inç cinsinden gösterir.
height_pt	Şeklin yüksekliğini nokta birimiyle gösterir.
height_cm	Şeklin yüksekliğini santimetre cinsinden gösterir.
left	Şeklin sol sütunundan yatay olarak uzaklığını piksel cinsinden gösterir.
left_inch	Şeklin sol sütundan yatay uzaklığını inç cinsinden gösterir.
left_cm	Şeklin sol sütundan yatay uzaklığını santimetre cinsinden gösterir.
top	Şeklin üst satırından dikey uzaklığını piksel cinsinden gösterir.
top_inch	Şeklin üst sırasından dikey uzaklığını inç cinsinden gösterir.
top_cm	Şeklin üst sırasından dikey uzaklığını santimetre cinsinden gösterir.
top_to_corner	Şeklin çalışma sayfasının üst sınırından dikey uzaklığını piksel cinsinden alır ve ayarlar.
left_to_corner	Şeklin çalışma sayfasının sol kenarından yatay uzaklığını alır ve ayarlar.
x	Çalışma sayfasının sol kenarından şeklin yatay ofsetini piksel cinsinden alır ve ayarlar.
y	Şeklin çalışma sayfasının üst sınırından dikey uzaklığını piksel cinsinden alır ve ayarlar.
width_scale	Orijinal resim genişliğinin yüzde biriminde genişlik ölçeğini alır ve ayarlar. Eğer şekil resim değilse, WidthScale özelliği sadece 100 değerini döndürür;
height_scale	Orijinal resim yüksekliğinin yüzde biriminde yükseklik ölçeğini alır ve ayarlar. Eğer şekil resim değilse, HeightScale özelliği sadece 100 değerini döndürür;
top_in_shape	Şeklin, ana şeklin üst sınırından dikey uzaklığını temsil eder. ana şeklin yüksekliğinin 1/4000’i biriminde.
left_in_shape	Şeklin ana şeklin sol sınırından yatay olarak uzaklığını temsil eder. ana şeklin genişliğinin 1/4000’i biriminde.
width_in_shape	Şeklin genişliğini, ana şeklin 1/4000’i biriminde temsil eder.
height_in_shape	Ana şeklin üst sınırından şeklin dikey uzaklığını, ana şeklin yüksekliğinin 1/4000’i biriminde temsil eder.
group	Bu şekli içeren grup şeklini alır.
type	Otomatik şekil türünü alır.
has_line	Şeklin çizgi sınırının görünür olmasını sağlar ve ayarlar.
is_filled	Doldurma biçiminin görünür olup olmadığını belirtir.
is_flipped_horizontally	Şeklin yatay olarak çevrilip çevrilmeyeceğini alır ve ayarlar.
is_flipped_vertically	Şeklin dikey olarak çevrilip çevrilmeyeceğini alır ve ayarlar.
actual_lower_right_row	Gerçek alt sırayı alın.
relative_to_original_picture_size	Şeklin orijinal resim boyutuna göreli olup olmadığını gösterir.
linked_cell	Denetimin değerine bağlı çalışma sayfası aralığını alır veya ayarlar.
input_range	Belirtilen birleşik kutuyu doldurmak için kullanılan çalışma sayfası aralığını alır veya ayarlar.
text_shape_type	Önceden ayarlanmış metin şekli türünü alır ve ayarlar.
text_body	Şeklin metninin ayarını alır ve ayarlar.
font	Şeklin yazı tipini temsil eder.
text_options	Şeklin metin seçeneklerini temsil eder.
text	Bu şeklin metnini alır ve ayarlar.
is_rich_text	Metnin zengin metin olup olmadığı.
html_text	Bu metin kutusunda veri ve bazı formatları içeren html dizesini alır ve ayarlar.
text_vertical_overflow	Metni içeren şeklin metin dikey taşma türünü alır ve ayarlar.
text_horizontal_overflow	Metni içeren şeklin metin yatay taşma türünü alır ve ayarlar.
is_text_wrapped	Metni içeren şeklin metin sarma türünü alır ve ayarlar.
text_orientation_type	Şeklin metin yönlendirme türünü alır ve ayarlar.
text_horizontal_alignment	Şeklin metin yatay hizalama türünü alır ve ayarlar.
text_vertical_alignment	Şeklin metin dikey hizalama türünü alır ve ayarlar.
text_direction	Bu nesne için metin akışının yönünü alır/ayarlar.
text_box_options	Şekildeki metin bilgilerini alır
control_data	Kontrol verilerini alır.
active_x_control	ActiveX denetimini alır.
paths	Özel bir geometrik şeklin yollarını alır.
create_id	Bu şeklin oluşturma kimliğini alır ve ayarlar.
is_decorative	Nesnenin dekoratif olup olmadığını belirtir.

Yöntemler

Yöntem	Tanım
`to_image(self, stream, image_type)`	Şekil görüntüsünü oluşturur ve belirtilen formatta bir akışa kaydeder.
`to_image(self, image_file, options)`	Şekli bir dosyaya kaydeder.
`to_image(self, stream, options)`	Şekli bir akışa kaydeder.
`get_equation_paragraph(self, index)`	Belirtilen matematik paragrafını TextBox nesnesinin TextBody özelliğinden alın. Fark etme: (1) Dizin sınırların dışında olduğunda veya bulunamadığında NULL döndürür. (2) Ayrıca belirtilen dizin konumu bir matematik paragrafı değilse NULL döndürür.
`get_equation_paragraph(self)`	TextBox nesnesinin TextBody özelliğinden ilk matematik paragrafını alır.
`get_result_of_smart_art(self)`	Akıllı sanatı gruplanmış şekillere dönüştürme.
`to_front_or_back(self, orders)`	Şekli öne getirir veya arkaya gönderir.
`get_locked_property(self, type)`	Kilitli mülkün değerini alır.
`set_locked_property(self, type, value)`	Kilitli özelliğini ayarlayın.
`add_hyperlink(self, address)`	Şekle bir köprü ekler.
`remove_hyperlink(self)`	Şeklin hiperlinkini kaldırır.
`move_to_range(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column)`	Şekli belirtilen bir aralığa taşır.
`align_top_right_corner(self, top_row, right_column)`	Resmi sağ üst köşeye taşır.
`get_connection_points(self)`	Bağlantı noktalarını alın
`get_linked_cell(self, is_r1c1, is_local)`	Kontrolün değerine bağlı aralığı alır.
`set_linked_cell(self, formula, is_r1c1, is_local)`	Kontrolün değerine bağlı aralığı ayarlar.
`get_input_range(self, is_r1c1, is_local)`	Kontrolü doldurmak için kullanılan aralığı alır.
`set_input_range(self, formula, is_r1c1, is_local)`	Kontrolün doldurulmasında kullanılan aralığı ayarlar.
`update_selected_value(self)`	Bağlantılı hücrenin değerine göre seçili değeri güncelle.
`calculate_text_size(self)`	Metin alanını yeniden hesapla
`format_characters(self, start_index, length, font, flag)`	Bazı karakterleri yazı tipi ayarıyla biçimlendirir.
`characters(self, start_index, length)`	Metin içindeki karakter aralığını temsil eden bir Characters nesnesi döndürür.
`get_characters(self)`	Tüm Karakter nesnelerini döndürür metin içindeki karakter aralığını temsil eder.
`get_rich_formattings(self)`	Tüm Karakter nesnelerini döndürür metin içindeki karakter aralığını temsil eder.
`remove_active_x_control(self)`	ActiveX denetimini kaldırın.
`is_same_setting(self, obj)`	Şeklin aynı olup olmadığını döndürür.
`get_actual_box(self)`	Şeklin gerçek konumunu ve boyutunu alın (döndürme, çevirme vb. uygulandıktan sonra)
`fit_to_text_size(self)`	Tüm metin içeriğini görüntülemeye uygun bir metin alanı yeniden hesaplayın.

Örnek

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")

Ayrıca bakınız

Spinner sınıfı TextBoxCollection sınıfı