Color.HSBHue property - Developer Area

API Documentation > CorelDRAW > X8 > Color > IVGColor

Color.HSBHue property

Gets or sets the HSB Hue value

Syntax:

Property Get HSBHue() As Long
Property Let HSBHue(ByVal Value As Long)

Remarks:

The HSBHue property assigns the Hue value for the HSB color model in CorelDRAW. Hue is the property of a color that allows us to classify it by its name. For example, blue, green, and red are all hues.

A color is an effect applied to an object that alters the object's appearance by the way it reflects light. A color model is a system that defines the number and type of colors that make up an image and that is used to organize and define colors according to a set of basic properties that can be reproduced. Black-and-white, grayscale, RGB, CMYK, and paletted are examples of popular color modes.

HSB is a color model that approximates the way the human eye perceives color. In the HSB model, color is defined by three components: hue, saturation, and brightness. Hue determines color (yellow, orange, red, etc.), brightness determines perceived intensity (lighter or darker color), and saturation determines color depth (from dull to intense). In the HSB color model, hue (H) is expressed as a degree of rotation on a circular color wheel. Saturation (S) and brightness (B) are expressed as percentages of full intensity.

Examples:

The following VBA example decreases the hue of all of the active shape objects on page by half.

Sub Test()
  Dim s As Shape
  For Each s In ActivePage.Shapes
    If s.Fill.Type = cdrUniformFill Then
      If s.Fill.UniformColor.Type <> cdrColorHSB Then
        s.Fill.UniformColor.ConvertToHSB
        s.Fill.UniformColor.HSBHue = s.Fill.UniformColor.HSBHue / 2
      End If
    End If
  Next s
End Sub

Version Information:

CorelDRAW:	X7.4, X7, X7.6, X8, 2017, 2018, 2019, 2019.2, 2020, 2021, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25
Corel DESIGNER:	X7, 2017.1, 20.1, 2019.2, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25