Cairo.Status (gb.cairo)

Checks whether an error has previously occurred, by returning the state of the current drawing.

Cairo uses a single status type to represent all kinds of errors. A status value of Cairo.StatusSuccess represents no error and has an integer value of zero. All other status values represent an error.

Cairo's error handling is designed to be easy to use and safe. All major cairo objects retain an error status internally which can be queried anytime by the users using this property. In the mean time, it is safe to call all cairo functions normally even if the underlying object is in an error status. This means that no error handling code is required before or after each individual cairo function call.

This property can take one of the following values:

• StatusClipNotRepresentable

• StatusFileNotFound

• StatusFontTypeMismatch

• StatusInvalidClusters

• StatusInvalidContent

• StatusInvalidDash

• StatusInvalidDscComment

• StatusInvalidFormat

• StatusInvalidIndex

• StatusInvalidMatrix

• StatusInvalidPathData

• StatusInvalidPopGroup

• StatusInvalidRestore

• StatusInvalidSlant

• StatusInvalidStatus

• StatusInvalidStride

• StatusInvalidString

• StatusInvalidVisual

• StatusInvalidWeight

• StatusNegativeCount

• StatusNoCurrentPoint

• StatusNoMemory

• StatusNullPointer

• StatusPatternTypeMismatch

• StatusReadError

• StatusSuccess

• StatusSurfaceFinished

• StatusSurfaceTypeMismatch

• StatusTempFileError

• StatusUserFontError

• StatusUserFontImmutable

• StatusWriteError