AppTaskContent.SetTextInput(String, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Richtet ein Texteingabefeld für den Benutzer ein, um eine Freiformtextantwort bereitzustellen.
public:
virtual void SetTextInput(Platform::String ^ placeholderText, Platform::String ^ actionUriTemplate) = SetTextInput;/// [Windows.Foundation.Metadata.Experimental]
void SetTextInput(winrt::hstring const& placeholderText, winrt::hstring const& actionUriTemplate);[Windows.Foundation.Metadata.Experimental]
public void SetTextInput(string placeholderText, string actionUriTemplate);function setTextInput(placeholderText, actionUriTemplate)Public Sub SetTextInput (placeholderText As String, actionUriTemplate As String)Parameter
- placeholderText
-
String
Platform::String
winrt::hstring
Der Platzhaltertext, der im Eingabefeld angezeigt wird, um den Benutzer zu leiten.
- actionUriTemplate
-
String
Platform::String
winrt::hstring
Eine URI-Vorlagenzeichenfolge, {userTextInput} die beim Senden durch den Escapetext des Benutzers ersetzt wird.
- Attribute
Hinweise
Von Bedeutung
Die App-Aufgabenunterstützung wird ab Mai 2026 schrittweise für Windows 11 eingeführt. Die von Windows.UI.Shell.Tasks APIs aktivierten Erfahrungen erfordern, dass das entsprechende App-Aufgabenfeature in der Windows-Version vorhanden ist, in der die App ausgeführt wird. Andernfalls haben diese APIs keine Auswirkung.
Verwenden Sie diese Methode, um Texteingaben vom Benutzer zu sammeln, wenn die Aufgabe Aufmerksamkeit benötigt. Der {userTextInput} Ausdruck in der URI-Vorlage wird durch die URL-codierte Benutzereingabe ersetzt. Wenn die Vorlage beispielsweise lautet my-app:task/?response={userTextInput} und der Benutzer "nur Bereich" eingibt, lautet my-app:task/?response=scope%20onlyder resultierende URI .