Development/Tutorials/Qt4 Ruby Tutorial/Chapter 07/fi: Difference between revisions

    From KDE TechBase
    (Created page with "Välit toteutetaan normaalilla tavalla (väli on aina Ruby-jäsenfunktio). Signaalit toteutetaan automaattisesti. Signaalit noudattavat suojattujen Ruby-funktioiden kutsumissää...")
    (Created page with "'''<tt>valueChanged()</tt>'''-signaalia käytetään kun '''<tt>LCDRange's</tt>'''-arvo on muuttunut.")
    Line 45: Line 45:
    Välit toteutetaan normaalilla tavalla (väli on aina Ruby-jäsenfunktio). Signaalit toteutetaan automaattisesti. Signaalit noudattavat suojattujen Ruby-funktioiden kutsumissääntöjä (ts. vain ne luokat voivat lähettää, jotka on määritelty niissä luokissa, mistä se periytyy).
    Välit toteutetaan normaalilla tavalla (väli on aina Ruby-jäsenfunktio). Signaalit toteutetaan automaattisesti. Signaalit noudattavat suojattujen Ruby-funktioiden kutsumissääntöjä (ts. vain ne luokat voivat lähettää, jotka on määritelty niissä luokissa, mistä se periytyy).


    The '''<tt>valueChanged()</tt>''' signal is used when the '''<tt>LCDRange's</tt>''' value has changed.
    '''<tt>valueChanged()</tt>'''-signaalia käytetään kun '''<tt>LCDRange's</tt>'''-arvo on muuttunut.


    The implementation of '''<tt>value()</tt>''' is straightforward. It simply returns the slider's value.
    The implementation of '''<tt>value()</tt>''' is straightforward. It simply returns the slider's value.

    Revision as of 12:04, 26 September 2011

    Other languages:


    Development/Tutorials/Qt4 Ruby Tutorial/Chapter 07


    Yksi asia johtaa toiseen
    Tutorial Series   Qt4 Ruby -oppikurssi
    Previous   Oppikurssi 6 - Rakennetaan Blocks Galore!
    What's Next   Oppikurssi 8 - Valmistaudutaan taisteluun
    Further Reading   n/a

    Yksi asia johtaa toiseen

    Tiedostot:

    Yleistä

    Tässä esimerkissä näytämme, kuinka räätälöityjä käyttöliittymäkomponentteja luodaan signaaleilla ja väleillä, ja kuinka yhdistää ne toisiinsa mutkikkaamilla tavoilla. Ensimmäisen kerran lähdekoodi on jaettu useisiin tiedostoihin.

    Läpikäynti rivi riviltä

    lcdrange.rb

    Tämä tiedosto on pääasiassa nostettu Kappaleesta 6; vain tärkeimmät muutokset on mainittu täällä.

    signals 'valueChanged(int)'
    slots 'setValue(int)'
    
    def value()
      @slider.value()
    end
    
    def setValue(value)
      @slider.setValue(value)
    end
    

    Nämä tekevät rajapinnan tämän käyttöliittymäkomponentin ja ohjelman muiden komponenttien välillä. Tähän asti LCDRange-komponentilla ei ollut todella API-sovellusrajapintaa ollenkaan.

    value() on julkinen funktio jolla pääsee käsiksi LCDRange-arvoon, setValue() on ensimmäinen räätälöity välimme, ja valueChanged() on ensimmäinen räätälöity signaalimme.

    Välit toteutetaan normaalilla tavalla (väli on aina Ruby-jäsenfunktio). Signaalit toteutetaan automaattisesti. Signaalit noudattavat suojattujen Ruby-funktioiden kutsumissääntöjä (ts. vain ne luokat voivat lähettää, jotka on määritelty niissä luokissa, mistä se periytyy).

    valueChanged()-signaalia käytetään kun LCDRange's-arvo on muuttunut.

    The implementation of value() is straightforward. It simply returns the slider's value.

    The implementation of setValue() is equally straightforward. Note that because the slider and LCD number are connected, setting the slider's value automatically updates the LCD number as well. In addition, the slider will automatically adjust the value if it is outside its legal range.

    connect(@slider, SIGNAL('valueChanged(int)'),
            lcd, SLOT('display(int)'))
    connect(@slider, SIGNAL('valueChanged(int)'),
            self, SIGNAL('valueChanged(int)'))
    

    The first QObject::connect() call is the same that you have seen in the previous chapter. The second is new; it connects slider's QAbstractSlider::valueChanged() signal to this object's valueChanged() signal. Yes, that's right. Signals can be connected to other signals. When the first is emitted, the second signal is also emitted.

    Let's look at what happens when the user operates the slider. The slider sees that its value has changed and emits the QAbstractSlider::valueChanged() signal. That signal is connected both to the QLCDNumber::display() slot of the Qt::LCDNumber and to the valueChanged() signal of the LCDRange.

    Thus, when the signal is emitted, LCDRange emits its own valueChanged() signal. In addition, QLCDNumber::display() is called and shows the new number.

    Note that you're not guaranteed any particular order of execution; LCDRange::valueChanged() may be emitted before or after QLCDNumber::display() is called.

    t7.rb

    previousRange = nil
    
    for row in 0..2
      for column in 0..2
        lcdRange = LCDRange.new()
        grid.addWidget(lcdRange, row, column)
        unless previousRange.nil?
          connect(lcdRange, SIGNAL('valueChanged(int)'),
                  previousRange, SLOT('setValue(int)'))
        end
        previousRange = lcdRange
      end
    end
    

    When we create the nine LCDRange objects, we connect them using the signals and slots mechanism. Each has its valueChanged() signal connected to the previous one's setValue() slot. Because LCDRange emits the valueChanged() signal when its value changes, we are here creating a chain of signals and slots.

    Running the Application

    On startup, the program's appearance is identical to the previous one. Try operating the slider to the bottom-right.

    Exercises

    Use the bottom-right slider to set all LCDs to 50. Then set all but the last LCD to 40 by clicking once to the left of the bottom-middle slider handle. Now, use the bottom-left slider to set the first seven LCDs back to 50.

    Click to the left of the handle on the bottom-right slider. What happens? Why is this the correct behavior?