Delphi, C++Builder ve .NET sgcUI'nin parçası

Toast Bildirimleri, Gelen Kutusu ve Rozetler İçeren Bir Delphi Bildirim Bileşeni

sgcUI'nin parçası olan sgcNavigation, VCL ve FireMonkey uygulamalarına tek bir bildirim modeliyle yönetilen bir Delphi bildirim bileşen kümesi getirir.

Toast bildirimleri
Güne göre gruplanmış gelen kutusu
Okunmamış rozeti
WebSocket, MQTT veya SSE üzerinden canlı gönderim
VCLFireMonkeyC++BuilderWinForms, WPF, Avalonia

Koda bakın →

Koyu temada bir VCL uygulamasında Delphi bildirim bileşeni: 6 okunmamışlı bildirim gelen kutusu, uygulama içi, açılır pencere, e-posta ve anlık bildirim için kategori başına tercihler, bir etkinlik akışı ve bir ekip listesi

Bildirim Bileşenleri

Model hiçbir şey çizmez ve çatıdan bağımsızdır; böylece tek bir model aynı uygulamanın VCL ve FireMonkey görünümlerini besler.

Tek bir bildirim modeli toast bildirimlerini, güne göre gruplanmış bir bildirim gelen kutusunu, bir okunmamış rozetini ve kategori başına tercihleri yönetir; bir sunucu da yeni bildirimleri WebSocket, MQTT veya sunucu tarafından gönderilen olaylar üzerinden canlı olarak gönderebilir.

BileşenBirimRol
TsgcNotificationModelsgcNavigation_NotificationGörsel değil. Bildirimleri tutar, okunmamışları sayar, okundu olarak işaretler, kapatır ve JSON olarak kaydeder.
TsgcVCLToastManager, TsgcFMXToastManagersgcNavigation_Toast_VCL, sgcNavigation_Toast_FMXGörsel değil. Modelin her yeni okunmamış bildirimi için bir toast bildirimi gösterir ve koddan bağımsız toast bildirimleri gösterir.
TsgcVCLNotificationInbox, TsgcFMXNotificationInboxsgcNavigation_Inbox_VCL, sgcNavigation_Inbox_FMXBildirimleri güne göre listeleyen, All ve Unread sekmeleri ile Mark all as read düğmesi olan bir denetim.
TsgcNotificationPreferencessgcNavigation_NotifyPrefsGörsel değil. Kullanıcının her kategori için istediği kanallar (uygulama içi, açılır pencere, e-posta, anlık bildirim).
TsgcVCLNotificationPrefsEditor, TsgcFMXNotificationPrefsEditorsgcNavigation_NotifyPrefs_VCL, sgcNavigation_NotifyPrefs_FMXTercihleri, kategori başına bir satır olacak şekilde bir onay kutusu tablosu olarak gösteren bir denetim.
TsgcToolbarBadgeLinksgcToolbar_BadgeLinkGörsel değil, sgcToolbar içinde. Modelin okunmamış sayısını bir araç çubuğu veya şerit öğesinin rozeti olarak gösterir, 99 üzerinde 99+.
TsgcUILiveSource_WebSocket, TsgcUILiveSource_MQTT, TsgcUILiveSource_SSEsgcUICoreWS köprüsüBir sunucunun bir sgcWebSockets bağlantısı üzerinden gönderdiği JSON iletilerini modele iletin (Registered sürümü).

Bir Delphi Uygulamasında Toast Bildirimleri Gösterin

Toast bildirimi, formun veya ekranın bir köşesinde beliren, geri sayım yapan ve kendiliğinden kapanan kısa bir karttır.

Bir toast bildiriminde bir önem simgesi veya görsel, bir başlık, en fazla üç satırlık bir gövde, bir kapat düğmesi ve en fazla iki eylem düğmesi bulunur. Toast yöneticisi, formdaki görsel olmayan bir bileşendir: toast bildirimlerini üst üste dizer, geri sayımlarını yapar, işaretçinin altında duraklatır, soldurarak açar ve kapatır ve sığmayanları kuyruğa alır.

  • Position köşeyi veya kenarı seçer, varsayılan olarak tpsBottomRight, ve VCL yöneticisinin Anchor özelliği toast bildirimlerini formda ya da ekranın çalışma alanında dizer.
  • Duration varsayılan olarak 5000 ms'dir ve StickySeverities, hataları kullanıcı kapatana kadar ekranda tutar.
  • MaxVisible (3) ekrandaki toast bildirimlerini sınırlar; sonrakiler bir kuyrukta bekler.
  • Bir toast bildirimi hiçbir zaman bir pencereyi etkinleştirmez ve odağı almaz; kullanıcı yazmaya devam eder. Bir ekran okuyucu her yeni toast bildirimini okur.
