PrtSearch

obj -> PrtSearch(alpha1) : handle

Suchen eines Druck-Objekts über den Namen

Details

• obj: Startobjekt der Suche
• alpha1: Name des zu suchenden Objekts
• Resultat: handle Deskriptor des Objekts
• Siehe: Verwandte Befehle , Blog

PrtSearch() liefert den Deskriptor des gesuchten Objekts. In (alpha1) wird der Name des gesuchten Objekts übergeben. Im Namen können die Wildcard-Operatoren '*' und '?' angegeben werden und werden bei der Suche entsprechend berücksichtigt.

Als Startobjekt wird das Objekt (Druck-Job, DruckerListe ...) angegeben bei dem die Suche gestartet werden soll. Es werden das angegebene Objekt und alle untergeordneten Objekte nach dem übergebenen Namen durchsucht.

Je nach Objekt, das gesucht wird, muss ein entsprechendes Start-Objekt übergeben werden. Wird nach einem bestimmten Windows-Drucker gesucht, muss die Druckerliste angegeben werden. Befindet sich das gesuchte Objekt in einem PrintDoc - oder PrintDocRecord -Objekt, kann der Deskriptor des Printjobs angegeben werden. Ist das Objekt in einem PrintForm -Objekt enthalten, muss der Deskriptor auf das PrintForm-Objekt übergeben werden. Ebenso können Objekte als Startobjekte übergeben werden, die den genannten Objekten untergeordnet sind.

Als Resultat wird der Deskriptor des gefundenen Objekts zurückgegeben. Wurde kein Objekt gefunden ist das Resultat 0.

Beispiele:

// Suchen eines Druckers in einer Druckerliste
tPrinterList # _App->ppPrinterList;
tPrinter # tPrinterList->PrtSearch('HP*');
if (tPrinter > 0)
  WinDialogBox(0, 'Drucker', tPrinter->ppName, _WinIcoInformation, _WinDialogOK, 0);

// Suchen eines Objekts in einem Druck-Job
tJob # PrtJobOpen('Tabelle', 'Print.job', _PrtJobOpenWrite, _PrtTypePrintDocRecord);
if (tJob > 0)
{
  tObject # PrtSearch(tJob, 'txADR.aFirmenbez');
  ...
}

// Suchen eines Objekts in einem Textbaustein
tJob # PrtJobOpen(_PrtDocDinA4, 'Print.job', _PrtJobOpenWrite);
if (tJob > 0)
{
  tForm # PrtFormOpen(_PrtTypePrintForm, 'Liste.Adresse');
  tObject # PrtSearch(tForm, 'txADR.aFirmenbez');
  ...
}