56 lines
2.6 KiB
C#
56 lines
2.6 KiB
C#
namespace KillerPDF.Features
|
|
{
|
|
/// <summary>
|
|
/// What AboutController needs from the window hosting it, beyond the shared shell services.
|
|
///
|
|
/// Every member is a value or a plain string, never a control, so the controller holds no
|
|
/// reference to a TextBlock or a Button and can be driven by a stub in a test.
|
|
///
|
|
/// KillerPDF differs from Killendar's version in one way worth knowing: several of the About
|
|
/// card's lines are built as INLINES rather than set as text - the wordmark is two differently
|
|
/// styled runs, and the tagline, version and alias each carry a hyperlink. Constructing those
|
|
/// is UI work, so it stays in the shell and the controller hands over only the strings and the
|
|
/// one boolean the shell needs to decide what to build.
|
|
/// </summary>
|
|
internal interface IAboutHost : IShellServices
|
|
{
|
|
/// <summary>Code-signing subject, or the unsigned message.</summary>
|
|
string Publisher { set; }
|
|
|
|
/// <summary>Certificate thumbprint, or "(none)".</summary>
|
|
string Thumbprint { set; }
|
|
|
|
/// <summary>SHA-256 of the running exe. Set twice: the "computing" placeholder first,
|
|
/// then the real digest once the background hash finishes.</summary>
|
|
string Sha256 { set; }
|
|
|
|
/// <summary>Release date baked in from the csproj, shown muted opposite the version.
|
|
/// Empty on an older build that predates the attribute.</summary>
|
|
string ReleaseDate { set; }
|
|
|
|
/// <summary>Builds the version line as a hyperlink through to that release tag.</summary>
|
|
void SetVersion(string version);
|
|
|
|
/// <summary>The quoted alias line. Null hides it - which is the case unless the exe is
|
|
/// signed AND the signature verifies AND the subject is Steve's, because a fork signed by
|
|
/// somebody else must not claim the alias.</summary>
|
|
void SetAlias(string? alias);
|
|
|
|
/// <summary>Whether a newer release exists, and whether the button is live while a
|
|
/// download is running.</summary>
|
|
string UpdateText { set; }
|
|
bool UpdateVisible { set; }
|
|
bool UpdateEnabled { set; }
|
|
|
|
/// <summary>Blocks a self-update while there are unsaved changes.</summary>
|
|
bool IsDirty { get; }
|
|
|
|
/// <summary>The document to reopen after the update relaunches, if any.</summary>
|
|
string? FileToReopen { get; }
|
|
|
|
/// <summary>Dismisses any other full-window overlay, then fades the About card in.
|
|
/// The overlays are mutually exclusive rather than stacking.</summary>
|
|
void ShowCard();
|
|
}
|
|
}
|