AppListEntry AppListEntry AppListEntry AppListEntry Class

Definition

Namespace:
Windows.ApplicationModel.Core Windows.ApplicationModel.Core Windows.ApplicationModel.Core Windows.ApplicationModel.Core

Some information relates to pre-released product which may be substantially modified before it’s commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Prerelease APIs are identified by a Prerelease label.

Edit

[Contains prerelease APIs.]
Provides an app's display info such as its display name and description, and a method to launch the app.

public : sealed class AppListEntry : IAppListEntrypublic sealed class AppListEntry : IAppListEntryPublic NotInheritable Class AppListEntry Implements IAppListEntry// You can use this class in JavaScript.
Attributes
ContractVersionAttribute DualApiPartitionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Properties

AppUserModelId AppUserModelId AppUserModelId AppUserModelId

Edit

Prerelease. Gets the Application User Model ID (AUMID) for this AppListEntry.

public : PlatForm::String AppUserModelId { get; }public string AppUserModelId { get; }Public ReadOnly Property AppUserModelId As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

A string representing the app's identity.

Additional features and requirements
Device family
Windows 10 Insider Preview (introduced v10.0.16257.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

Examples

// Find and activate the desired application (if present on this machine)
using namespace Windows.Management.Deployment;


async Task<bool> RunApplicationAsync(string aumid)
{

  var packageManager = new Windows.Management.Deployment.PackageManager();

  IEnumerable<Package> packages = packageManager.FindPackagesForUserWithPackageTypes(

      null, PackageTypes.Main | PackageTypes.Optional);



  foreach (Package package in packages)

  {

    IReadOnlyList<AppListEntry> entries = await package.GetAppListEntriesAsync();

    foreach (AppListEntry entry in entries)

    {

      if (String.Equals(entry.AppUserModelId, aumid, StringComparison.OrdinalIgnoreCase))

      {

        return await entry.LaunchAsync();

      }

    }

  }

  return false;

}

Remarks

An AUMID is a persistable value that you can use to identify an application.

DisplayInfo DisplayInfo DisplayInfo DisplayInfo

Edit

Provides an app's display name, description, and logo.

public : AppDisplayInfo DisplayInfo { get; }public AppDisplayInfo DisplayInfo { get; }Public ReadOnly Property DisplayInfo As AppDisplayInfo// You can use this property in JavaScript.
Value
AppDisplayInfo AppDisplayInfo AppDisplayInfo AppDisplayInfo

An object representing the app's display name, description, and logo.

Methods

LaunchAsync() LaunchAsync() LaunchAsync() LaunchAsync()

Edit

Launches the app associated with this AppListEntry

public : IAsyncOperation<PlatForm::Boolean> LaunchAsync()public IAsyncOperation<bool> LaunchAsync()Public Function LaunchAsync() As IAsyncOperation( Of bool )// You can use this method in JavaScript.
Returns
IAsyncOperation<PlatForm::Boolean> IAsyncOperation<bool> IAsyncOperation<bool> IAsyncOperation<bool>

If the launch fails for any reason, the Boolean value is false

Remarks

The app is launched without passing parameters. It is launched in the same way as if the user clicked on the entry in the app list.