pebble-ui-dialog-window

UIDialogWindow

A library to create and customize simple dialog windows for Pebble watchapps.

Behavior

UIDialogWindows are pre-configured, customizable dialog windows that developers can create and use in their Pebble watchapps.

By default, the dialog window has the following properties and behavior:

• Default Background Color: GColorClear
• Default Font Color: GColorBlack
• Default Font: FONT_KEY_GOTHIC_24_BOLD
• back button will close the window

Installation

pebble package install pebble-ui-dialog-window

Sample Usage

#include <pebble.h>
#include "pebble-ui-dialog-window/pebble-ui-dialog-window.h"

UIDialogWindow* dialog;
char* dialog_message = "Battery is low! Connect Pebble to charging cable.";
GBitmap* dialog_icon = NULL;

static void init() {
  dialog_icon = gbitmap_create_with_resource(RESOURCE_ID_WARNING);
  dialog = ui_dialog_window_create(dialog_message, dialog_icon);
  ui_dialog_window_set_background_color(dialog, GColorYellow);

  Window* window = ui_dialog_window_get_window(dialog);
  window_stack_push(window, true);
}

static void deinit() {
  gbitmap_destroy(dialog_icon);
  if (dialog) ui_dialog_window_destroy(dialog);
}

int main(void) {
  init();
  app_event_loop();
  deinit();
}

Documentation

UIDialogWindow* ui_dialog_window_create(char* message, GBitmap* icon);

Creates a new UIDialogWindow object that can be used to display and customize a dialog window.

NOTE: The UIDialogWindow does not make copies of message and icon parameters, so the developer must ensure the objects persist for the lifetime of the dialog window.

void ui_dialog_window_destroy(UIDialogWindow* this);

Frees all memory associated with the UIDialogWindow object.

NOTE: ui_dialog_window_destroy will not free the memory associated with the message or icon parameters passed into ui_dialog_window_create.

Window* ui_dialog_window_get_window(UIDialogWindow* this);

Returns a Window object that can be pushed onto the WindowStack or manipulated in other ways (such as assigning ClickHandlers with window_set_click_config_provider.

void ui_dialog_window_set_background_color(UIDialogWindow* this, const GColor color);

Sets the UIDialogWindow's background color.

void ui_dialog_window_set_label_color(UIDialogWindow* this, const GColor color);

Set's the font color of the UIDialogWindow's label.

void ui_dialog_window_set_label_font(UIDialogWindow* this, const GFont font);

Set's the font of the UIDialogWindow's label.

void ui_dialog_window_set_label_alignment(UIDialogWindow* this, const GTextAlignment align);

Set's the alignment of the UIDialogWindow's label. By default, the alignment is set to GTextAlignmentLeft for rectangular displays, and GTextAlignmentCenter for circular screens.

void ui_dialog_window_set_label_text(UIDialogWindow* this, char* message);

Set's the text of the UIDialogWindow's label.

GAlign ui_dialog_window_set_icon_alignment(UIDialogWindow* this, const GAlign align);

Set's the alignment of the UIDialogWindow's icon. By default, the alignment is set to GAlignmentLeft for rectangular displays, and GAlignmentCenter for circular screens and returns the set alignment.

If you try to set any alignment other than GAlignLeft, GAlignCenter, or GAlignRight the method will pick the closest match.

void ui_dialog_window_set_icon(UIDialogWindow* this, GBitmap* icon);

Set's the image of the UIDialogWindow's icon.

License

This library is licensed under the MIT license.