Button meter


Meter=Button displays a button with normal, hover, and pressed states.

Options

General meter options

All general meter options are valid, except W and H.

General image options
All general image options are valid for ButtonImage, except ImageCrop, and ImageRotate.
ButtonImage
Path to the button image. The image should have 3 frames laid out either either horizontally or vertically (the orientation is determined by the width and height of the image). The first frame corresponds to the normal state, the second to the clicked state, and the third to the hover state.

See also: Button Images
ButtonCommand
Action to execute when the button is clicked.

Note: Similar to LeftMouseUpAction. The difference is that ButtonCommand ignores transparent pixels in the image at all times, where LeftMouseUpAction will only ignore clicks on transparent areas if there is not some other meter behind the image.

Example

[Rainmeter]
Update=1000
AccurateText=1
DynamicWindowSize=1

[Metadata]
Name=ExampleMeterButton
Author=The Rainmeter Team
Information=Example of the Button meter
License=Creative Commons Attribution-Non-Commercial-Share Alike 3.0
Version=1.0

[MeterPacman]
Meter=Button
ButtonImage=#@#Images\PacButton.png
ButtonCommand=["Notepad"]
MouseOverAction=[!SetOption MeterText Text "Mouse OVER state"][!UpdateMeter MeterText][!Redraw]
MouseLeaveAction=[!SetOption MeterText Text "Mouse OFF state"][!UpdateMeter MeterText][!Redraw]
LeftMouseDownAction=[!SetOption MeterText Text "Mouse DOWN state"][!UpdateMeter MeterText][!Redraw]

[MeterText]
Meter=String
FontSize=12
FontColor=255,255,255,255
SolidColor=47,47,47,255
Padding=5,5,5,5
AntiAlias=1
Y=10R
Text=Move mouse over button

An example skin demonstrating a Button meter.