cdkItem

von Centura Team Developer, Gupta bzw. SQLWindows mit Visual Toolchest

Jedes Objekt in Centrua wird durch einen Eintrag dargestellt. Dieses Ojekt stellt jeden Typ von Einträgen der Outline dar.

Base Class

ErrorBase

Member Functions

bOk = AddObjectTo ( nParentId,
nObjectType, sName, aItem )		 Fügt ein Kind-Objet zur Eltern-Outline-Bereich hinzu.
 
Number:nParentId Typ-ID-Konstante des           Eltern-Objektes.
Number:nObjectTypeTyp-ID-Konstante des neuen Kind-Objektes.
String:sName Name des neuen Objektes.
Receives cdkItem:sName Das neue Objekt bei Erfolg.
bOk = AppendItem ( aParent,
nItemType, aNewItem )		 Fügt einen Eintrag vom Typ nItemType zum Eltern-Objekt aParent ein.
 
cdkItem:aParent Das Elten-Objekt für den neuen Eintrag.
Number:nItemTypeTyp des neuen Eintrages.
cdkItem:aNewItem Das initalisierte Objekt, das neu eingefügt wurde.
sYesNo = BoolToYesNo ( bValue ) Liefert lediglich den String "Yes" oder "No".
    "Yes" = BoolToYesNo ( TRUE )
    "No"   = BoolToYesNo ( FALSE )
sYesNo = BoolToYN ( bValue ) Liefert lediglich die Zeichen "Y" oder "N".
    "Y" = BoolToYN ( TRUE )
    "N" = BoolToYN ( FALSE )
bOk = Child () Setzt den aktuellen Zeiger auf das erste Kind-Objekt zum aktuellen Zeiger, soweit vorhanden.
Ist Keins vorhanden bleibt der Zeiger unverändert.
bOk = CloseFrameWork ()Schließt das CDK-Framwork.
bOk = Delete () Löscht den aktuellen Eintrag in der Outline.
bOk = DeleteChildObjectByName
( nSection, sName )		 Ermittelt den Kind-Objekt-Eintrag mittelt sName und löscht ihn.
Ermittelt wird in Komponenten oder Konstanten.
 
Number:nSectionBereichs-Konstanten-ID in der gesucht werden soll.
String:sName Text (=Name) nach dem gesucht werden soll.
bOk = DeleteChildObjectByText
( nSection, sName )		 Ermittelt den Kind-Objekt-Eintrag mittelts sName und löscht ihn.
sName ist der komplette Eintragstext einschließlich Einrückungs-Zeilen.
 
Number:nSectionBereichs-Konstanten-ID in der gesucht werden soll.
String:sName Text (=Name) nach dem gesucht werden soll.
  DisplayModalWindow ()Zeigt den Modal-Dialog, der den "QuickObject editor command-line" parametern entspricht.
nAnzahl =
sonst -1 =		EnumChildObjects
( nSection, ItemArray[*] )		 Gibt alle Kind-Objekte innerhalb des nSection-Bereiches wieder.
 
Number:nSection Konstante, die das Elternobjekt für die Auflistung bestimmt.
cdkItem:ItemArray[*]Feld mit den Kindobjekten vom nSection-Bereich.
nAnzahl =
sonst -1 =		EnumChildObjectsByName
( nSection, sNames[*] )		 Kopiert die Namen der Kind-Einträge von nSection ins Feld sNames.
Der Name beinhaltet alle Unterkomponenten oder Werte.
 
Number:nSection Konstante, die Elternobjekt für die Auflistung bestimmt.
Receive String:sNames[*]Namen der Kinder von nSection.
nAnzahl =
sonst -1 =		EnumChildObjectsByText
( nSection, sText[*] )		 Kopiert die Texte der Kind-Einträge von nSection ins Feld sText.
Der Text beinhaltet alle Unterkomponenten oder Werte.
 
