qc_get_uri_dialog :: QUARC MATLAB Functions

navigation bar

qc_get_uri_dialog

Open a dialog box to get a communications URI.

Syntax

uri = qc_get_uri_dialog(default_uri);  % Opens a URI dialog preinitialized to the given default_uri
uri = qc_get_uri_dialog;               % Opens a URI dialog

Description

Opens a dialog box that allows the user to enter a URI suitable for use with QUARC communications.

If a default_uri is specified then it is used to preinitialize the dialog box.

If the user closes the dialog without clicking OK then an empty string is returned.

Parameters

default_uri

The initial URI which will be displayed in the URI dialog.

Outputs

uri

The URI entered by the user. If the user clicks Cancel or closes the dialog without clicking OK then an empty string is returned.

Examples

uri = qc_get_uri_dialog('shmem://foobar:1'); % Get a URI from the user. The initial URI will be "shmem://foobar:1".