Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-26022

Misleading documentation for QML BorderImage Element

    XMLWordPrintable

Details

    • Bug
    • Resolution: Done
    • P3: Somewhat important
    • 5.0.0
    • 4.8.2
    • None
    • Linux x86_64 x86_64 x86_64
      Qt Creator 2.4.1 (from source)
      Qt 4.8.2 (from source)
    • I41b7571b42a0fb9bd2cfab8ce2e76e57addabefd

    Description

      QML BorderElement documentation, under "source" property, says "This property can also be used to refer to .sci files, which are written in a QML-specific, text-based format that specifies the borders, the image file and the tile rules for a given border image." There is no other documentation for the *.sci format.

      The above quote suggests that one can specify the tile rules in the *.sci file, using the element properties of horizontalTileMode and verticalTileMode. This is incorrect, and those properties names do not work in *.sci files. After rooting around in the private QDeclarativeScaleGrid.cpp file, I discovered that the names were hardcoded in as horizontalTileRule and verticalTileRule.

      This is very misleading and unintuitive. The end user developer should not have to examine Qt's private internal implementation files to discover what property names are valid for *.sci files.

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            bodson Yann Bodson (Inactive)
            brandybuck David Johnson
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes