[ Previous document | Content Table | Next document ]

11  OpenOffice.org Basic ve Dialogları

 

Bu belgede mavi olarak yazılan kısımlar tarafımdan ilave edilmiştir. İngilizce olarak bilinmesi faydalı olan terimlerin yanına mavi yazıyla türkçesi yazılmıştır.

OpenOffice.org  Basic macro ve Dialoglarını yaratmak ve düzenlemek için destek sunar.  Belgenin devamında OpenOffice.org Basic programlama ortamının kullanımını yada kısaca Basic IDE'sini göreceğiz.

• Kısım 11.1 OpenOffice.org Basic ve Dialogları - OpenOffice.org Basic ile ilk adımlar OpenOffice.org Basic UNO Programları yazılması için gerekli adımları anlatan bir kılavuzdur..

• Kısım  11.2 OpenOffice.org Basic ve Dialogları  - OpenOffice.org Basic IDE OpenOffice.org Tümleşik Geliştirme Ortamı (IDE) bir kılavuz bölümüdür. Aşağıdaki konuları açıklar;

•  

  • Basic and dialog kütüphanelerini düzenlemek için kullanılan dialog kutularını. 

  • Basic IDE  penceresininin işlevleri: Basic macro düzenleyici ve debugger (hata tesbit ve giderimi) veDialog düzenleyici . 

  • Olaylara makro atamasının yapılması 

• Kısım  11.3 OpenOffice.org Basic and Dialoglar - OpenOffice.org Basic Features of  OpenOffice.org ile tümleşik Basic programlama dilini tanımlar,

  • OpenOffice.org Basic genel dil özellikleri hakkında bilgi sunar. 

  • Kısım 3.4.3 Profesyonel UNO - UNO Dili ile bağlanma - OpenOffice.org Basic UNO API'si ve UNO diline nasıl bağlanılabileceği izah edilmiştir 

  • OpenOffice.org Basic'in JAVA gibi başka dillerden önemli farklılıklarını  izah eder. 

• Kısım 11.4 OpenOffice.org Basic and Dialoglar - İleri düzey kütüphane düzenleme Basic kütüphane sisteminin Basic makroları ve dialoglarını nasıl sakladığını ve yönettiğini izah eder. Bu kütüphanelere ve kütüphane elemanlarına kullanıcıların uygun arabirimlerle nasıl ulaşabileceğini açıklar.

• Kısım 11.5 OpenOffice.org Basic and Dialoglar - Dialog ve Dialog Kontrolleri ile programlama Dialog düzenleyisinde dialog yaratmak için kullanılan araç takımı kontrollerini açıklar. Bu kısımda çeşitli form kontrolleri ve özellikleri detaylı olarak açıklanmıştır.

• Kısım 11.6 OpenOffice.org Basic and Dialoglar - Dialogların çalışma anında yaratılması UNO Dialoglarının çalışma anında dialog düzenleyici kullanmadan nasıl yaratılacağını izah eder. Bu UNO bileşenlerinden nasıl gelişmiş formlar yaratılabileceğini görmek açısından yararlıdır. Kısım 11.5 OpenOffice.org Basic and Dialoglar - Dialog ve Dialog Kontrolleri ile programlama bölümünü geliştirerek araç takımı arabirimini daha anlaşılabilir kılar.

• Kısım  11.7 OpenOffice.org Basic and Dialoglar  - Kütüphane dosyası yapısı Basic IDE tarafından kullanılan çeşitli dosyaları ele alır.

• Kısım  11.8 OpenOffice.org Basic and Dialoglar - Kütüphane yerleşimi Bir lokal yada paylasımlı OpenOffice.org kurulumunda Basic kütüphanelerinin otomatik olarak yerleşimini ele alır.

11.1  OpenOffice.org Basic ile ilk adımlar

Adım Adım Öğretici ( Tutorial )

Bu kısım Basic IDE'sini geliştiricilerin kullanmasını sağlayan bir öğreticidir. Basic IDE'sinde bir program yazmak ve hata gidermek (debug) için gerekli adımları ve bir Basic iletişimi dizaynını açıklar. Bütün araçlar ve seçenekler için tam bir referans 11.2 OpenOffice.org Basic and Dialoglar - OpenOffice.org Basic IDE. kısmında Standart kütüphane içinde bir modül yaratılması bahsinde bulunabilir.

1. Yeni bir Writer belgesi yaratın ve kaydedin, örneğin, FirstStepsBasic.odt.

2. Araçlar – Makrolar – Makroları düzenle – OpenOffice.org Basic Tıklayın.

OpenOffice.org Basic Makroları iletişim kutusu görülür.  Makrodan listesi makro depolarından gelen makro Basic kodlarını gösterir. Burda daima Makrolarım ve OpenOffice.org Makroları  container'ları depoları ve her yüklenmiş olan belge için bir basic kütüphanesi vardır.

Illustration 11.1: Macro dialog

Yukarıdaki örnekte sadece FirstStepsBasic.odt belgesi yüklenmiş olduğu görülmektedir. Bu nedenle, Makrolarım,  OpenOffice.org Makroları  ve FirstStepsBasic.odt  Container'ları depoları görülmektedir. Makrolarım ve  FirstStepsBasic.odt container depolarının her ikiside  Standard olarak adlandırılan bir kütüphane içerir.OpenOffice.org Makroları  container deposu openofis kurulumuyla gelen kütüphaneleri içerir ki bunların çoğuda auto pilot'dur. Uygulamanın Standard kütüphaneleri ve tüm açık belgelerin kütüphaneleri daima yüklenirler. İletişim penceresinde seçilebilir durumdadırlar. Diğer kütüphaneler uygulamada kullanılmadan önce yüklenmelidirler.

Kütüphaneler asıl Basic kaynak kodu içeren modüllere sahiptir. Şimdi ikinci adımımızda ise kaynak kodumuz için FirstStepsBasic.odt belgemizin Standard kütüphanesinde yeni bir modül yaratacağız. 

1. Makrodan listesinde FirstStepsBasic.odt  gelin.

2. Belgenin altındaki Standard'ı seçin ve yeni düğmesine basın.

OpenOffice.org Module1 adıyla yeni bir modül yaratmak isteyip istemediğinizi soran bir iletişim kutusu çıkaracaktır. 

1. Kabul etmek için tamama basın.  

Basic kaynak düzenleyicisi Main adlı bir  Sub (subroutine) içeren bir pencereyle açılır. Subrutin bir program kümesindeki alt programdır işlenmesi bitince ana programa döner . 

Illustration 11.2: Basic source editor window

Basic düzenleyici durum çubuğunda Main sub'ının FirstStepsBasic.Standard.Modul1 bir parçası olduğu görülür. Şayet Basic düzenleyici menüsünde  Araçlar – Makrolar – Makroları düzenle – OpenOffice.org Basic'i seçerseniz.  FirstStepsBasic.odt belgesinin Standard kütüphanesi altında Module1 adıyla modül yaratılmış olduğunu görürsünüz.

Illustration 11.3

Şayet Makrodan liste kutusunda bir modül  seçilirse, Sağdaki listede sub ve fonksiyonlar görülür, su anda Sub main görülmektedir. Bir sub yada yada fonksiyon seçiliyken Düzenle düğmesi tıklanırsa Basic düzenleyici pencereyi açar ve seçilmiş olan sub yada fonksiyon gösterilir.

