WinList(1x)

🌸 NAME 🌸

bestie, meet WinList — an AfterStep module that shows you a whole list of your opened windows. that's it, that's the job, and it does it slayfully 💅

---

✨ CONFIGURATION OPTIONS ✨

okay so here's the whole menu of things you can tweak in your winlist file. i'm not gonna gatekeep a single one of them, we're going through every last option together 🫶

• Action 1|2|3|4|5 action — tells WinList what function should run on that window when you click a specific mouse button on top of the window's button. one option per button, ikyk 😌
• Align Left,Right,Top,Bottom — sets the align of the text label inside the WinList buttons.

See Also: Alignment flags for further details.

• AllowCollides — FIXME: add proper description here. (yep, the docs really do just say that. no cap, that's the whole lore 💀)
• BalloonBorderHilite — defines the bevel drawn around balloons — it replaces the BorderWidth setting.

See Also: Bevel flags for further details.

• BalloonCloseDelay number — sets the delay in ms between when the balloon is shown and before it disapears.
• BalloonDelay number — specifies the period in milliseconds to delay the appearance of the balloon.
• BalloonStyle MyStyle — the MyStyle used to draw the balloon. heads up: balloons could be shaped with BackPixmap 125 and 126 ✨
• BalloonTextPaddingX size — width of the border around the text in balloons.
• BalloonTextPaddingY size — height of the border around the text in balloons.
• BalloonXOffset offset — the horizontal offset (in pixels) used when displaying balloons.
• BalloonYOffset offset — the vertical offset (in pixels) used when displaying balloons.
• Balloons — turns the balloon feature on. a "balloon" is the thing that pops up showing the name of the button your pointer is resting on in the WinList. the balloon background and text are configured with the MyStyle "*WinListBalloon" 🎈
• Bevel None,Left,Right,Top, Bottom, NoOutline — defines the 3D bevel of WinList buttons.

See Also: Bevel flags for further details.

• CompositionMethod — sets the composition method used to draw WinList buttons. default is alpha-blending. valid values are in the range 130-145.
• FBevel None,Left,Right,Top, Bottom, NoOutline — defines the 3D bevel of WinList buttons for windows that are in the focused state.

See Also: Bevel flags for further details.

• FCompositionMethod — the CompositionMethod for WinList buttons representing focused windows.
• FillRowsFirst — a flag telling WinList it should add a new row when a new button is added, and only add a new column if MaxRows or max height is reached. by default WinLIst adds columns first. iconic behavior switch fr 👑
• FocusedBevel — the style used when defining the Bevel appearance for the active window.

See Also: Bevel flags for further details.

• FocusedStyle "style" — the MyStyle used for rendering window buttons for windows thar are in the focused state.
• Geometry +x+y — specifies the location of the WinList window. note that only position can be specified — the size is defined by other parameters and by how many buttons there are. so don't even try it bestie 🙈
• HSpacing — FIXME: add proper description here.
• IconAlign align[,align[,...]] — the alignment of the icon.

See Also: Look Alignment flags for further details.

• IconLocation location — determines where the icon sits in relation to the text label. numbers from 1 to 9. on a keypad 5 represents the text label, so every other number puts the icon in the same spot as that key is relative to the 5. like, location 6 = to the right of the text label. it's giving numpad energy 🔢
• IconSize WxH — setxs the size the icon should be scaled to. (not my typo, we keep the lore intact)
• MaxColWidth width — maximum width of the column. the older *WinListMaxWidth is still supported for compatibility, but depreciated.
• MaxColumns count — maximum number of columns in WinList.
• MaxRows count — maximum number of rows in WinList.
• MaxSize WxH — maximum size of the WinList. when the number of buttons grows, WinList will not grow larger than this — instead it shrinks the buttons to fit the allowed space. you can set only Width, only Height, or both. extra rows/columns could be added when max size is reached in one direction.
• MaxWidth — this is depreciated and just there for compatibility. please use MaxSize/MinSize instead. we're gently retiring her 💐
• MinColWidth width — minimum width of the column.
• MinColWidth width — minimum width of the column. (yes. twice. it's listed twice in the original and i refuse to erase her. she's part of the family now 🫶)
• MinSize WxH — minimum size of the WinList. when there are only a few buttons, WinList will not shrink smaller than this — instead it enlarges the buttons to fill the extra space. you can set only Width, only Height, or both.
• MyStyle — styles for the different WinList properties are called from the file "winlist", and the associated MyStyle definitions live in a selected Look file. fonts, foreground and background colors, gradients, pixmaps, and text styles can all be specified for WinList's components. the customization is unreal 💖

See Also: MyStyle definition for further details.

• NoBalloons — do not show Balloons in WinList.
• NoCollides — FIXME: add proper description here.
• NoCollidesSpacing — FIXME: add proper description here.
• SBevel None,Left,Right,Top, Bottom, NoOutline — defines the 3D bevel of WinList buttons for windows that are in the sticky state.

See Also: Bevel flags for further details.

• SCompositionMethod — the CompositionMethod for WinList buttons representing sticky windows.
• ScaleIconToTextHeight — if set, it will cause the icon to be scaled to the height of the text label 📏
• ShapeToContents — when Shaped extensions are available, this causes WinList to have a non-rectangular shape that wraps around the columns/rows of buttons. shaped windows, we love to see it ✨
• ShowHints — FIXME: add proper description here.

See Also: Balloon Contents flags for further details.

• ShowIcon — will make WinList show an icon next to the window name.
• Spacing pixels — based on the WinList font height, this adds the specified number of pixels above and below the displayed text. note that this will also increase the size of the icon images in WinList.
• StickyBevel — the style used when defining the Bevel appearance for Sticky windows (those windows tagged as Sticky that appear on all views and desktops).

See Also: Bevel flags for further details.

• StickyStyle — the MyStyle used for rendering window buttons for windows thar are in the sticky state.
• UBevel None,Left,Right,Top, Bottom, NoOutline — defines the 3D bevel of WinList buttons for windows that are in the unfocused state.

See Also: Bevel flags for further details.

• UCompositionMethod — the CompositionMethod for WinList buttons representing unfocused windows.
• UnfocusedBevel — the style used when defining the Bevel appearance inactive active windows.

See Also: Bevel flags for further details.

• UnfocusedStyle "style" — the MyStyle used for rendering window buttons for windows thar are in the focused state.
• UrgentStyle — FIXME: add proper description here.
• UseName 0|1|2|3|5 — tells WinList what type of name to use for displaying in the WinList label.
  • 0 - Name
  • 1 - icon
  • 2 - res_name
  • 3 - res_class
  • 5 - display only icon but no text in winlist
• UseSkipList — obey SkipWinList flags set by applications or database config.
• VSpacing — FIXME: add proper description here.

---

🦋 and like, what is it

the WinList module gives you a window list made up of buttons, each one corresponding to a window that AfterStep is managing. clicking on those buttons with any of the three mouse buttons will either do a default action, or an action you can user configure by editing the winlist file. main character module behavior, honestly 👑

---

that's the whole page babes 🎀 this tea was served up by the 3rd Berkeley Distribution, running AfterStep v.2.2.12 — go forth and configure your buttons, periodt 💜