PostItNote

Initialises a new note belonging to a window: 200 by 200 logical pixels, in the default yellow theme, on top of other windows and centred on the screen.

The note starts with sample text in its text area and status bar; set NoteText and StatusbarText.

Gets or sets the colour the thin top strip fades to, while the built-in title bar is hidden.

Used only while IsBasicTitlebarBackgroundGradient is on. Set it before the note is shown; on a note already on screen the change appears the next time the note is resized.

Gets or sets the colour at the start of the thin strip shown across the top while the built-in title bar is hidden.

Set it before the note is shown; on a note already on screen the change appears the next time the note is resized. NoteTheme overwrites it.

Gets or sets the direction of the thin top strip's gradient.

Set it before the note is shown; on a note already on screen the change appears the next time the note is resized.

Gets the window creation settings, adding the drop shadow the note casts.

Gets or sets the font of the note's text area.

The note does not dispose a font you supply, so one shared with other controls is safe to use.

Gets or sets the colour of the text in the note's text area.

Gets or sets the colour the built-in title bar fades to, at its bottom right.

Set it before the note is shown; on a note already on screen the change appears the next time the note is resized.

Gets or sets the colour at the start of the built-in title bar's gradient.

Set it before the note is shown; on a note already on screen the change appears the next time the note is resized. NoteTheme overwrites it, and TitlebarBrush replaces the gradient altogether.

Gets or sets a gradient direction for the built-in title bar.

The built-in title bar is always painted with its gradient running from the top left corner to the bottom right, whatever this is set to.

Gets or sets whether the note hides and returns with the window it was given in its constructor.

While on, minimising or hiding that window hides the note too, and restoring the window brings back the notes that were showing when it went – so a note never floats over another application. A note your code hid stays hidden. Turn it off to leave the note on screen whatever its window does.

Gets or sets how opaque the note is while another window has the focus.

A value such as 0.8 lets a deskful of notes fade back while the user works, and brings a note back to full strength as soon as it is clicked.

Gets or sets whether the note stays above the other windows on the desktop.

The same setting as Form.TopMost. Turn it off for a note holding longer text that the reader will want to put behind other windows.

Gets or sets whether the thin top strip is a gradient or a solid colour.

Setting it also applies any change to the strip's colours straight away.

Gets or sets whether the note shows its built-in text area.

Hide it to fill the note with controls of your own, such as a checklist or a date picker.

Gets or sets whether the built-in title bar is a gradient or a solid colour.

Setting it to false paints the title bar in solid DefaultTitlebarBrushStartColor – but only until the note is next resized, when the gradient returns. For a lasting solid title bar, set TitlebarBrush to a SolidBrush.

Gets or sets whether the note shows its built-in title bar, with the command icon, pin and close icon.

The text area moves up or down to fit. Setting Titlebar turns this off.

Gets or sets whether the note shows its status bar along the bottom.

Without it the text area runs down to the resize gripper.

Gets or sets the text put in the note's text area.

Setting it replaces what the text area holds. Reading it returns the value last set, not what the user has since typed in the text area.

Gets or sets the colour scheme of the note: its background and both title bars.

Setting a theme overwrites Control.BackColor, BasicTitlebarGradientStartColor, BasicTitlebarGradientEndColor, DefaultTitlebarBrushStartColor and DefaultTitlebarBrushEndColor, and replaces any TitlebarBrush. Set the theme first and adjust single colours after.

PostItNoteTheme.Custom keeps the colours as they are, for a note coloured entirely by your own settings.

Gets or sets the coloured pin shown in the middle of the built-in title bar.

The pin is decoration: it takes no clicks and is not in the tab order. Use it to tell notes apart at a glance – a colour per project, per urgency or per person. It is shown only on the built-in title bar.

Gets or sets the colour of the status bar text.

Gets or sets the line of text in the status bar along the bottom of the note.

Text too long for the bar ends in an ellipsis; give the full text in StatusbarTooltip.

Gets or sets the tool tip shown when the pointer rests on the status bar.

Handy for the full text of a status line too long to fit.

Gets or sets a title bar of your own, in place of the built-in one.

The note docks it to the top, gives it the built-in bar's height (28 logical pixels) and a transparent background, turns IsDefaultTitlebarVisible off, and lets the user drag the note by it. It does not add it to the note: add it to the note's Control.Controls yourself.

Setting null brings the built-in title bar back.

UserControl header = new UserControl();
header.Controls.Add(new Label { Text = "Order SO-1182", Dock = DockStyle.Fill, TextAlign = ContentAlignment.MiddleCenter });

note.Titlebar = header;
note.Controls.Add(header);

Gets or sets the brush that paints the built-in title bar, in place of its two-colour gradient.

A SolidBrush, TextureBrush or HatchBrush is used as it is. A LinearGradientBrush contributes only its two colours, which are drawn from the top left corner of the title bar to the bottom right.

The note does not dispose a brush you supply. Setting NoteTheme afterwards replaces it with the theme's gradient, so set the theme first.

note.NoteTheme = PostItNoteTheme.Custom;
note.TitlebarBrush = new HatchBrush(HatchStyle.WideUpwardDiagonal, Color.Goldenrod, Color.LemonChiffon);

Gets or sets the tool tip shown when the pointer rests on the built-in title bar.

Useful for saying what the note is about, or that it can be dragged.

Releases the note's brushes, fonts and tool tips, and stops following its window.

A brush or font you supplied through TitlebarBrush or DefaultInputTextBoxFont is not disposed.

Raises the Form.Activated event and brings the note to full opacity.

Raises the Control.BackColorChanged event and gives the text area the same background.

Raises the Form.Deactivate event and fades the note to InactiveOpacity.

Raises the Form.FormClosing event.

Raises the Control.MouseDoubleClick event.

Raises the Control.MouseDown event, and starts a move when the title bar strip is pressed.

Raises the Control.MouseMove event and shows the move cursor over the title bar strip.

Raises the Control.MouseUp event, and raises the right-click events of the title bar strip.

Raises the Control.Paint event after drawing the note's background, title bar and gripper.

Processes Windows messages: lays the note out when it is resized, and lets the gripper in the bottom corner resize it.

Occurs when the user clicks the close icon on the built-in title bar.

The note stays open: close it from the handler with Form.Close once its text is saved, or keep it open. Not raised while the built-in title bar is hidden.

Occurs when the user clicks the command icon at the left of the built-in title bar.

Use it to offer the note's commands – change colour, pin, delete – for example by showing a ContextMenuStrip at the pointer. Not raised while the built-in title bar is hidden.

note.PostItNoteCommandBarInvokeRequested += (s, e) => noteMenu.Show(Cursor.Position);

Occurs when the user double-clicks the thin strip shown across the top while the built-in title bar is hidden.

A natural place to bring the built-in title bar back by setting IsDefaultTitlebarVisible.

Occurs when the user right-clicks the thin strip shown across the top while the built-in title bar is hidden.

Occurs when the user double-clicks the built-in title bar with the left button.

For example, collapse the note to its thin strip by setting IsDefaultTitlebarVisible to false.

Occurs when the user right-clicks the built-in title bar.