Bir Basic UNO program'ı yazılması ve hata giderimi ( Debugging)

Aşağıdaki kaynak kodu Basic düzenliyici penceresine girin. Bu örnek kullanıcıya bir grafik dosyasının yerini sorar ve belgemizde imlecin bulunduğu yere ekler. Daha sonra bu örnek grafik ekle auto pilot'u ( Sihirbaz )olarak geliştirilecektir.(BasicAndDialogs/FirstStepsBasic.odt) 

Sub Main 

    ' Grafik dosyasını kullanıcıya sor _ işareti satırın devam etmekte olduğunu gösterir

    sGraphicUrl = InputBox("Please enter the URL of a graphic file","Import Graphics","file:///")

    if sGraphicURL = "" then  ' Kullanıcı iptal'e bastı

        exit sub

    endif

 

    ' document modeline ulaşım için

    oDoc = ThisComponent

 

    ' Dökumanının metin servisine ulaşmak

    oText = oDoc.getText()

 

    'Belge servis sağlayıcı grafik nesnesi örneği oluştur.

    ' create an instance of a graphic object using the document service factory

    oGraphicObject = oDoc.createInstance("com.sun.star.text.GraphicObject")

 

    ' Grafik URL adresini ayarla

    oGraphicObject.GraphicURL = sGraphicURL

 

    ' Şu anki imleç konumunu getir ve ondan bir metin imleci yarat

    oViewCursor = oDoc.getCurrentController().getViewCursor()

    oCursor = oText.createTextCursorByRange(oViewCursor.getStart())

 

    ' Şu anki imleç konumuna grafiği ekle

    oText.insertTextContent(oCursor.getStart(), oGraphicObject, false)       

End Sub 

Şayet bir kelime için yardım istiyorsanız metin imleci kelimenin üzerinde iken F1 tuşuna basın. OpenOffice.org online yardımı Basic dili için yardım desteği içerir. 

oDoc = ThisComponent ile başlayan satır ile document modeline ulaşılır, ve biz OpenOffice.org Basic  UNO tümleşimini kullanırız.  ThisComponent Basic kodundan bir Document modeline ulaşım için kullanılan kestirme yoldur. Daha önceden FirstStepsBasic.odt belgesinde module1'i yaratmış olduğumuz için Basic kodu FirstStepsBasic.odt belgesi içine gömülmüştür.Makrolarım deposunda global bir kütüphane değildir, ve dolayısıyla Thiscomponent FirstStepsBasic.odt document modelini temsil eder.

Debug sırasında Basic değişkenlerinin değerlerini izlemek için Basic düzenleyici İzle alanında bir değişken ismi girin ve enter tuşuna basın. Ya da fare imleci ile değişkenin üzerine gelindiğinde ipucu olarak o değişkenin değeri görülebilir. Örneğimizde sGraphicUrl and oGraphicObject değişkenlerini izlemeye alıyoruz:

Artık Çalışma anında OpenOffice.org 2.0 Basic debugger ile UNO nesnelerinide incelemek mümkündür. 

Kullanıcı ara birimi ile bir Sub çağrılması

Bir  Makro özelleştirilmiş ikonlarla, menü girişi ile, klavye kısayolları ile resim gibi belge nesneleri ile veya belge olaylarıyla gibi yöntemlerle çalıştıtılabilir.Tüm bu girişlerin ayarlanması Makro iletişimindeki Ata butonuna basarak Özelleştir iletişiminde düzenlenebilir. Ya da Araçlar - Özelleştir menü komutuyla ayarlanabilir.

Main Sub'ına araç çubuğu ikonu atamak için, Araçlar - Özelleştir yoluyla açılan özelleştir iletişiminde Araç çubukları sekmesini açın Araç çubukları sekmesi aşağıdaki görünür:

Illustration 11.5

Araç çubukları sekmesinde Ekle düğmesine basın. Komutekle iletişimi ortaya çıkar Kategori listesinde OpenOffice.org Makrolarını seçerek FirstStepsBasic.odt listesini genişletin. FirstStepsBasic.Standard.Module1 seçildiğinde komullar listesi Sub Main için bir Main girişini gösterir. Ekle düğmesine basarak araç çubuğuna eklersiniz..

Artık belgemizde örnek makromuzu çalıştırabiliriz. 

Kısım 11.2.3 OpenOffice.org Basic and Dialoglar - OpenOffice.org Basic IDE - GUI olaylarına makro atanması Kullanıcı arabiriminde makronuzun ulaşılabilir olması için diğer seçenekleri açıklar..

Basit bir Dialog

Dialog Yaratılması

Basic IDE'sinde bir iletişim kutusu yaratmak için, Basic kaynak kodu düzenleyicisinde pencere altında bulunan Module1 sekmesi üzerinde sağ tıklayın ve Ekle - Basic İletişimi 'ni Dialog1 adlı yeni bir pencer açar:

Illustration 11.6

Formumuza komut düğmesi, seçenek düğmesi gibi kontrol elemanlarının ilavesi için iletişim dizayn araçlarına ihtiyaç duyarız. Kontrol ekle ikonuna tıklayarak açılır pencerede kontrolleri görüp seçebiliriz. Eğer araç kutusu pencere başlığından tutulup çalışma alanına sürüklenirse pencere daima açık olarak kalır.

İlk örnekte olduğu gibi sadece basit bir girdi kutusuyla çalışan iletişim yerine iletişimi bir dosyayı seçmek için kullanıcıya daha kullanışlı bir şekle getirebiliriz.  Ekstra olarak kullanıcı resim ekledikten sonra resimin nereye sabitleneceğini kontrol edebilir. Bunun için iki adımlı bir sihirbaz iletişimi yaratacağız. 

	Araç kutusu penceresinde Dosya seçimi ikonunu seçin. Form üzerinde sol tıklayıp sürükleyerek dosya seçimi öğesinin yerini ve boyutlarını belirleyin.
	Özellikler ikonu özellikler iletişimini görüntüler böylece kontrolleri düzenleyebilir, ayrıca iletişim sırasında meydana gelen olaylar için gerekli olan kodları yazabiliriz.
	Sonra,  << Back ve Next >> Düğmelerini iletişim adımları arasında gezilebilmesi için ekleyin, ve bir  Finish ve Cancel düğmesi ekleyin.  Düğme ikonunu seçin ve sol fare düğmesini kullanarak düğme boyutunu ayarlayın. Düğmeler CommandButton1 gibi öntanımlı metinlerle etiketlenmiştir. Şayet özellikler iletişim penceresi açılmaz ise yeni oluşturulmuş olan düğmeyi çift tıklayarak açabilirsiniz. yeni etiket alanında düğme etiketlerini girin. İsim alanı kontrolün program tarafından bilinen adıdır ve görüntülenen isim ile alakası yoktur aynı şekilde Back ve next tuşlarını adlandırın. and name the dialog step buttons Back and Next . << Back düğmesi için etkin özelliğini evet olarak ayarlayın. Basic dilinde çalışma zamanında nesne.enabled=false olarak ulaşılır. düğme etiketini değitirmek için  CommandButton1.label="Cancel" tekniği kullanılır.
	Etiket aracını kullanarak bir etiket ekleyin.. "Select Graphics File" gibi.

Şimdi form aşağıdaki örnekteki gibi görünür: 

