Syntax
Success = BorderSetFlags(Border, Flags)Description
Sets the style flags for a generated border object, controlling the appearance of its sides (e.g., solid, dashed, double). This command is only applicable to borders created with CreateBorder().
Parameters
Border
The handle of the generated border object.
Flags
A combination of flags specifying the border style. You can combine general
flags (applying to all sides unless overridden) with side-specific flags.
; General Styles (apply to all sides unless overridden)
#PG_Border_Solid ; Default if no style specified
#PG_Border_Double
#PG_Border_Inset
#PG_Border_Outset
#PG_Border_Groove
#PG_Border_Ridge
#PG_Border_Dot
#PG_Border_Dash
; Side-Specific Styles (override general styles for a specific side)
#PG_Border_LeftSolid, #PG_Border_LeftDouble, #PG_Border_LeftInset, #PG_Border_LeftOutset, #PG_Border_LeftGroove, #PG_Border_LeftRidge, #PG_Border_LeftDot, #PG_Border_LeftDash
#PG_Border_TopSolid, #PG_Border_TopDouble, #PG_Border_TopInset, #PG_Border_TopOutset, #PG_Border_TopGroove, #PG_Border_TopRidge, #PG_Border_TopDot, #PG_Border_TopDash
#PG_Border_RightSolid, #PG_Border_RightDouble, #PG_Border_RightInset, #PG_Border_RightOutset, #PG_Border_RightGroove, #PG_Border_RightRidge, #PG_Border_RightDot, #PG_Border_RightDash
#PG_Border_BottomSolid, #PG_Border_BottomDouble, #PG_Border_BottomInset, #PG_Border_BottomOutset, #PG_Border_BottomGroove, #PG_Border_BottomRidge, #PG_Border_BottomDot, #PG_Border_BottomDash
; Masking Control
#PG_Border_NoMask ; Disables internal mask generation (can optimize simple square borders).
#PG_Border_MaskInside ; Renders the border mask inside the border edge instead of centered on it.Return Value
Returns #True if the flags were successfully set, or #False if the border
handle is invalid or not a generated border.
Remarks
Changing the border style flags invalidates the border's internal rendering cache, potentially
triggering a regeneration of its internal border image when next drawn. The
#PG_Border_NoMask flag can improve performance for simple rectangular borders without
rounded corners, as it bypasses the need for an internal mask image.
Example
IncludeFile "ProGUI_PB.pbi"
StartProGUI()
MyBorder = CreateBorder(#PG_Border_Solid, 5)
If MyBorder
; Change style to have a dashed top and dotted bottom
NewFlags = #PG_Border_Solid | #PG_Border_TopDash | #PG_Border_BottomDot
If BorderSetFlags(MyBorder, NewFlags)
Debug "Border style flags updated."
EndIf
FreeBorder(MyBorder)
EndIf
StopProGUI()See Also
CreateBorder, BorderGetFlags, BorderSetWidth, BorderSetColor, BorderSetRadius
Supported OS
Windows, Linux