Delphi VCL, bir toast yöneticisi ve bağımsız bir toast bildirimi
uses
  Classes, SysUtils, Forms,
  sgcNavigation_Notification, sgcNavigation_Toast, sgcNavigation_Toast_VCL;

procedure TMainForm.FormCreate(Sender: TObject);
begin
  FToasts := TsgcVCLToastManager.Create(Self);
  // the bottom right corner of the form, two toasts at a time
  FToasts.Anchor := tanForm;
  FToasts.Position := tpsBottomRight;
  FToasts.MaxVisible := 2;
  // warnings and errors stay until the user closes them
  FToasts.StickySeverities := [nsvWarning, nsvError];
end;

procedure TMainForm.ExportFinished(aRows: Integer);
begin
  FToasts.Show('Export finished', IntToStr(aRows) + ' rows written.',
    nsvSuccess);
end;

FireMonkey'de TsgcFMXToastManager, Anchor dışında aynı özelliklere sahiptir. Toast bildirimleri formun içindeki bir kaplamada yaşar; bu, Windows, macOS, Linux, iOS ve Android'de çalışır.

Toast yardım konusunu okuyun

Okunmamış Rozetli Bir Bildirim Gelen Kutusu

Model bir kullanıcının bildirimlerini tutar; toast bildirimleri, gelen kutusu ve rozet başka kod olmadan onu izler.

Bir bildirimin bir Id'si, bir başlığı, düz metin bir gövdesi, bir önem düzeyi (info, success, warning veya error), bir UTC saati, bir okunma durumu, bir kategorisi, onu oluşturan kaynak ve eylem düğmeleri vardır. Add yeni bir okunmamış bildirim ekler. Post, Id'ye göre bir upsert işlemidir; böylece bir siparişin, bir derlemenin veya bir biletin anahtarı ikinci bir bildirim eklemek yerine tek bir bildirimi güncel tutar. MarkRead, MarkAllRead ve Dismiss durumu değiştirir, SaveToFile ve LoadFromFile ise bildirimleri oturumlar arasında JSON olarak saklar.

  • Gelen kutusu: güne göre gruplanmış bildirimler, tümü veya yalnızca okunmamışlar, Mark all as read ile.
  • Okunmamış rozeti: TsgcToolbarBadgeLink okunmamış sayısını bir araç çubuğu düğmesinde, Registered sürümünde ise bir şerit düğmesinde gösterir.
  • Tercihler: kategori başına bir satır ve kanal başına bir sütun. Bir kategorinin açılır pencere kanalını kapatmak toast bildirimlerini durdurur, gelen kutusu yine de onları listeler.
  • Eylemler: bir toast bildiriminde veya gelen kutusunda bir eylem düğmesine tıklamak, modelin OnAction olayını eylemin kimliğiyle tetikler.
Delphi VCL, bildirim merkezinin tamamı
uses
  Classes, SysUtils, Controls, Forms,
  sgcNavigation_Notification, sgcNavigation_NotifyPrefs,
  sgcNavigation_Toast_VCL, sgcNavigation_Inbox_VCL,
  sgcToolbar_VCL, sgcToolbar_BadgeLink;

procedure TMainForm.SetupNotifications(aToolbar: TsgcVCLToolbar);
var
  vFile: string;
begin
  // the notifications of the user, kept between sessions
  FModel := TsgcNotificationModel.Create(Self);
  vFile := ExtractFilePath(Application.ExeName) + 'notifications.json';
  if FileExists(vFile) then
    FModel.LoadFromFile(vFile);
  FModel.OnAction := ModelAction;

  // orders pop up, news only go to the inbox
  FPrefs := TsgcNotificationPreferences.Create(Self);
  FPrefs.Categories.Add('orders', 'Orders');
  FPrefs.Categories.Add('news', 'News').Defaults := [nchInApp];

  // a toast for every new unread notification its category allows
  FToasts := TsgcVCLToastManager.Create(Self);
  FToasts.Preferences := FPrefs;
  FToasts.Model := FModel;

  // every notification, newest first, under a header per day
  FInbox := TsgcVCLNotificationInbox.Create(Self);
  FInbox.Parent := Self;
  FInbox.Align := alRight;
  FInbox.Width := 360;
  FInbox.Model := FModel;

  // the unread count as the badge of the first toolbar button
  FBadge := TsgcToolbarBadgeLink.Create(Self);
  FBadge.Source := FModel;
  FBadge.Target := aToolbar;
  FBadge.ItemIndex := 0;
end;

procedure TMainForm.OrderShipped(const aOrderId: string);
var
  oItem: TsgcNotificationItem;
