SignatureLine.Sign-Methode
Zeigt das Dialogfeld Signieren mit dem angegebenen Signaturbild oder -stempel sowie den Namen, den Titel und die E-Mail-Adresse des vorgeschlagenen Signierers an.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Function Sign ( _
imageUrl As String, _
suggestedSigner As String, _
suggestedSignerTitle As String, _
suggestedSignerEmail As String _
) As Boolean
'Usage
Dim instance As SignatureLine
Dim imageUrl As String
Dim suggestedSigner As String
Dim suggestedSignerTitle As String
Dim suggestedSignerEmail As String
Dim returnValue As Boolean
returnValue = instance.Sign(imageUrl, _
suggestedSigner, suggestedSignerTitle, _
suggestedSignerEmail)
public abstract bool Sign(
string imageUrl,
string suggestedSigner,
string suggestedSignerTitle,
string suggestedSignerEmail
)
Parameter
imageUrl
Typ: System.StringDer Pfad zum Signatur- oder Stempelbild, der im Steuerelement angezeigt werden soll.
suggestedSigner
Typ: System.StringDer Name des vorgeschlagenen Signierers.
suggestedSignerTitle
Typ: System.StringDer Titel des vorgeschlagenen Signierers.
suggestedSignerEmail
Typ: System.StringDie E-Mail-Adresse des vorgeschlagenen Signierers.
Rückgabewert
Typ: System.Boolean
true, wenn der Signiervorgang erfolgreich ist; andernfalls false.
Hinweise
Die Werte für alle Parameter der Sign(String, String, String, String)-Methode sind optional. Wenn Sie einen Parameter weglassen möchten, übergeben Sie ein Nullverweis (Nothing in Visual Basic) für diesen Parameter. Sie können auch String.Empty für die Parameter suggestedSigner, suggestedSignerTitle und suggestedSignerEmail übergeben. Wenn Sie ein Nullverweis (Nothing in Visual Basic) oder String.Empty für einen Parameter übergeben und der Wert der entsprechenden Eigenschaft zuvor zur Entwurfszeit programmgesteuert oder im Signaturzeile-Steuerelement festgelegt wurde, wird dieser Wert beim Signieren des Formulars oder der Datengruppe verwendet.
Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Codebeispiel wird auf das erste Signaturzeile-Steuerelement in der aktuellen Ansicht zugegriffen. Dann wird die Sign(String, String, String, String)-Methode aufgerufen, um das Dialogfeld Signieren anzuzeigen, in dem das gesamte Formular oder die gesamte Datengruppe, das bzw. die dem Steuerelement zugeordnet ist, signiert wird. Nach dem Signieren des Steuerelements wird ein Meldungsfeld angezeigt, in dem der Wert der SignatureAppearanceType-Eigenschaft für das Steuerelement angezeigt wird.
SignatureLine mySignatureLine =
this.CurrentView.SignatureLines[0];
mySignatureLine.Sign(@"C:\Users\Larry\Pictures\MySignature.jpg",
"Larry Zhang", "Sales Associate", "larry@contoso.com");
MessageBox.Show(mySignatureLine.SignatureAppearanceType.ToString());
Dim mySignatureLine As SignatureLine = _
Me.CurrentView.SignatureLines(0)
mySignatureLine.Sign("C:\Users\Larry\Pictures\MySignature.jpg", _
"Larry Zhang", "Sales Associate", "larry@contoso.com")
MessageBox.Show(mySignatureLine.SignatureAppearanceType.ToString())