Illustration 11.7

Formu Araç kutusunda bulunan Test kip açık/kapalı ikonu ile test edebilirsiniz. Testiniz bittiği zaman Formun kapat düğmesine basarak yada form başlığında kapata basarak kapatabilirsiniz.

İletişimi düzenlemek için; örneğin etiketi klikleyin kontrolün dış sınırında yeşil tutamaklar oluşur böylece kontrolü taşıyabilir veya etiketini değiştirebilirsiniz. Yeşil tutamaklarla kontrolü yeniden boyutlandırabilirsiniz.  Özellikler iletişim penceresi iletişimin başka özelliklerini de ayarlamaya yarar. ileşimi bu buradn boyutlandırabilr. konumlandırabilirsiniz.

Olay yönetimi (Adding Event Handlers)

Şimdi formu açmak ve düğmelere işlev kazandırmak için gerekli kodları yazacağız. createUnoDialog() nesnesinin execute() metodunu kullanarak bir formun görüntülenmesini sağlarız. Bir form iletişim nesnesi yaratarak formumuzu görüntüleyebiliriz endExecute()metodu ile de formumuzu kapatır ve işleyişine son veriririz.

Finish ve Cancel düğmesi  için düğme türünü Cancel  (İptal) olarak ayarlamakla formu kapatmakta mümkündür. Execute metodu Cancel için 0 OK için 1 değeri ile geri döner.

GUI elemanlarına işlevsellik kazandırmak için Sub'lar geliştirin ve bunları GUI elemanlarına bağlayın. Formumuzdaki düğmele işlev kadandırmak için Basic IDE Penceresi altında bulunan Module1 sekmesine tıklayın. Aşağıdaki sub kodlarını Sub main üstüne kopyalayın. Private değişken oDialog  Subların dışında tanımlanmıştır. Formumuzun yüklenmesinden sonra Module1'deki bütün Sub ve fonksiyonlar tarafından erişilebilir olması sağlanmıştır.  (BasicAndDialogs/FirstStepsBasic.odt)

Private oDialog as Variant  ' private, module-wide variable Variant değişkenler bir nesneyi sayıyı yada metini tutabilir aynı değişkene çeşitli tipler aktaracaksak yararlıdır

 

Sub RunGraphicsWizard 

    oDialog = createUnoDialog(DialogLibraries.Standard.Dialog1)

    oDialog.execute

End Sub 

 

Sub CancelGraphicsDialog 

    oDialog.endExecute()

End Sub 

 

Sub FinishGraphicsDialog 

    Dim sFile as String, sGraphicURL as String

 

    oDialog.endExecute()

 

    sFile = oDialog.Model.FileControl1.Text

 

    ' Bir FileControlu sistem yolu içerir ve dosya URL'si haline çevrilmesi gereklidir

    ' Bu nedenle ConvertToURL Basic fonksiyonu kullanıyoruz

    sGraphicURL = ConvertToURL(sFile)

 

    ' Grafik ekle

    ' Document modeline eriş

    oDoc = ThisComponent

    ' Document metin servisine eriş

    oText = oDoc.getText()

    ' Belge servis sağlayıcı grafik nesnesi örneği oluştur (document service factory)

    oGraphicObject = oDoc.createInstance("com.sun.star.text.GraphicObject")

    ' Grafik URL'sini ayarla

    oGraphicObject.GraphicURL = sGraphicURL

    ' GUI'de şuanki imleç pozisyonunu getir ve ondan bir metin imleci yarat

    oViewCursor = oDoc.getCurrentController().getViewCursor()

    oCursor = oText.createTextCursorByRange(oViewCursor.getStart())

    ' Grafik nesnesini imleç konumuna ekle

    oText.insertTextContent(oCursor.getStart(), oGraphicObject, false)       

End Sub 

 

Sub Main 

        ...

End Sub 

Cancel düğmesini seçin ve özellikler iletişim penceresinde olaylar sekmesine tıklayın. Başlatırken form alanındaki sağ taraftaki Makro ata iletişiminde (...)  düğmesine tıklayın. FirstStepsBasic.odt.Standard.Module1, CancelGraphicsDialog yordamını seçin ve ekle düğmesini tıklatarak düğmemize  yordamı bağlayın

Finish  düğmesi içinde aynı yöntem kullanılarak FinishGraphicsDialog yordamı ile ilişkilendirin.

AutoPilot Formları Dialogs

Son adımda iki sayfalı küçük bir AutoPilot yaratacağız.. The OpenOffice.org Formları Autopilot sayfaları için basit bir işlem anlayışına sahiptir. Dialogdaki Her form ve her kontrol sayfa kontrolü için  Page (Step) Adım özelliğine sahiptir. Normal olarak iletişimler sayfa 0'da olurlar fakat başka bir sayfa olarak ayarlanabilirler, örneğin sayfa1 Sayfa1'deki Tüm kontrolleri sadece sayfa1de görüntülemek için  Adım 1 değerine sahip olmalıdr. Aynı şekilde kontollerin sayfa2'de görüntülenmesi için 2 değeri olmalıdır.Şayet Form Sayfa0'da ise tüm kontroller görüntülenir. Bir kontrolün sayfa özelliği 0 olarak ayarlanmışsa tüm form sayfalarında gözükür.

Böylece ikinci bir sayfa yaratılması için kullanılır.  Ctrl Tuşuna basılı tutarken Label ve filecontrol elemanlarını klikleyerek ikisini de seçin. Özellikler iletişiminde Page  Sayfa(Basamak)  özelliği için 1 değerini girin ve enter tuşuna basarak değişimi uygulayın. Form dış çerçevesini tıklatarak özellikler iletişimini açın Page değerini 2 olarak girin ve enterleyin. Label  ve filecontrol kaybolur çünkü şimdi sayda2'deyiz. Sadece düğmeler sayfa0 da oldukları için görüntülenir.

Sayfa2'de, "Anchor"  adlı label etiket ekleyin ve iki adet option buttons seçenek düğmesi ekleyin"Etiket için "at Paragraph" ve "as Character"belirleyin. "At paragraph" için State Durum alanında toggle etkin olarak belirleyek varsayılan olarak bu seçeneğin seçilmesini sağlayın. Yeni kontroller otomatik olarak Page sayfa 2 özelliğini alırlar. Page2 bittiğinde Dialog'u 1 olarak ayarlayalım. Çünkü uygulamanın başlangıcında 1 numaralı sayfayı istiyoruz.

Illustration 11.9

Aşağıdaki Sub'lar << Back and Next >> düğmeleriyle çalışması gereken yordamlardır.  FinishGraphicsDialog  yordamı kullanıcı tarafından seçilen yeni grafiği dosyaya eklemek içindir. GUI'de Page (Step) olan özellik. API'de step   (BasicAndDialogs/FirstStepsBasic.odt)

Sub BackGraphicsDialog 

    oDialog.Model.Step = 1

    oDialog.Model.Back.Enabled = false

    oDialog.Model.Next.Enabled = true

End Sub 

 

Sub NextGraphicsDialog 

    oDialog.Model.Step = 2

    oDialog.Model.Back.Enabled = true

    oDialog.Model.Next.Enabled = false

End Sub 

 