begin
  FModel.BeginUpdate;
  try
    // an upsert: the same id updates the notification
    oItem := FModel.Post('order-' + aOrderId, 'Order ' + aOrderId +
      ' shipped', 'The parcel left the warehouse.', nsvSuccess, 'orders');
    if oItem.Actions.IndexOf('track') < 0 then
      oItem.Actions.Add('track', 'Track');
  finally
    FModel.EndUpdate;
  end;
end;

BeginUpdate ile EndUpdate arasında yapılan değişiklikler görünümlere bir kez ulaşır; böylece toast bildirimi bitmiş bildirimi düğmeleriyle gösterir. Model ana iş parçacığından kullanılır.

Bildirimler yardım konusunu okuyun

Bir Sunucudan WebSocket, MQTT veya SSE ile Anlık Bildirimler

Bir sunucu, bir kullanıcının bildirimlerini, ileti başına bir JSON nesnesi olacak şekilde canlı iletilerle güncel tutar.

ApplyMessage bir iletiyi modele uygular: add, update, remove, read, unread veya snapshot. Toast bildirimleri, gelen kutusu ve rozet modeli izler; böylece sunucudan gelen bir ileti başka kod olmadan ekranda görünür. ApplyMessage hiçbir zaman hata fırlatmaz; bir ileti kendisine ait değilse False döndürür ve modeli değiştirmeden bırakır.

messages.json
{"type":"notification","op":"add","notification":{"id":"n2","title":"Build 812 passed","severity":"success","group":"ci"}}
{"type":"notification","op":"update","notification":{"id":"n2","body":"All 1,204 tests passed"}}
{"type":"notification","op":"read","ids":["n1","n2"]}
{"type":"notification","op":"remove","id":"n1"}

sgcUICoreWS köprüsünün canlı kaynakları bir sgcWebSockets istemcisinin iletilerini alıp modele iletir: bir TsgcWebSocketClient için TsgcUILiveSource_WebSocket, bir TsgcWSPClient_MQTT için TsgcUILiveSource_MQTT ve bir TsgcHTTP1Client'ın sunucu tarafından gönderilen olayları için TsgcUILiveSource_SSE. Bir soket iş parçacığında gelen iletiler kuyruğa alınır ve ana iş parçacığında uygulanır.

Delphi, bir WebSocket kanalından bildirimler
uses
  Classes, SysUtils,
  sgcWebSocket, sgcUICoreWS_Live, sgcUICoreWS_Live_WebSocket,
  sgcNavigation_Notification;

function BindNotifications(aOwner: TComponent; aClient: TsgcWebSocketClient;
  aModel: TsgcNotificationModel): TsgcUILiveSource_WebSocket;
var
  oBinding: TsgcUILiveBinding;
begin
  Result := TsgcUILiveSource_WebSocket.Create(aOwner);
  Result.Client := aClient;
  oBinding := Result.Bindings.Add;
  oBinding.Target := aModel;
  // only the frames of the alerts channel, the live message is in "data":
  // {"channel":"alerts","data":{"type":"notification","op":"add",...}}
  oBinding.FilterPath := 'channel';
  oBinding.FilterValue := 'alerts';
  oBinding.MessagePath := 'data';
end;
  • Kaynak hiçbir zaman bağlanmaz, abone olmaz veya göndermez. URL, kimlik bilgileri, TLS ve yeniden bağlanma istemciye aittir.
  • Köprü yalnızca gelen yönlüdür. Kullanıcı bir bildirimi okuduğunda veya kapattığında, modelin OnNotification ve OnAction olaylarını işleyin ve aynı istemci üzerinden kendi çerçevenizi gönderin.

Canlı iletiler ve canlı kaynaklar Registered sürümünün parçasıdır ve canlı kaynaklar sgcWebSockets gerektirir. Sunucu yoksa uygulama, modelin Add ve Post metotlarını çağırır.

Bildirim Canlı İletileri yardım konusunu okuyun

VCL, FireMonkey, C++Builder ve .NET

VCL ile Delphi 7'den Delphi 13'e, Delphi XE6'dan itibaren FireMonkey, C++Builder ve .NET WinForms, WPF ve Avalonia.

Koyu temada, bildirim gelen kutusu ve okunmamış rozetiyle Delphi FireMonkey için Realtime demosu

Tek model, her ön yüz

  • VCL: TsgcVCLToastManager, TsgcVCLNotificationInbox ve TsgcVCLNotificationPrefsEditor
  • FireMonkey: TsgcFMXToastManager, TsgcFMXNotificationInbox ve TsgcFMXNotificationPrefsEditor
  • C++Builder: aynı bileşenler, yardımda C++ örnekleriyle
  • .NET: gelen kutusu ve tercih düzenleyicisiyle TsgcWinFormsToastManager, TsgcWpfToastManager ve TsgcAvaloniaToastManager

