{"id":79,"date":"2026-02-23T17:26:53","date_gmt":"2026-02-23T09:26:53","guid":{"rendered":"https:\/\/xlwings.net\/blog\/?p=79"},"modified":"2026-01-17T10:30:54","modified_gmt":"2026-01-17T10:30:54","slug":"how-to-set-face-properties-using-xlwings-single-color-gradient-fill","status":"publish","type":"post","link":"https:\/\/xlwings.net\/blog\/how-to-set-face-properties-using-xlwings-single-color-gradient-fill\/","title":{"rendered":"How To Set Face Properties Using xlwings? – Single Color Gradient Fill"},"content":{"rendered":"

Method<\/h2>\n

Use the `OneColorGradient` method of the `FillFormat` object for single-color gradient fills. A single-color gradient fill involves a variation of a single color’s intensity.<\/p>\n

\u00a0<\/p>\n

ff.OneColorGradient(Style, Variant, Degree)<\/p>\n

\u00a0<\/p>\n\n\n\n\n\n\n
\n

Name<\/p>\n<\/td>\n

\n

Required\/Optional<\/p>\n<\/td>\n

\n

Data Type<\/p>\n<\/td>\n

\n

Description<\/p>\n<\/td>\n<\/tr>\n

\n

Style<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

MsoGradientStyle<\/p>\n<\/td>\n

\n

Gradient style<\/p>\n<\/td>\n<\/tr>\n

\n

Variant<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

Integer<\/p>\n<\/td>\n

\n

Gradient variant (1 to 4)<\/p>\n<\/td>\n<\/tr>\n

\n

Degree<\/p>\n<\/td>\n

\n

Required<\/p>\n<\/td>\n

\n

Single<\/p>\n<\/td>\n

\n

Degree of gradient (0.0 – dark to 1.0 – light)<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\u00a0<\/p>\n

shp1=sht.api.Shapes.AddShape(1, 100, 50, 200, 100)\u00a0\u00a0\u00a0 #Rectangular area<\/p>\n

ff1=shp1.Fill<\/p>\n

ff1.ForeColor.RGB= xw.utils.rgb_to_int((255,0,0))<\/p>\n

#Solid gradient fill, white to red, gradient from bottom-right to top-left<\/p>\n

ff1.OneColorGradient(3, 1, 1)<\/p>\n

Sample Code<\/h2>\n\n\n
#Area properties - Two Color Gradient fill\n\nimport xlwings as xw    #Import xlwings package\n\napp=xw.App()\nbk=app.books.active   #Get the active workbook\nsht=bk.sheets.active    #Get the active worksheet\n\nshp1=sht.api.Shapes.AddShape(1, 100, 50, 200, 100)    #Rectangular area\nff1=shp1.Fill\nff1.ForeColor.RGB= xw.utils.rgb_to_int((255,0,0))    #Start color\nff1.TwoColorGradient(3, 1)    #Two-color gradient fill\nff1.BackColor.RGB= xw.utils.rgb_to_int((0, 255,0))    #End color\n\nshp2=sht.api.Shapes.AddShape(9, 400, 50, 200, 100)    #Elliptical area\nff2=shp2.Fill\nff2.ForeColor.RGB= xw.utils.rgb_to_int((0,0,255))    #Start color\nff2.TwoColorGradient(3, 1)    #Two-color gradient fill\nff2.BackColor.RGB= xw.utils.rgb_to_int((0, 255,0))    #End color\n\n#bk.save()\n#bk.close()\n#app.kill()<\/code><\/pre>\n\n\n\n
\"Set<\/figure>\n","protected":false},"excerpt":{"rendered":"
Method<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[],"class_list":["post-79","post","type-post","status-publish","format-standard","hentry","category-xlwings-shape"],"_links":{"self":[{"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/posts\/79","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/comments?post=79"}],"version-history":[{"count":2,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/posts\/79\/revisions"}],"predecessor-version":[{"id":435,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/posts\/79\/revisions\/435"}],"wp:attachment":[{"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/media?parent=79"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/categories?post=79"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/xlwings.net\/blog\/wp-json\/wp\/v2\/tags?post=79"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}