AutoPlay Media Studio 9 ile Metin Dosyası Yükleme ve Ekranda Gösterme

[guclusat]

Load and Display a Text File

To display a large amount of text on your page use the TextFile.ReadToString action, and display the
results in a paragraph object.

To accomplish this in AutoPlay Media Studio:

1. Choose Object > Paragraph from the menu.
2. Insert the following code into any event in your application:

text = TextFile.ReadToString("AutoPlay\\Docs\\large_text.txt");
Paragraph.SetText("Paragraph1", text);

 

[guclusat]

AutoPlay Media Studio (AMS) projelerinde harici bir metin (.txt) dosyasının içeriğini okumak ve bunu uygulama içindeki bir paragraf nesnesinde görüntülemek için kullanılan en temel yöntemi açıklıyor.

İşlem adımları şu şekildedir:

1. Paragraf Nesnesi Ekleyin: Menüden Object > Paragraph yolunu izleyerek sayfanıza bir paragraf alanı oluşturun.
2. Kod Uygulama: Metni yüklemek istediğiniz olaya (örneğin bir butonun On Click olayına veya sayfanın On Show olayına) şu kodları ekleyin:

-- Belirtilen yoldaki metin dosyasını oku ve bir değişkene aktar
text = TextFile.ReadToString("AutoPlay\\Docs\\large_text.txt");

-- Okunan metni "Paragraph1" isimli nesneye yazdır
Paragraph.SetText("Paragraph1", text);

Önemli İpuçları:​

• Dosya Yolu: Kodda geçen "AutoPlay\\Docs\\large_text.txt" kısmı, projenizin belgeler klasöründeki dosyayı temsil eder. Dosya isminiz farklıysa bu kısmı güncellemeyi unutmayın.
• Hata Kontrolü: Eğer dosya bulunamazsa boş bir metin görünebilir. Dosyanın varlığından emin olmak için File.DoesExist kontrolü eklenebilir.
• Büyük Dosyalar: Çok büyük metin dosyaları için paragraf nesnesinin "Scrollbar" (Kaydırma çubuğu) özelliğinin aktif olduğundan emin olun.

 

[guclusat]

AutoPlay Media Studio 9 ile TXT Metin Dosyası Yükleme ve Paragrafta Gösterme​

AutoPlay Media Studio projelerinde uzun açıklamaları veya değiştirilebilir metinleri doğrudan proje içerisine yazmak yerine harici bir .txt dosyasından okuyarak uygulama içerisinde gösterebilirsiniz. Bunun için TXT dosyasının içeriği TextFile.ReadToString ile okunur ve elde edilen metin Paragraph.SetText komutu kullanılarak bir paragraf nesnesine aktarılır. Bu yöntem özellikle yardım dosyaları, kullanım açıklamaları, teknik bilgiler ve proje içerisinde gösterilecek uzun metinler için oldukça kullanışlıdır.

Paragraf Nesnesini Oluşturma​

Öncelikle projenizde metnin gösterileceği bir paragraf nesnesi oluşturun.

Menüden:

Object > Paragraph

seçeneğini kullanarak sayfaya bir paragraf ekleyin. Paragraf nesnesinin adını örneğin Paragraph1 olarak bırakabilirsiniz.

Uzun metinler gösterecekseniz paragraf nesnesinin kaydırma çubuğu özelliğini de aktif hale getirmeniz faydalı olacaktır.

TXT Dosyasını Okuma ve Paragrafa Aktarma​

Metin dosyasını hangi olay içerisinde göstermek istiyorsanız kodu o olay bölümüne ekleyebilirsiniz. Örneğin bir butonun On Click olayında veya sayfanın On Show olayında kullanılabilir.

Örneğin:

text = TextFile.ReadToString("AutoPlay\Docs\large_text.txt");

Paragraph.SetText("Paragraph1", text);

Burada ilk satırda large_text.txt dosyasının tamamı okunarak text değişkenine aktarılır. İkinci satırda ise değişkende bulunan metin Paragraph1 isimli paragraf nesnesinde görüntülenir.

Dosya Yoluna Dikkat​

Kod içerisindeki:

"AutoPlay\Docs\large_text.txt"

ifadesi, projenin AutoPlay\Docs klasörü içerisindeki large_text.txt dosyasını gösterir.

Örneğin dosyanızın adı bilgi.txt ise kod şu şekilde olmalıdır:

text = TextFile.ReadToString("AutoPlay\Docs\bilgi.txt");
Paragraph.SetText("Paragraph1", text);

Dosyanın proje içerisinde belirtilen klasörde bulunduğundan emin olun.

Dosya Varsa Okuma​

Dosyanın bulunamadığı durumlarda hata veya boş içerik ile karşılaşmamak için okumadan önce File.DoesExist ile kontrol yapılabilir:

local file = "AutoPlay\Docs\large_text.txt";

if File.DoesExist(file) then
local text = TextFile.ReadToString(file);
Paragraph.SetText("Paragraph1", text);
else
Paragraph.SetText("Paragraph1", "Metin dosyası bulunamadı.");
end

Bu kullanımda önce TXT dosyasının mevcut olup olmadığı kontrol edilir. Dosya bulunuyorsa içeriği okunup paragrafta gösterilir, dosya yoksa kullanıcıya bilgi veren bir mesaj görüntülenir.

Büyük Metin Dosyaları​

Uzun TXT dosyalarını paragraf içerisinde göstermek için paragraf nesnesinin kaydırma çubuğunun kullanılabilir durumda olması önemlidir. Böylece metin nesnenin alanına sığmadığında kullanıcı aşağı-yukarı kaydırarak içeriğin tamamını okuyabilir.

Bu yöntem sayesinde metinleri uygulamanın kodundan ayrı bir .txt dosyasında tutabilir ve gerektiğinde TXT dosyasını değiştirerek uygulamadaki açıklamaları güncelleyebilirsiniz.

 

[guclusat]

TXT Dosyasını Seçerek Paragrafta Gösterme​

Metin dosyasının proje içerisinde sabit bir konumda bulunmasını istemiyorsanız, kullanıcıya TXT dosyasını seçtirebilir ve seçilen dosyanın içeriğini doğrudan Paragraph nesnesinde gösterebilirsiniz.

Bu yöntem özellikle farklı TXT dosyalarını aynı paragraf alanında açmak istediğiniz projelerde kullanışlıdır. Kullanıcı Dosya Aç penceresinden bir TXT dosyası seçer, seçilen dosyanın yolu alınır ve TextFile.ReadToString ile dosyanın tamamı okunarak paragraf nesnesine aktarılır.

Öncelikle sayfanıza bir Paragraph nesnesi ve bir Button ekleyin. Paragraf nesnesinin adının Paragraph1 olduğunu varsayalım.

Butonun On Click olayına aşağıdaki kodu ekleyebilirsiniz:

file = Dialog.FileBrowse(
true,
"TXT Dosyası Seç",
_DesktopFolder,
"Metin Dosyaları (.txt)|.txt|",
"",
"",
false,
true
);

if file[1] ~= "CANCEL" then
text = TextFile.ReadToString(file[1]);
Paragraph.SetText("Paragraph1", text);
end

Bu kod çalıştırıldığında kullanıcıya bir dosya seçim penceresi açılır. Dosya filtresi sayesinde .txt uzantılı dosyalar gösterilir. Kullanıcı bir dosya seçtiğinde dosyanın tam yolu file[1] değişkeninden alınır ve TextFile.ReadToString ile içeriği okunur. Daha sonra okunan metin Paragraph1 nesnesinde görüntülenir. İptal seçilirse herhangi bir işlem yapılmaz.

Daha Güvenli Kullanım​

Dosya seçimi sonrasında kontrolü biraz daha açık yapmak isterseniz aşağıdaki yöntemi kullanabilirsiniz:

file = Dialog.FileBrowse(
true,
"TXT Dosyası Seç",
_DesktopFolder,
"Metin Dosyaları (.txt)|.txt|",
"",
"",
false,
true
);

if file ~= nil and file[1] ~= "CANCEL" then

text = TextFile.ReadToString(file[1]);

if text ~= nil then
    Paragraph.SetText("Paragraph1", text);
else
    Paragraph.SetText("Paragraph1", "Dosya okunamadı.");
end

end

Burada kullanıcı dosya seçim penceresini iptal ederse paragrafın mevcut içeriği değiştirilmez. Bir TXT dosyası seçildiğinde ise dosyanın içeriği okunarak paragraf nesnesine aktarılır.

Başlangıç Klasörünü Değiştirme​

Dosya seçim penceresinin masaüstü yerine farklı bir klasörde açılmasını istiyorsanız _DesktopFolder yerine başka bir klasör yolu kullanabilirsiniz.

Örneğin:

file = Dialog.FileBrowse(
true,
"TXT Dosyası Seç",
"C:\Belgeler",
"Metin Dosyaları (.txt)|.txt|",
"",
"",
false,
true
);

Böylece dosya seçim penceresi doğrudan C:\Belgeler klasöründe açılır.

Bu şekilde AutoPlay Media Studio 9 içerisinde hem proje klasöründeki sabit bir TXT dosyasını okuyabilir hem de kullanıcıya istediği TXT dosyasını seçtirerek içeriğini aynı Paragraph nesnesinde gösterebilirsiniz.