sgcUI paketinin Realtime demosu; VCL, FireMonkey, C++Builder ve .NET'te, rozeti okunmamış sayısı olan bir zil ve tercihlerin üstünde bildirim gelen kutusu içeren bir operasyon konsolu oluşturur. Bkz. Realtime arayüz paketi.

Community ve Registered

Bildirim bileşenleri ürünlerinin, sgcNavigation'ın, sürümünü izler ve rozet bağlantısı sgcToolbar'ı izler.

ParçaÜrün.NET CommunityRegistered
Bildirim modeli, toast bildirimleri, gelen kutusu ve tercihlersgcNavigationEvetEvet
Araç çubuğuyla rozet bağlantısısgcToolbarEvetEvet
Şeritle rozet bağlantısısgcToolbarNoEvet
Canlı bildirim iletilerisgcNavigationNoEvet
WebSocket, MQTT ve SSE üzerinden canlı kaynaklar (sgcWebSockets gerektirir)sgcUICoreNoEvet

Delphi ve C++Builder'da bildirim bileşenleri sgcUI Standard, Professional, Enterprise, All-Access ve Trial ile, ayrıca tek başına satılan sgcNavigation ve sgcToolbar ile gelir. Ücretsiz .NET Community paketleri de bunları içerir. Delphi Community sürümü yalnızca sgcGrid sunar. Bkz. sgcUI fiyatlandırması.

Sıkça Sorulan Sorular

Forma bir TsgcVCLToastManager ya da FireMonkey'de bir TsgcFMXToastManager koyun ve bir başlık, bir gövde ve bir önem düzeyiyle Show çağırın. Toast bildirimi seçtiğiniz köşede belirir, varsayılan olarak beş saniye geri sayar, işaretçi üzerindeyken duraklar ve hiçbir zaman odağı almaz. Model'i ayarlanmışsa yönetici, her yeni okunmamış bildirim için de bir toast bildirimi gösterir.

Bir TsgcNotificationModel oluşturun ve bildirimleri güne göre All ve Unread sekmeleri ve Mark all as read düğmesiyle listeleyen bir TsgcVCLNotificationInbox'ın Model'i olarak ayarlayın. Ardından modeli, Target'ı bir araç çubuğu olan bir TsgcToolbarBadgeLink'in Source'u olarak ayarlayın: okunmamış sayısı düğmede, 99 üzerinde 99+ olarak görünür.

Evet, Registered sürümünde. Sunucu her değişiklik için bir JSON iletisi gönderir ve ApplyMessage onu modele uygular. sgcUICoreWS köprüsünün canlı kaynakları bu iletileri sgcWebSockets'in bir WebSocket, MQTT veya sunucu tarafından gönderilen olaylar istemcisinden okur ve ana iş parçacığında uygular; böylece toast bildirimleri, gelen kutusu ve rozet başka kod olmadan güncellenir.

Evet. TsgcFMXToastManager, TsgcFMXNotificationInbox ve TsgcFMXNotificationPrefsEditor Delphi XE6'dan itibaren çalışır. FireMonkey toast bildirimleri formun içindeki bir kaplamada yaşar; Windows, macOS, Linux, iOS ve Android'de. Model çatıdan bağımsızdır, bu nedenle aynı TsgcNotificationModel VCL ve FireMonkey görünümlerini besler.

Evet. TsgcNotificationPreferences, kullanıcının her kategori için istediği kanalları tutar: uygulama içi, açılır pencere, e-posta ve anlık bildirim. Tercih düzenleyicisi bunları bir onay kutusu tablosu olarak gösterir. Preferences'ı ayarlanmış bir toast yöneticisi, açılır pencere kanalı kapalı bir kategori için toast bildirimi göstermez; gelen kutusu ise bu bildirimleri yine listeler.

Evet, onları kaydettiğinizde. Modelin SaveToFile ve LoadFromFile metotları bildirimleri oturumlar arasında bir JSON dosyası olarak saklar ve MaxCount (varsayılan 500) modeli sınırlar; önce en eski okunmuş bildirimleri bırakır.

Ücretsiz .NET Community paketleri modeli, toast bildirimlerini, gelen kutusunu ve tercihleri içerir. Delphi Community sürümü yalnızca sgcGrid sunar; bu nedenle Delphi ve C++Builder'da bildirim bileşenleri, tek başına ya da sgcUI Standard ve üzerinde satılan sgcNavigation ile gelir. All-Access deneme sürümü, değerlendirme için her sgcUI ürününü içerir.

En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

Delphi Uygulamanıza Bildirimler Ekleyin

sgcUI deneme sürümünü indirin ve toast bildirimlerini, gelen kutusunu ve rozeti kendi IDE'nizde deneyin.