PriceGuide QML Type
This value type represents the price guide for a BrickLink item. More...
| Import Statement: | import BrickLink 1.0 |
Properties
- color : ColorPointer
- isNull : bool
- isValid : bool
- item : ItemPointer
- lastUpdated : date
- updateStatus : UpdateStatus
Methods
- int lots(Time time, Condition condition)
- real price(Time time, Condition condition, Price price)
- int quantity(Time time, Condition condition)
- update(bool highPriority)
Detailed Description
Each price guide of an item in the BrickLink catalog is available as a PriceGuide object.
You cannot create PriceGuide objects yourself, but you can retrieve a PriceGuide object given the item and color id via BrickLink::priceGuide().
Note: PriceGuides aren't readily available, but need to be asynchronously loaded (or even downloaded) at runtime. You need to connect to the signal BrickLink::priceGuideUpdated() to know when the data has been loaded.
The following three enumerations are used to retrieve the price guide data from this object:
Time
| Constant | Description |
|---|---|
BrickLink.Time.PastSix | The sales in the last six months. |
BrickLink.Time.Current | The items currently for sale. |
Condition
| Constant | Description |
|---|---|
BrickLink.Condition.New | Only items in new condition. |
BrickLink.Condition.Used | Only items in used condition. |
Price
| Constant | Description |
|---|---|
BrickLink.Price.Lowest | The lowest price. |
BrickLink.Price.Average | The average price. |
BrickLink.Price.WAverage | The weighted average price. |
BrickLink.Price.Highest | The highest price. |
Property Documentation
color : ColorPointer |
The BrickLink color reference this price guide is requested for as a raw C++ pointer. You can convert it to a QML Color object like this:
let color = BrickLink.color(pg.color)
isNull : bool |
Returns whether this PriceGuide is null. Since this type is a value wrapper around a C++ object, we cannot use the normal JavaScript null notation.
isValid : bool |
Returns whether this object currently holds valid price guide data.
item : ItemPointer |
The BrickLink item reference this price guide is requested for as a raw C++ pointer. You can convert it to a QML Item object like this:
let item = BrickLink.item(pg.item)
lastUpdated : date |
Holds the time stamp of the last successful update of this price guide.
updateStatus : UpdateStatus |
Returns the current update status. The available values are:
| Constant | Description |
|---|---|
BrickLink.UpdateStatus.Ok | The last picture load (or download) was successful. |
BrickLink.UpdateStatus.Loading | BrickStore is currently loading the picture from the local cache. |
BrickLink.UpdateStatus.Updating | BrickStore is currently downloading the picture from BrickLink. |
BrickLink.UpdateStatus.UpdateFailed | The last download from BrickLink failed. isValid might still be true, if there was a valid picture available before the failed update! |
Method Documentation
int lots(Time time, Condition condition) |
Returns the number of lots for sale (or lots that have been sold) given the time frame and condition. Returns 0 if no data is available. See the PriceGuide type documentation for the possible values of the Time and Condition enumerations.
real price(Time time, Condition condition, Price price) |
Returns the price of items for sale (or item that have been sold) given the time frame, condition and price type. Returns 0 if no data is available. See the PriceGuide type documentation for the possible values of the Time, Condition and Price enumerations.
int quantity(Time time, Condition condition) |
Returns the number of items for sale (or item that have been sold) given the time frame and condition. Returns 0 if no data is available. See the PriceGuide type documentation for the possible values of the Time and Condition enumerations.
update(bool highPriority = false) |
Tries to re-download the price guide from the BrickLink server. If you set highPriority to true the load/download request will be prepended to the work queue instead of appended.
© 2004-2025 Robert Griebl. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. All trademarks are property of their respective owners.