Number:nSectionKonstante, die Elternobjekt für die Auflistung bestimmt.
Receive String:sText[*]Text der Kinder von nSection.
nAnzahl =
sonst -1 =		EnumChildObjectsByTypeToList
( nSection, nType, hWndList )		 Zählt die Kind-Objekte des Typs nType in der Fensterliste hWndList.
 
Number:nSectionKonstante, die Elternobjekt für die Auflistung bestimmt.
Number:nType Genauer Typ des Kind-Objektes, das gezählt werden soll (siehe CDK_IT_*).
Window Handle:hWndListFenster mit Kind-Objekten.
nAnzahl =
sonst -1 =		EnumStrProperties ( sValues[*] ) Listet alle Einstellungen/Eigenschaften eines Objektes.
 
Receive String:sValues[*]String zur Wiederherstellung der Werte.
bOk =Find ( aItem, sFind, bSearchAll ) Sucht den Text sFind und gibt das cdkItem in aItem zurück, dessen Zeile den gesuchten Text enthält. Dies ist eine zeitaufwendige Suche, aber es können die Jokerzeichen wie bei SalStrScan verwendet werden. Die Suche kann durch setzen von cvbCancel = TRUE jederzeit abgebrochen werden, wenn dies durch SalYieldStartMessages ermöglicht wurde.
 
cdkItem:aItem Eintrag mit dem gesuchten Text. Wurde dieser Eintrag validiert, so wird die Suche im nächsten Eintrag fortgesetzt.
String:sFind zu findender Text
Boolean:bSearchAllBei TRUE wird die gesamte Outline, nach dem aktuellen Item, für die Suche verwendet.
bOk =FindArray ( aItem, sFinds[*],
bSearchAll )		 Genauso wie Find, wobei aber in sFinds[*] mehrere Suchbegriffe eingegeben werden können.
 
cdkItem:aItem Eintrag mit dem gesuchten Text. Wurde dieser Eintrag validiert, so wird die Suche im nächsten Eintrag fortgesetzt.
String:sFind zu findender Text
Boolean:bSearchAllBei TRUE wird die gesamte Outline, nach dem aktuellen Item, für die Suche verwendet.
bOk =GetAttribute ( nAttribute, sValue ) Ermittelt das Item-Attribut.
 
Number:nAttributeKonstante des Attributes.
Receive String:sValue Wert des Attributes.
sStr =GetAttributeX ( nAttribute ) Wert des Attributes.
 
Number:nAttributeKonstante des Attributes.
bOk =GetChildObjectByName
( nSection, sName, aObject )		 Ermittelt Kind-Objekt mittels sName.
sName schließt inline-Kommentare oder Wert-Zuweisungen aus.
 
Number:nSectionDer Eltern-Bereich für die Suche.
String:sName Der Eintrags-Name wonach gesucht werden soll.
cdkItem:aObject Das gefundene Objekt.
bOk =GetChildObjectByText
( nSection, sText, aObject )		 Ermittelt Kind-Objekt mittels sText.
sText schließt inline-Kommentare oder Wert-Zuweisungen ein.
 

Number:nSectionDer Eltern-Bereich für die Suche.
String:sText Der Eintrags-Text wonach gesucht werden soll.
cdkItem:aObject Das gefundene Objekt.
bOk =GetChildOfType ( numType,
cChildOfType, bSearchMultiple )		 Ermittelt Kind-Fenster vom angegebenen Typ.
 
Number:numType Typ des Kind-Fensters, das gesucht werden soll.
cdkItem:cChildOfType Das gefundene Objekt.
Boolean:bSearchMultipleBestimmt ob Mehrfach-Objekte gesucht werden.
bOk =GetChildTypeByName
( sAttribute, nValue )		 Ermittelt den Typ CDK_IT_* des Kindes vom aktuellen Item.
Zum Beispiel bei einer Funktion zum Betrachten des Variablen-Bereiches.
 