Sub FinishGraphicsDialog 

    Dim sGraphicURL as String, iAnchor as Long

    oDialog.endExecute()

    sFile = oDialog.Model.FileControl1.Text

    ' State = Selected corresponds to 1 in the API Seçilmiş ise State = 1 değerine sahiptir

    if oDialog.Model.AsCharacter.State = 1 then

        iAnchor = com.sun.star.text.TextContentAnchorType.AS_CHARACTER

    elseif oDialog.Model.AtParagraph.State = 1 then

        iAnchor = com.sun.star.text.TextContentAnchorType.AT_PARAGRAPH

    endif

    ' Dosya seçimi kontrolü bir sistem yolu ile döner ve onu dosya URL'si ne çevirmeliyiz

    ' Bunun için MakeFileURL fonksiyonu kullanırız

    sGraphicURL = MakeFileURL(sFile)

    ' Belge modeline erişim temini

    oDoc = ThisComponent

    ' Belge metin servisini al

    oText = oDoc.getText()

    ' Belge servis sağlayıcı grafik nesnesi örneği oluştur (document service factory)

    oGraphicObject = oDoc.createInstance("com.sun.star.text.GraphicObject")

    ' Grafik URL'sini ayarla

    oGraphicObject.GraphicURL = sGraphicURL

    oGraphicObject.AnchorType = iAnchor

    ' GUI'de Şu anki imleç pozisyonunu al ve metin imleci yarat.

    oViewCursor = oDoc.getCurrentController().getViewCursor()

    oCursor = oText.createTextCursorByRange(oViewCursor.getStart())

    ' Gfafiği matin başına ekle

    oText.insertTextContent(oCursor.getStart(), oGraphicObject, false)               

End Sub 

11.2  OpenOffice.org Basic IDE

Bu bölüm OpenOffice.org Basic tümleşik geliştirme ortamının (IDE)bütün özelliklerini açıklar. Basic ve Dialog kütüphanelerinin nasıl yönetileceğini, Basic IDE'sindeki araçlarla Basic makrolarının ve dialoglarının kullanımı anlatılacaktır, ve olaylara Basic makroları atanması için çeşitli yöntemler değerlendirilecektir.

11.2.1  Basic ve Dialog Kütüphanelerinin yönetimi

Kütüphane yönetimine kullanıcı ara biriminde ana giriş noktası Araçlar - Makrolar - Makroları düzenle - OpenOffice.org Basic  menü elemanıdır. Bu seçenekle OpenOffice.org Basic Makroları dilog kutusunu açarki bu dilogda kullanıcı Basic Ve Dialoglarla ilgili tüm operasyonları yürütebilir.

OpenOffice.org Basic Makroları Dialoğu

Aşağıdaki resim örnek bir Makro dialoğunu gösterir. Buradan makroları çalıştırabilir, yaratabilir, çalıştırabilir, silebilir, UI olaylarına makro atayabilir ve Basic Kütüphaneleri,ve modüllerini yönetebilirsiniz.. 

Illustration 11.10

Görüntülenen Bilgi

Makrodan ağaç görünümü kısmı dialoğun açılmış olduğu andaki tüm kütüphane yapısını gösterir.  OpenOffice.org Kütüphane organizasyonu (düzenleyici) hakkındaki detaylar için 11.4 OpenOffice.org Basic and Dialogs - Advanced Library Organization kısmına bakın...

Bu dialogda Basic yada Dialog kütüphaneleri arasında ayrım gözetilmezken Kütüphane düzenleme API'sinde farklı olarak uygulanır.  

Makrodan ağacı üç kademeli bir yapı olarak görüntülenmir:

Library container -> library -> library element Kütüphane deposu -> Kütüphane -> Kütüphane elemanı  

• Üst seviye node'ları düğümler  Basic ve dialog kütüphane container'ını temsil eder. ( My Macros and OpenOffice.org Macros Nodes Makrolarım ve Openoffice.org makroları ). Açılmış olan her bir belge için, belgenin  Basic and dialog kütüphane container'ı görüntülenir. ( 11.4 OpenOffice.org Basic ve Dialoglar - Gelişmiş kütüphane yönetimi  kısmına bakın). Örnekte Description.odt adlı bir metin belgesi ve Calculation.ods adlı Calc belgesi olarak iki belge açılmıştır.

• İkinci seviye Node'da her eleman bir kütüphaneyi gösterir. İlkin Standard olarak adlandırılan varsayılan kütüphaneler haricindeki tüm kütüphaneler yüklenmemiş ve gri görünümlüdür. Kütüphaneyi yüklemek için kullanıcı kütüphane ismini çift tıklamalıdır. Yukardaki örnekte Makrolarım kök elemanı Standard kütüphanesini içerir varsayılan olarak yüklenmiştir.

• Ağacın üçüncü seviyesinde yüklenmiş kütüphaneler görünür durumdadır. Her node bir kütüphane elemanını temsil ederki bunlar modül yada dialog olabilirler.OpenOffice.org Basic Makroları dialogunda sadece basic modulleri kütüphane elemanı olarak görüntülenir, bu iletişimde dialoglar görünmez. Bir kütüphaneye çift tıklamayla kullanıcı kütüphanenin modüllerini genişletip gizleyebilir. Örnekte Makrolarım/Standard kütüphanesi açılmış olarak görülmektedir. Module1 ve module2 olarak iki modül içermektedir. Description.odt belgesi module1 adlı basic modülü olan standard kütüphanesi bulundurmaktadır. Calculation.ods  basic module'u olmayan bir Standard kütüphane içermektedir. Tüm kütüphaneler dialog içerseler bile bu görünümde dilog kütüphaneleri görülemez.

Eğer bir kütüphane şifre korumalı ise ve kullanıcı onu yüklemek için çift tıklatırsa, Şifreyi soran bir iletişim görünecektir. Kütüphane kullanıcı doğru şifreyi girdiğnde yüklenecek ve görüntülenecektir.Bir şifre korumalı kütüphane API kullanılarak yüklenirse, örneğin BasicLibraries.loadLibrary("Library1") çağrısıyla, yüklendiği gibi gösterilir Grileştirilmemiş olarak. Fakat doğru şifre girilene kadar ağaç görünümü açılıp içi görülemez. ( 11.4 OpenOffice.org Basic and Dialogları - Gelişmiş kütüphane yönetimi).

 

Orta sütun (düzenleme alanı) makrolar hakkında bilgileri görüntülerki bunlar seçilmiş olan modüle ait Sub ve Fonksiyonların listesidir. Makro adı bulunan Düzenleme alanında  bir sub veya fonksiyon seçilebilir. Şayet Makrodan iletişim kutusunda herhangi bir modül seçilmemişse düzenleme alanı ve liste boş kalır. İstenilen adı düzenleme alanına yazabilirsiniz.

Düğmeler

OpenOffice.org Basic Makrolar dialoğunun sağ tarafında aşağıda listede tanımlanan çeşitli komut düğmeleri vardır:

• Run Çalıştır
  Makro adı düzenleme alanında gösterilen Sub yada Fonksiyonu çalıştırır. Makro çalıştırılmadan Makrolar dialoğu kapatılır.

• Close Kapat
  OpenOffice.org Basic Makrolar dialoğunu başka herhangi bir eylem yapmadan kapatır.