String:sAttributeDas Attribut, das betrachtet werden soll.
Receive Number:nValue Wert des Attributes
nNum =
CDK_IT_* =
(Typ einer
Klasse)		GetClassTypeOfItem ( nType ) Ermittelt den Klassentyp eines Items.
Zum Beispiel ein CDK_IT_FormWindow hat den Klassentyp CDK_IT_ClassFormWindow.
 
Number:nTypeTyp von dem die Klassenart gewünscht wird.
sStr =
Name der
Standard-
klasse
dieses Typs		GetDefClassNameOfType ( nType ) Jeder Objekttyp hat eine Standardklasse, wenn es im Entwurfsfenster verwendet wird.
Diese Funktion ermittelt die Standardklasse des Items.
 
Number:nTypeCDK_IT_* für den die Standardklasse ermittelt werden soll.
bOk =GetFirstChild ( cChild ) Ermittelt das erste Kind des Objektes.
 
cdkItem:cChildDas erste Objekt.
sStr =
SQLWindows
gerechter
String		GetIdentifier ( sName ) Bildet Centura Builder gerechten String. Inkorrekte Zeichen werden in Unterstriche umgeformt und Leerzeichen werden minimiert.
 
String:sNameText zur Umformung.
nNum =
Item-Händle
des
zugehörigen
Items		GetItem ()  
nNum =
CDK_IT_*
des Objektes		GetItemType ()  
nAnzahl =
sonst -1 =		GetItemValueArray
( nITType, sValues[*] )		 Einige CDK_IT_* haben bestimmte Wertlisten.
Diese Funktion füllt die Werteliste mit den zulässigen Werten zum Item-Typ.
 
Number:nITType CDK_IT_* für den die Werteliste erstellt werden soll.
String:sValues[*]Liste der zulässigen Werte.
nAnzahl =
sonst -1 =		GetItemValuesToList
( nITType, hWndList )		 Einige CDK_IT_* haben bestimmte Wertlisten.
Diese Funktion füllt die Werteliste mit den zulässigen Werten zum Item-Typ.
 
Number:nITType CDK_IT_* für den die Werteliste erstellt werden soll.
Window Handle:hWndListDie Liste oder Combo-Box, die mit den Werten gefüllt werden soll.
bOk =GetNextSibling ( cNextSibling ) Die nächste Einrückung vom aktuellen Objekt. Gegenstück zu GetPrevSibling.
 
cdkItem:cNextSiblingItem der nächsten Einrückung.
sStr =
Name des
Klassen-
objektes		GetObjectClass ()  
nNum =
Outline-
Händle des
zugehörigen
Items		GetOutline ()  
bOk =GetParent ( cParent ) Ermittelt den Elternteil des aktuellen Objektes.
 
cdkItem:cParentInitalisiert mit nächster Einrückung des Elternteiles
bOk =GetPrevSibling ( cPrevSibling ) Die vorherige Einrückung vom aktuellen Objekt. Gegenstück zu GetNextSibling.
 
cdkItem:cPrevSiblingItem der vorherigen Einrückung.
bOk =GetSiblingByName ( sName, aObject ) Ermittelt eine Einrückung des aktuellen Objektes mittels dessen Namen.
 
String:sName Item-Name der gesucht werden soll.
cdkItem:aObjectDas ermittelte Item.
sStr =
Typname		GetStringFromValue ( nType ) Diese Funktion liefert den Namen zum gegebenen CDK_IT_* Typ.
 
Number:nTypeTyp von dem der String gewünscht wird.


Zum Beispiel:
GetStringFromValue (CDK_IT_FormWindow) = "Form Window"
bOk =GetStrProperty ( sPropName, sValue ) Ermittelt Wert vom Proberty-String.
 
String:sPropNameDer Property-Name.
Receive String:sValue Wert des Propertys.

sName =GetName ()  
The object name is the first identifier that occurs after a title.
It excludes any inline comments or assignment.

Zum Beispiel:
Form Window: MeinForm  ! Dies ist mein FormWindow (GetName = 'MeinForm')
User Constants
    String: STEST = "Test" ! Ein Kommentar (GetName = 'STEST')
sText =GetText () This function returns the application object's text.
The object name is the first identifier that occurs after a title.
It includes any inline comments or assignment.

Zum Beispiel:
Form Window: MeinForm  ! Dies ist mein FormWindow (GetText = ' MeinForm  ! Dies ist mein FormWindow ')
User Constants
    String: STEST = "Test" ! Ein Kommentar (GetText = ' STEST = "Test" ! Ein Kommentar ')
sTitel =GetTitle () This function returns the application object's title.
The object title is the a string based on the CDK_IT_* type.

Zum Beispiel:
Form Window: MeinForm  ! Dies ist mein FormWindow (GetTitle = 'Form Window')
User Constants
    String: STEST = "Test" ! Ein Kommentar (GetTitle = 'String')

nNum =HexToNumber ( sHex ) Konvertiert einen String in hexadezimaler Schreibweise in eine Number.
 
String:sHexDer hexadezimale String, der konvertiert werden soll.

Zum Beispiel:
Set nNum = HexToNumber( "0x0FAC" )
sStr =NumberToHex ( nDec ) Liefert die Dezimalzahl als String in hexadezimaler Schreibweise.
 
Number:nDecZahl, die in den hexadezimlen String konvertiert werden soll.

Zum Beispiel:
Set sHex = NumberToHex( 334 )

bOk =GetTopItem ( aItem ) Ermittel erste Item in der Applikation.
 
cdkItem:aItemDer CDK_IT_* dessen erstes Vorkommen in der Applikation initalisiert werden soll.
bOk =Initialize ( hOutline, hItem ) This function initializes an object validating the type of object with the type of class. For example, initializing an hItem that represents a window variable, with a cdkContainer class, would fail because the window variable is not a container.
 
Number:hOutlineDas Outline-Handle.
Number:hItem Das Item-Handle.
 InitializeFramework () This function initializes the application and item objects.
bOk =InitializeFromObject ( srcObject ) This function initializes an object to point to the same application location as the parameter source object.
 
cdkItem:srcObjectThe source object to be used in initialization.
bOk =InsertFirstItem ( aParent, nItemType, aNewItem ) This function inserts the first child in a parent section.
 
cdkItem:aParent The parent object for the new item.
Number:nItemTypeThe constant that defines the item type of the new item.
cdkItem:aNewItem The object to be initialized to point to the newly inserted item.
bOk =InsertItemAfter ( aParent, nItemType, aPrevItem, aNewItem ) This function inserts a new item immediately after aPrevItem on the same indent level.
 
cdkItem:aParent The parent object for the new item.
Number:nItemTypeThe constant that defines the item type of the new item.
cdkItem:aPrevItemThe object to be initialized to point to the item inserted after.
cdkItem:aNewItem The object to be initialized to point to the newly inserted item.
bOk =IsComment () Erfolg, wenn Item eine Kommentar ist.
bOk =IsModified () Erfolg, wenn Outline im Framwork modifiziert wurde.
bOk =IsObjectValid () Erfolg, wenn Objekt korrekt ist.
bOk =IsReadOnly () Erfolg, wenn Item ein Include-Item ist.
bOk =IsTopLevelWindow ()Erfolg, wenn Item ein TopLevelWindow ist.
bOk =IsValidType () This function tests to see that the type of object being represented by this class is valid for the class.
bOk =LockDrawTool ( bLocked ) If locked, this causes Centura Builder to preserve the selected outline tool after dropping a control instead of reverting to the selector tool.
 
Boolean:bLockedThe new value of the locked setting.
bOk =Next () Setzt aktuellen Zeiger auf nächste Einrückung.
  NotifyPropertyChange () Markiert das Property des Items, so daß es nicht von der Eltern-Klasse überschrieben werden kann.
bOk =Parent () Setzt aktuellen Zeiger auf Elternteil des aktuellen Zeigers.
bOk =Prev () Setzt aktuellen Zeiger auf die vorherige Einrückung. Gibt es keine 'Vorherige', bleibt der Zeiger unverändert.
bOk =RemoveStrProperty ( sPropName ) Entfernt ein Property vom Item.
 
String:sPropNameName des Property's.
bOk =SetAppModified () Markiert Applikation als modifiziert.
bOk =SetAttribute ( nAttribute, sValue ) Setzt Applikations-Item-Attribut.
 
Number:nAttributeKonstante des zu setzenden Attributes.
String:sValue Der neue Wert.
bOk =SetModified ( bSet ) Setzt die Klassenvariable, die vermerkt, daß das Framwork die Outline änderte.
 
Boolean:bSetNeue Wert des Modifizierungs-Flags.
bOk =SetName ( sNewText ) Setzt Applikations-Objekt-Name.
This function sets the application object's name.
The object name is the first identifier that occurs after a title.
It excludes any inline comments or assignment.
This function converts identifiers with illegal characters into legal identifiers by inserting underscores.
 
Receive String:sNewTextDer neue Objektname. Wenn inkorrekte Zeichen enthalten sind, wird er automatisch geändert.

Zum Beispiel:
SetName( "Mein Feld" ) setzt den
    Namen "Mein_Feld"
SetName( "Mein #$%@ Feld" ) setzt den
    Namen "Mein______Feld"
SetName( "Mein sehr sehr großes und langes Feld" ) setzt den
    Namen "Mein_sehr_sehr_großes_und_langes" (NUR 32 Zeichen)
bOk =SetObjectClass ( sClassName ) This function sets an application item's class and forces inheritance to occur.
 
String:sClassNameDer neue Klassenname für das Objekt.
bOk =SetStrProperty ( sPropName, sValue ) This function sets the string property of this outline item.
 
String:sPropNameDer Property-Name
String:sValueDer neue Wert des Property's.
bOk =SetText ( sNewText ) This function sets the application object's text.
The object name is the first identifier that occurs after a title.
It includes any inline comments or assignment.
 
String:sNewTextDer neue Text für's Item.

Zum Beispiel:
Form Window: MeinForm  ! Dies ist mein FormWindow (sNewText = 'MeinForm ! Dies ist mein FormWindow')
User Constants
    String: STEST = "Test" ! Ein Kommentar (sNewText = 'STEST = "Test" ! Ein Kommentar')
  Status ( sMsg ) This function displays text in the status window stored in cvhWndStatus.
 
String:sMsgDer Text, der in der Statuszeile angezeigt werden soll.
bBool =StrToBool ( sValue ) Gegenstück zu BoolToYesNo und BoolToYN.
This function returns TRUE or FALSE depending upon the value of the parameter sValue. 'TRUE', 'YES' and 'Y' are all considered TRUE otherwise the result will be FALSE. The comparison is not case sensitive.
 
String:sValueString der zu einem Boolean-Wert konvertiert werden soll.
"TRUE", "YES" oder "Y" werden zu bBool = TRUE, ansonsten ist bBool = FALSE
nAnzahl =
sonst -1 =		ValidChildrenToList ( nSection, hWndList )
 
Number:nSectionThe CDK_IT_* type of the section for which to retrieve the valid child types.
Window Handle:hWndListThe list of combo box to be populated with the titles of valid child types of nSection.

 

Der Autor distanziert sich ausdrücklich vom Inhalt aller externen Links und Verweise.
Er übernimmt keine Gewähr oder Haftung für
Vollständigkeit, Richtigkeit, Aktualität oder etwaige Schäden.
 

Navigation:   bei-ekke / Centura / cdkItem