• Assign Ata
  Araçlar - Özelleştir menüsündende açılabilen Özelleştir dialoğunu açar. Bu iletişim Opens the Customize dialog that can also be opened using Tools - Customize. Bu Dialog olaylara makro atanması için de kullanılabilir.ayrıntılar için aşağıdaki 11.2.3 OpenOffice.org Basic and Dialoglar - OpenOffice.org Basic IDE - GUI olaylarına Makro atanması'na bakın.

• Edit Düzenle
  Basic makro düzenleyiciye seçilmiş olan Modulü yükler. İmleç seçilmiş olan Makro veya fonksiyonun adının bulunduğu ilk satıra yerleştirilir. Ayrıntılar için aşağıdaki Kısım 11.2.2 OpenOffice.org Basic and Dialogları - OpenOffice.org Basic IDE - Basic IDE Penseresi 'ne bakın. şayet hiç bir modül yada yordam seçilmemişse bu düğme etkin değildir.

• Delete Sil 
  Bu düğme var olan bir Sub yada fonksiyon makro adı alanında görüntüleniyorsa etkindir ve delete düğmesi burda görüntülenen Sub yada fonksiyonu siler.

• New Yeni
  Bu düğme var olan bir Sub yada fonksiyon makro adı alanında görüntülenmiyorsa etkindir ağaçta seçilmiş olan module içine yeni bir Sub ekler. Yeni sub şayet makro adı alanında isim  yazıyorsa bu adla boş ise varsayılan olarak Macro1, Macro2 gibi adlarla otomatik olarak adlandırılır.

• Organizer Düzenleyici
  Bu komutla Takip eden kısımda anlatılan OpenOffice.org Basic Makro Düzenleyici dialog kutusu açılır.

• Help Yardım
  OpenOffice.org yardımını  makrolar başlığı altından başlatır.

OpenOffice.org Basic Makro Düzenleyici Dialogu

Bu dialog  OpenOffice.org Basic Makroları iletişiminde düzenleyici düğmesine basılarak açılır.Dialog kutusu Modüller, kütüphaneler ve Dialoglar sekmelerine sahiptir. Basic makroları iletişimi sadece kütüphaneler içindeki modülleri gösterebiliyorken Bu iletişim kutusu kütüphane sistemine module, dialog ve kütüphane seviyesinde ulaşır.

Modules Modüller

OpenOffice.org Basic Makro Düzenleyici Modüller sekmesi aktif olduğunda tüm modüller görüntülenir.Modül etiketli liste Makro Dialogundaki Makrodan listesi ile benzerdir. Fakat OpenOffice.org uygulama ve belge kütüphanelerinin tam bir hiyerarşisini içerir. Kütüphaneler çift tıklamayla yüklenebilir, açılabilir. ve ağac görünümü kapatılabilir. Şekilde Modul1 ve Module2 modüllerine sahip uygulama kütüphanesi Standard görüntülenmektedir.

Illustration 11.11

Yukarıdaki sunumda iki belgenin yüklenmiş olduğu görülmektedir. Description.odt belgesinin module1 modülüne sahip bir standard kütüphanesi görülmektedir. Calculation.ods belgesinde modüle sahip olmayan bir başka Standard kütüphanesi de görülmektedir.

Aşağıdaki listede ileişimdeki komut düğmelerinin fonksiyonlarını açıklar: 

• Edit Düzenle
  Ağac görünümünde seçilmiş olan modülü basic makro düzenleyiciye yükler. Herhangi bir modül seçili değilse düğme etkin değildir.

• Close Kapat
  OpenOffice.org Basic Makrolar dialoğunu başka herhangi bir eylem yapmadan kapatır.

• New Module Yeni Modül
  Kullanıcının yeni modül için modül adı yazabildiği bir iletişim açar. Ad alanı module<sayı> şeklinde görüntülenir. Örneğin Module1 ve Module2. Tamam düğmesine basarak modül listesine yeni modülü ilave edebilirsiniz. Seçilmiş olan kütüphane yazma korumalı ise Yeni modül düğmesi pasiftir.

• Delete Sil
  Şeçili olan modülü siler.Modül seçilmemişse ya da modül yazma korumalı bir kütüphanenin ise bu düğme pasiftir.

Dialogs

OpenOffice.org Basic Makro Düzenleyici Dialog ( İletişim Öğeleri )sekmesinin seçilmesiyle Dialog sayfası görüntülenir. Şekilde uygulama Standard kütüphanesinin Dialog1, Dialog2 ve Dialog3 adlı üç diyaloga sahip olduğu görülmektedir.

Illustration 11.12

Şekilde Calculation.ods adlı belgenin Dialog1 adlı bir diyalog içerdiği görülmektedir.Calculation.ods belgesinin herhangi bir diyalog'u olmadığı görülmektedir.

Takip eden listede komut düğmelerinin açıklaması yapılmıştır: 

• Edit Düzenle
  Ağaçtan seçilmiş olan dialog'u yükler. Aşağıdaki  11.2.2 Basic and Dialoglar - Basic IDE - Basic IDE Penceresi - Dialog Düzenleyici kısmında daha detaylı olarak açıklanmıştır. Şayet bir dialog seçilmemişse düğme etkin değildir.

• Close Kapat
  OpenOffice.org Basic Makro düzenleyici iletişimini kapatır .

• New Dialog Yeni Pencere
  Kullanıcının yeni form için isim verebildiği iletişimi açar. İsim alanında ilk olarak Dialog<Sayı>, Dialog1 ve Dialog2 gibi bir ad görünür.Tamam düğmesine basılmasıyla dialog listesinde dialog yaratılır.Seçim yazma korumalı bir kütüphane ise bu düğme etkin değildir.

• Delete Sil
  Seçili olan Diyalogu siler.Bu düğme bir dialog seçili değilse veya yazma korumalı bir kütüphanede bulunan dialog ise etkin değildir.

Libraries Kütüphaneler

 OpenOffice.org Basic Makro düzenleyici iletişiminin Kütüphaneler sekmesi seçildiğinde Aşağıdaki resimler görülmektedir. İletişim penceresinde uygulama ve belge kütüphaneleri ayrı olarak listelenmektedir. Kütüphane listesinde sadece konum liste kutusunda seçilmiş olan Kütüphane container'ının kütüphaneleri görüntülemektedir. İkinci resimde My Macros & Dialogs Makrolarım ve pencerelerim OpenOffice.org Macros & Dialogs OpenOffice.org Makrolerı & Dialogları ve şu anda açılmış olan belgelerdeki  girişleri görüntülemektedir.

Illustration 11.13

Illustration 11.14

Kütüphaneler aşağıdaki mantıkla listelenir: 

• Standard kütüphaneler siyah olarak görüntülenir. 

• Yazma korumalı kütüphaneler grileştirilmiş olarak görüntülenir. 

• Kütüphanenin Konumu, URL temsilinin(file://, HTTP:// gibi)sonuna kütüphane yolu eklenerek gösterilir. Yukardaki örnekte Standard ve Library1 haricindeki kütüphane yolları sadece okuma modundadır. 

• Şifre korumalı kütüphaneler adından önce bir anahtar resmi ile temsil edilirler. Örneğimizde sadece Library1 şifre korumalıdır. 

Bir kütüphane üzerine iki kez tıklanırsa (çift tıklama değil) kullanıcıya kütüphane ismini değiştirme imkanı sağlanır. 

Aşağıdaki liste komut düğmelerini açıklar: 

• Edit Düzenle
  Kütüphane liste kutusunda şeçilmiş olan kütüphanenin ilk modülünü Basi düzenleyiciye yükler.  (Aşağıdaki 11.2.2 Basic and Dialogları - Basic IDE - Basic IDE Penceresi - Basic Kaynak düzenleyici ve Debugger bölümüne bakın). Şayet kütüphane sadece dialoglara sahipse Dialog düzenleyici penceresinde ilk Dialog açılır(Aşağıdaki 11.2.2 Basic and Dialogları -  Basic IDE - Basic IDE Penceresi - Dialog Düzenleyici bölümüne bakın). Şayet Basic/Dialog düzenleyici penceresi açık değilse bu pencere açılır.

• Close Kapat
  Her hangi bir ekstra işlem yapmaksızın OpenOffice.org Basic Makro Düzenleyici dialog'unu kapatır.

• Password Şifre
  Aşağıdaki şekilde görülen seçilmiş olan kütüphane için şifre değiştirme iletişimini açar.

• Bu iletişim şayet bir kütüphane şifre korumalı ise şifresini değiştirmek için kullanılır. Önce eski şifreyi girip, sonra da yeni şifreyi iki kez girmek gerekir. 

  Kütüphane şifre korumalı değilse, Eski şifre alanı etkin değildir.Yeni şifre iki kez yazılarak girilebilir. Tamam düğmesine basıldığında iki şifre de aynıysa şifre koruması etkinleşir.

• New Yeni
  Kullanıcının yeni kütüphane için isim verebildiği iletişimi açar. İsim alanında ilk olarak Library<Sayı>, Library1 ve Library2 gibi bir ad görünür.Tamam düğmesine basılmasıyla kütüphane yaratılır ve kütüphane listesine eklenir. Yeni bir kütüphane daima Basic ve dialog kütüphanesi olarak yaratılır.

• Append Sonuna ekle
  Bu düğme ekstra kütüphanelerin seçilmiş olan kütüphane container'ına getirilmesi için kullanılır. Düğmeye tıklanması ile açılan dosya iletişiminde kullanıcı getireceği kütüphanenin yolunu ve ismini seçer. Aşağıdaki listede görülen dosya tipleri seçilebilir:

•  

  • Kütüphane container'ı indeks dosyaları (script.xlc veya dialog.xlc)

  • Kütüphane indeks dosyaları (script.xlb veya dialog.xlb)

  • OpenOffice.org belgeleri (örneğin *.odt, *.ods,*.sxw, *.sxc, *.sdw, *.sdc)

  • Star Ofis 5.x ve eski sürüm Basic kütüphane dosyaları (*.sbl)

  Bir dosya seçildikten sonra Kütüphane ekle iletişimi görüntülenir. Aşağıdaki şekilde bir kütüphane indeks dosyası olan script.xlb seçildikten sonraki iletişim penceresi görülmektedir. İletişim seçilmiş olan dosyadaki bütün kütüphaneleri listelemektedir. Örneğimizde sadece Euro kütüphanesi görünmektedir, çünkü . script.xlb dosyası sadece bu kütüphaneyi temsil etmektedir.

• Seçenekler kısmındaki onay kutusu seçiliyse bir kütüphanenin sadece oku modundaki bir linkle eklendiğine işaret eder. varolan aynı isimli kütüphaneler yeni bir kütüphane ile değiştirilirler. 

  Devam eden şekilde LibraryImportExample writer belgesi seçildikten sonraki iletişim görüntülenmektedir. Bu belge Standard, Library1, Library2 ve Library3 adlı dört kütüphaneye sahiptir. Library1 ve Library2 eklenmek için seçilmiş durumda gözükmektedirler Insert as reference (read-only) seçeneği pasiftir.çünkü belge içinde bulunan kütüphaneler köprü olarak refere edilemezler. Ayrıca StarOfis 5.x Basic kütüphane dosyaları da bağlanamazlar.

• Tamam düğmesine basılarak seçilmiş olan basic ve dialog kütüphaneleri kütüphane container'ına eklenir.

• Delete Sil
  Kütüphane liste kutusunda Seçili öğeyi siler. Eğer öğe bir kütüphane yolunu gösteriyorsa sadece link silinir. Sil düğmesi bir standard kütüphane seçiliyse pasiftir. Çünkü Standard kütüphaneler silinemez.

11.2.2  Basic IDE Window Basic Tümleşik Geliştirme ortamı Penceresi

IDE esas olarak Basic IDE penceresi ile temsil edilir. IDE iki farklı moda sahiptir: 

• Basic düzenleyici modunda Debugging işlemi ve debugger çıktılarının kontrol edilmesi için Basic kaynak kod modüllerini görüntüler ve düzenler

• Dialog düzenleyici modunda formlar görüntülenir ve düzenlenir.

Basic kaynak kodu ve formlar asla aynı anda görüntülenmezler. IDE penceresi Basic düzenleyici veya debugger veya dialog düzenleyicinin içindedir. Aşağıdaki şekilde uygulama Standard kütüphanesindeki module2'yi görüntüleyen Basic düzenleyici modundaki Basic IDE penceresi görülmektedir. 

Illustration 11.18

IDE penceresi Basic ve Dialog düzenleyici modu için genel olan kontrol elemanları aşağıda açıklanmıştır. Moda özel olan kontrol öğeleri karşılık gelen alt kısımlarda açıklanmıştır. 11.2.2 Basic and Dialoglar -  Basic IDE - Basic IDE Penceresi - Basic kod Düzenleyici ve 11.2.2 Basic ve Dialoglar -  Basic IDE - Basic IDE Penceresi - Dialog Düzenleyici:

• Ana araç çubuğundaki Yazıcı ikonuna tıklayarak herhangi bir yazıcı iletişim kutusu görmeden halihazırda görüntülenen modül veya form yazıcıya direk olarak yazdırılır.

• Ana araç çubuğundaki Kaydet ikonu IDE penceresinde görüntülenen kütüphaneye göre iki farklı şekilde davranır.

• Şayet kütüphane bir uygulama kütüphane container'ına ait ise Sakla düğmesi bütün düzenlenmiş uygulama kütüphanelerini kaydeder.

• Kütüphane bir belgeye ait ise, Kaydet düğmesi belgeyi kaydeder.

• Araç çubuğunun sol tarafında bulunan kütüphane liste kutusu şu an için görüntülenen kütüphanenin adını gösterir. Kullanıcı görüntülenen kütüphaneyi bu listeden seçerek değiştirebilir. Yukarıdaki örnekte ([My Macros & Dialogs].Standard) uygulama Basic Standard kütüphanesi görüntülenmektedir. Liste kutusu hali hazırda erişilebilir durumda olan bütün uygulama ve belge kütüphanelerini içerir. Kullanıcı bunlardan birini seçerek Kütüphaneyi IDE penceresinde görüntüleyebilir.

• IDE penceresinin altında bulunan sekmeler aktif kütüphanedeki bütün modülleri ve formları gösterir.Bu sekmeleri tıklayarak ilgili modül veya form açılabilir. Gerekliyse IDE penceresi Basic düzenleme modundan form moduna yada tam tersine döner. Sekmeye sağ tıklamayla içerik menusu açılır: 

•  

  • Insert Ekle yeni bir modül veya dialog eklemek için bir alt menüyü açar.

  • Delete Sil onaylama sorgusu sonucunda aktif formu veya dialog'u siler .

  • Rename Yeniden adlandır  aktif modül veya formun adını değiştirir.

  • Hide Gizle aktif modül veya formu görünmez yapar. Gizlenen modül veya form sekmelerde görünmez ve etkinleştirilemez. Basic Makroları veya  Basic Makro Düzenleyici iletişimi edit Düzenle düğmesi ile aktifleştirilip düzenlenebilir .

  • Modules Modüller Basic Makro Düzenleyici iletişimini açar .

• Durum çubuğu aşağıdaki bilgileri görüntüler: 

•  

  • Soldaki ilk hücrede aktif modülün veya formun tam adı görüntülenir. LibraryContainer.LibraryName.<ModuleName | DialogName> KütüphaneDeposu.Kütüphaneİsmi.<Modülİsmi | Dialogİsmi> . 

  • İkinci hücrede bir asterisk "*" görüntülenirse, Aktif kütüphane container'ında en azından bir kütüphanenin değiştirildiği ve kaydedilmesi gerektiğini gösterir. 

  • Üçüncü hücrede Basic düzenleyici penceresindeki imlecin yeri görüntülenir. 

  • Dördüncü hücrede Basic düzenleyici ekleme modunda ise "INSRT" "EKLE" üzerine yaz modunda ise "OVER" "ÜZR" görüntülenir. Modlar arası geçiş İnsert tuşuyla olur.

Basic Source Editor and Debugger Basic Kaynak düzenleyici ve Hatagiderimi

Kullanıcı bir Sub yada fonksiyonu düzenlerken, Basic düzenleyici ve debugger penceresi görüntülenir. Bu modda, düzenleyicinin ana penceresi, değişkenlerin değerlerini görüntülemek için debugger watch İzleme penceresi, Basic call stack'ını (çağrı yığıtı) görüntülemek için Debugger Call Çağrılar: penceresi mevcuttur. Watch ve Call pencereleri sadece Basic programı çalışıyorken makro debugger tarafından durdurulmuşsa kullanılır.

Düzenleyici genel editor işlevlerine sahiptir. Düzenleyici sadece OpenOffice.org Basic programlama dilini  ve sözdizimi renklendirme ayrıca Basic anahtar kelimeleri ile ilgili F1 yardımını destekler. 

Illustration 11.19: Basic Editor and Debugger

Aşağıdaki listede Makro araç çubuğu işlevleri açıklanmıştır. 

	Compile Derle : Aktif modülü derler ve gerekliyse bir hata mesajı görüntüler. Şayet bir Basic programı çalışıyorsa bu düğme pasiftir. Kütüphaneleri dağıtma hazırlamadan önce daima derleyin.
	Run Çalıştır: Aktif modüldeki ilk Sub'u çalıştırır. Aktif kütüphanedeki bütün değiştirilmiş modüller derlenmeden önce kullanılırsa bazı derleyici hataları alınabilir. Program başlamadan önce kullanılırsa da hatalara neden olabilir. Debugger vasıtasıyla program yürütülmesi durdurulmuşken bu komut kullanılırsa program işlemesine devam edilir.
	Stop Makroyu Durdur: Basic programının yürütülmesini durdurur. Bir program çalışmıyorsa bu düğme aktif değildir.
	Procedure Step Üzerine Bas : Makroyu içindeki çağrılan diğer sub ve fonksiyonlarda durmaksızın çalıştırır. Makro uygulaması Sub'daki alt ifadede  durur. Uygulama basic programı başlatılmaksızın çalıştırılmışsa bu düğmeyleşuandaki modülün ilk Sub'ındaki ilk ifadede durur.
	Single Step İçine Bas : Bir Basic ifadesini yürütür. İfadede  bir başka sub çağrılımmışsa, yürütme çağrılan sub'ın ilk ifadesinde durur. Herhangi bir sub veya fonksiyon çağrılmıyorsa Step over ile aynı işleve sahiptir.(kısa yol F8).
	Step back Dışına Bas : içinde bulunulan Sub veya fonksiyonu yürütür ve çağıran Sub/fonksiyonun devam eden ifadesinde durur. Şayet hiç bir yerden çağrılmamışsa ya da Basic programı çalışmıyorsa Run düğmesiyle aynı etkiye sahiptir.
	Breakpoint Kesme noktası Açık/Kapalı : Basic düzenleyici penceresinde İmlecin bulunduğu satırda kesme oluşturur veya kaldırır.Kesme noktası bu satırda oluşturulamıyorsa beep ile kullanıcı ikaz edilir eylem ihmal edilir. (Kısayol F9).Kesme noktası editör penceresindeki sol sütunda  kırmızı bir nokta olarak görüntülenir.
	Add watch İzleyici açık/kapalı   : Basic editorde İmlecin üzerinde olduğu tanımlayıcıyı watch penceresine ekler (Kısayol F7.
	Object Catalog Nesne Kataloğu : Nesneler iletişimini açar. Dialogları,modülleri ve modüllerin içersindeki Sub'ları da içeren tam bir Kütüphane hiyerarşisini görüntüler.
	Macros Makro Seç :  OpenOffice.org Basic Makrolar İletişim kutusu'nu açar
	Modules Makro Seç: Opens the OpenOffice.org Basic Makro Düzenleyici dialoğunu açar.
	Find Parentheses Parantez Bul : Basic editörde imleç bir parantez öncesine yerleştirilmişse parantez çifti aranır ve bulunduğunda parantez içinde bulunan kod seçilir. Bulunamazsa kullanıcı uyarı sesiyle ikaz edilir.
	Controls Denetim Ekle : Dialog düzenleme araçlarını açar. Basic düzenleme modunda pasiftir.
	Insert Source File BASIC kaynak kodu ekle : Dosya açma dialoğunu görüntüler ve seçilmiş olan dosyanın metnini aktif modüldeki imleç konumuna ekler (*.bas   standard dosya uzantısıdır).
	Save Source As BASIC kaydet : Aktif modülü bir metin dosyası olarak kaydetmek için Farklı kaydet iletişimini görüntüler (*.bas standard dosya uzantısıdır).

Şekil 11.19'da Bir Basic programı debugging modunda yürütülüyorken IDE penceresinin durumu görüntülenmektedir.

• Stop düğmesi etkindir.

• Satır 11'e bir kesme noktası konulmuştur. 

• Satır 12 de uygulama duraklatılmıştır. Sıradaki uygulanak Uygulama adımı sarı bir okla işaretlenmiştir. 

• Watch penceresi Value ve Hello değerlerini içermektedir ve bu değişkenlerin şu anki değerlerini görüntülemektedir. Ayrıca değişken üzerine fare okuyla gelindiğinde bu değerler yüzen kutularda görüntülenebilir.

• Çağrılar penceresi yığıtı gösterir. Uygulanmakta olan doIt Sub'ı tepede görüntülenmekte ve Main Sub'ı ikinci pozisyonda görülmektedir.

Dialog Editor Diyalog Düzenleyici

Bu kısım Diyalog düzenleyici işlevleri hakkında bilgi sağlar. Form dizaynında kullanılan kontroller açıklanmamıştır. Bu ayrıntılar için 11.5 Basic and Dialogs - Dialoglar ve kontrollerinin programlanması bölümüne bakın. IDE penceresi altındaki bir dialog sekmesinin tıklanması veya Basic Makro Düzenleyici iletişiminden bir diyalog seçilmesiyle yada yeni bir form yaratılmasıyla Dialog editör aktifleştirilir.

İlk olarak yeni bir dialog boş bir form öçerçevesi halinde görüntülenir. Sonraki şekilde uygulama Standard kütüphanesindeki Dialog2 görünmektedir. 

Dialog düzenleme modunda düğme kontrolleri aktiftir ve bu düğmeye tıklamanın sonucu şekilde görülmektedir. diyaloglar için özel araçları işeren bir araç çubuğu açılmıştır.İkon düğmeleri forma yerleştirilebilecek kontrolleri göstermektedir. Kullanıcı istediği düğmeye basar, İstenilen yer ve boyut için fareyle çerçeve çizerek kontrolü form üzerine yerleştirir.

Araç kutusundaki Aşağıdaki üç düğme kontroller için değildir: 

 

Yukarıdaki resimde ana araç çubuğundan başlığından tutularak çalışma alanına çekilen araç çubuğu penceresi görünmektedir. 

Özellikler iletişim kutusu iki sekmelidir. General Genel sekmesi özellikler listesi içerir. Değerleri kontroller tarafından gösterilmektedir.renk, enum tipler gibi çoğu özellikler bir listbox (liste kutusu) ile sayısal, metin gibi tipler edit field (Metin kutusu) kontrol edilir. fontlar, renklrer gibi daha kompleks özellikler ellipsis ( ... )düğmeleriyle açılan başka iletişim kutularıyla ayarlanır. font seçim kutusu gibi. Kullanıcı bir metin kutusu içeriğini değiştirdiği zaman değişiklikler hemen görüntülenmezler. Değişikliğin görünmesi için metin kutusu focus halinden çıkarılmalıdır.  Tab tuşuna basılarak veya alternatif olarak enter tuşuna basılabilir.

Events Olaylar sekmesi seçilmiş olan kontrol tarafından desteklenen olaylara atanmış makroları görüntüler:

Yukarıdaki örnekte, key pressed tuşa basıldı olayı için bir makro atanmıştır: Bu olay oluştuğunda uygulama Standard Basic kütüphanesi Module2'de görünen doNothing Sub'ı uygulanır. Uygulanabilen olaylar seçili kontrolün tipine bağlıdır.

Kullanıcı olay atamasını değiştirmek için ellipsis düğmelerine basarak Assign macro Makro ata aşağıda görünen diyalogunu açabilir.

Event Olay etiketli liste kutusu Özellikler penceresi olaylar sekmesi ile aynıdır. Makro ata iletişimi daima aynıdır ve sadece ellipsis düğmesiyle  seçilen olay için makro ataması yada değişimi yapılabilir.

Olaya makro atanması için, kullanıcı Assign Ata düğmesine tıklamalıdır. Böylece Macro Selector Makro Ayırıcı iletişimi görüntülenir ve kullanıcıya kütüphane hiyerarşi içinden bir makronun seçilmesi imkanı tanınır. Tamam tuşuyla seçilen makro olaya atanmış olur. Şayet olay için önceden seçilmiş olan makro varsa seçim ile değiştirilir. Herhangi bir Sub seçili değilse Bu Tamam düğmesi aktif değildir.

Diyalog bir belge içinde bulunuyorsa, Makro ayırıcı listesinde belgenin kütüphane Container'ı da görüntülenir. Diyalog uygulama kütüphanesine aitse, belge kütüphaneleri görüntülenmez.  Çünkü uygulama dilogları tarafından bir olay başlatıldığında belgenin yüklenebileceği garanti altında değildir. 

Seçilmiş olay için bir makro atanmışsa Remove Kaldır düğmesi aktiftir. düğmeye tıklayarak makro olaydan kaldırılır. Böylece olay makro bağlantısı koparılır.

The list box below the Remove button is used to select different macro languages. Currently, only OpenOffice.org Basic is available.

Tamam düğmesi iletişimi kapatır ve tüm olay atamalarını ve silmelerini gerçekleştirir. Değişimle Özellikler kutusunun olaylar sekmesinde görülür.

İptal düğmesi iletişimi kapatır ve yapılan değişiklikler gözardı edilir..

Daha önce açıklandığı gibi, eşzamanlı olarak çeşitli kontrol öğelerini seçmek mümkündür. Aşağıdaki resimde kulanıcını tarafından CommandButton1 ve CheckBox1 öğelerin seçili olduğu durum görülmektedir. Özellikler iletişiminde böyle bir seçim bazı önemli etkilere sahiptir.

Özellikler penceresi başlığı özel duruma işaret etmek için Multiselection  Çoklu Seçim yazısını gösterir. Tek seçim ile İki önemli fark karşılaştırılırsa:

• Görüntülenen özellikler bütün kontrollerin uyuştuğu özelliklerdir.Tüm kontroller aynı özelliği destekliyorsa görüntülenir. Bir özelliğin değeri tüm kontroller için aynı ise görüntülenir. Tüm seçilmiş kontroller kullanıcı tarafından değiştirilen özellikten etkilenirler. Aynı değere sahip olmayan kontrollere yeni değer uygulanır. 

• Bir  multi-selection Özellikler iletişimi tekli seçimde olduğu gibi olaylar sekmesine sahip değildir.

11.2.3  Assigning Macros to GUI Events GUI olaylarına Makro atanması

Dialog editöründe kontrol olaylarına makro atanması daha önce anlatılmıştı. Olaylara veya eylemlere makro atanması için genel bir işlevde mevcuttur. Bu işleve Araçlar - Özelleştir menüsü yoluyla açılan özelleştir iletişimi ile veya Makro iletişiminde ata düğmesine basılarak ulaşılabilir. Bu bölümde sadece makroların atanması incelenecektir. İletişim hakkında daha fazla bilgi OpenOffice.org belgelerinde bulunabilir.

Aşağıdaki sunumda Özelleştir diyaloğunun Menü sekmesi görülmektedir

Illustration 11.25

Bir makronun yeni bir menü öğesine nasıl atanacağı gösterilmektedir. Menü ve Menü içeriği listesi OpenOffice.org menü hiyerarşisi içinde gezinmek için kullanılabilir. Ekle... düğmesine basılmasıyla Add Commands Komut ekle iletişimi açılır. Kategori listesinde OpenOffice.org yerleşik fonksiyonlarını listeler ve OpenOffice.org Makroları girişini görüntüler. Bir giriş seçildiğinde bu girişteki makrolar ve komutlar sağdaki liste kutusunda görüntülenir .

Ekle düğmesine klikliyerek  iletişim seçilmiş makro veya komutu  bir menüye ekler.

Menüler sekmesindeki diğer düğmeler aşağıdaki gibidir :

• Yeni düğmesi bir üst seviye menüsü yaratır

• Menü düğmesi üst seviye menülerinin taşınması, isim değiştirimesi ve silinmesi için komutlara sahiptir.

• Modify Değiştir düğmesi altmenü ve ayırıcı eklenmesi, ve menü öğelerinin yeniden isimlendirilmesi ve silinmesi için komutlar içerir.

• Ok düğmeleri menü öğesinin yerini değiştirir. 

• Reset Başa al düğmesi varsayılan menü yapılandırmasını geri yükler.

Sonraki resimde Özelleştir diyalogunun Olaylar sekmesi görünmektedir: